NAME

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

SYNOPSIS

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

DESCRIPTION

       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 appended 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.

OPTIONS

       -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.

ENVIRONMENT VARIABLES

       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

       server:port:databasename:username:password

       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.

FILES

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

       /tmp/ed_pr_ch$$
                 Holds Audit-Trail change message, if needed.

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

SEE ALSO

       Keeping  Track:  Managing  Messages  With  GNATS  (also  installed  as  the  GNU Info file
       gnats.info)

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

COPYING

       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  entire resulting derived work is
       distributed under the terms of a permission notice identical to this one.

       Permission is granted to copy and distribute translations  of  this  manual  into  another
       language,  under  the  above conditions for modified versions, except that this permission
       notice may be included in translations approved by the Free Software Foundation instead of
       in the original English.