Provided by: gnats-user_4.1.0-2_i386 bug

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.