Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
edit-pr(1)		     GNATS User	Utilities		    edit-pr(1)

       edit-pr - edit a	problem	report in the GNATS database

	      [	-h | --help ] [	-V | --version ]
	      [	-d databasename	| --database=databasename ]
	      [	-H host	| --host=host ]	[ -P port | --port=port	]
	      [	-v user	| --user=user ]	[ -w password |	--passwd=password ]

       edit-pr is used to make changes to existing PRs in a GNATS database.

       edit-pr first examines the PR and locks it if it	is not already locked.
       This is to prevent a PR from being edited by two	users  simultaneously.
       If  the	PR is already in the process of	being edited, edit-pr displays
       the name	of the person who owns the lock.

       edit-pr then calls $EDITOR on PR.  After	the PR has been	edited,	it  is
       resubmitted to the database, and	the index is updated.

       If  you	change	a field	that requires a	reason for the change, edit-pr
       prompts you to supply a reason for the change.  A message is  then  ap-
       pended  to  the Audit-Trail field of PR with the	changed	values and the
       change reason.

       Depending on how	the database is	configured, editing various fields  in
       the PR may also cause mail to be	sent concerning	these changes.	In the
       default configuration, any fields  that	generate  Audit-Trail  entries
       will cause a copy of the	new Audit-Trail	message	to be sent.

       -h, --help
		 Prints	a brief	usage message for edit-pr.

       -V, --version
		 Prints	the version number for edit-pr.

       -d, --database
		 Specifies  the	database containing the	PR to be edited; if no
		 database is specified,	the database named default is assumed.
		 This  option  overrides the database specified	in the GNATSDB
		 environment variable.

   GNATS network options:
       -H, --host
	      Hostname of the GNATS server.

       -P, --port
	      The port that the	GNATS server runs on.

       -v, --username
	      Username used to log into	the GNATS server.

       -w, --passwd
	      Password used to log into	the GNATS server.

       The environment variable	EDITOR specifies the editor to invoke  on  the
       PR.  Default is vi(1).

       The GNATSDB environment variable	is used	to determine which database to
	      use.  For	a local	database, it contains the name of the database
	      to access.

       For network access via gnatsd, it contains a  colon-separated  list  of
       strings that describe the remote	database, in the form


       Any  of	the fields may be omitted, but at least	one colon must appear;
       otherwise, the value is assumed to be the name of a local database.

       If GNATSDB is not set, it is assumed that the  database	is  local  and
       that its	name is	default.

       /tmp/ep$$ Temporary file	for PR being edited.

		 Holds Audit-Trail change message, if needed.

       /tmp/u$$	 Holds output of lock function.

       Keeping	Track: Managing	Messages With GNATS (also installed as the GNU
       Info file

       databases(5), dbconfig(5), delete-pr(8),	edit-pr(1) file-pr(8), gen-in-
       dex(8),	gnats(7),  gnatsd(8),  mkcat(8),  mkdb(8),  pr-edit(8),	query-
       pr(1), queue-pr(8), send-pr(1).

       Copyright (c) 1993, 2003, Free Software Foundation, Inc.

       Permission is granted to	make and distribute verbatim  copies  of  this
       manual  provided	 the  copyright	 notice	and this permission notice are
       preserved on all	copies.

       Permission is granted to	copy and distribute modified versions of  this
       manual under the	conditions for verbatim	copying, provided that the en-
       tire resulting derived work is distributed under	the terms of a permis-
       sion notice identical to	this one.

       Permission is granted to	copy and distribute translations of this manu-
       al into another language, under the above conditions for	modified  ver-
       sions,  except  that this permission notice may be included in transla-
       tions approved by the Free Software Foundation instead of in the	origi-
       nal English.

GNATS				  August 2003			    edit-pr(1)


Want to link to this manual page? Use this URL:

home | help