/[gnats]/gnats/doc/man/pr-edit.man
ViewVC logotype

Diff of /gnats/doc/man/pr-edit.man

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.1 by pdm, Thu Jun 21 21:18:15 2001 UTC revision 1.2 by yngves, Sun Nov 3 23:43:54 2002 UTC
# Line 1  Line 1 
1  .\" Copyright (c) 2000 Free Software Foundation, Inc.  .\" Copyright (c) 2000 Free Software Foundation, Inc.
2  .\" See section COPYING for conditions for redistribution  .\" See section COPYING for conditions for redistribution
3  .TH pr-edit 8 "January 2000" "GNATS @VERSION@" "GNATS Admininstration Utilities"  .TH pr-edit 8 "November 2002" "GNATS @VERSION@" "GNATS Admininstration Utilities"
4  .de BP  .de BP
5  .sp  .sp
6  .ti -.2i  .ti -.2i
# Line 13  pr\-edit \- creates, edits or deletes PR Line 13  pr\-edit \- creates, edits or deletes PR
13  .na  .na
14  .TP  .TP
15  .B pr\-edit  .B pr\-edit
16  [\fB\-\-lock\fR\ \fIusername\fR\ |\ \fB\-l\fR\ \fIusername\fR]  [\ \fB\-\-lock\fR\=\fIusername\fR\ |\ \fB\-l\fR\ \fIusername\fR\ ]
17  [\fB\-\-unlock\fR\ |\ \fB\-u\fR]  [\ \fB\-\-unlock\fR\ |\ \fB\-u\fR\ ]
18  [\fB\-\-lockdb\fR\ |\ \fB\-L\fR]  .br
19  [\fB\-\-unlockdb\fR\ |\ \fB\-U\fR]  [\ \fB\-\-lockdb\fR\ |\ \fB\-L\fR\ ]\ [\ \fB\-\-unlockdb\fR\ |\ \fB\-U\fR\ ]
20  [\fB\-\-check\fR\ |\ \fB\-c\fR]  .br
21  [\fB\-\-check\-initial\fR\ |\ \fB\-C\fR]  [\ \fB\-\-check\fR\ |\ \fB\-c\fR\ ]
22  [\fB\-\-submit\fR\ |\ \fB\-s\fR]  [\ \fB\-\-check\-initial\fR\ |\ \fB\-C\fR\ ]
23  [\fB\-\-append\fR\ \fIfield\fR\ |\ \fB\-a\fR\ \fIfield\fR]  .br
24  [\fB\-\-replace\fR\ \fIfield\fR\ |\ \fB\-r\fR\ \fIfield\fR]  [\ \fB\-\-submit\fR\ |\ \fB\-s\fR\ ]
25  [\fB\-\-delete\-pr\fR]  .br
26  [\fB\-\-process\fR\ \fIprocess\-id\fR\ |\ \fB\-p\fR\ \fIprocess\-id\fR]  [\ \fB\-\-append\fR\=\fIfield\fR\ |\ \fB\-a\fR\ \fIfield\fR\ ]
27  [\fB\-\-database\fR\ \fIdatabase\fR\ |\ \fB\-d\fR\ \fIdatabase\fR]  [\ \fB\-\-replace\fR\=\fIfield\fR\ |\ \fB\-r\fR\ \fIfield\fR\ ]
28  [\fB\-\-filename\fR\ \fIfilename\fR\ |\ \fB\-f\fR\ \fIfilename\fR]  .br
29  [\fB\-\-version\fR\ |\ \fB\-V\fR]  [\ \fB\-\-reason\fR\=\fIreason\fR\ |\ \fB\-R\fR\ \fIreason\fR\ ]
30  [\fB\-\-help\fR\ |\ \fB\-h\fR]  .br
31  [\fB\-\-user\fR\ \fInetid\fR\ |\ \fB\-v\fR\ \fInetid\fR]  [\ \fB\-\-delete\-pr\fR\ ]
32  [\fB\-\-passwd\fR\ \fIpassword\fR\ |\ \fB\-w\fR\ \fIpassword\fR]  .br
33  [\fB\-\-host\fR\ \fIhost\fR\ |\ \fB\-H\fR\ \fIhost\fR]  [\ \fB\-\-process\fR\=\fIprocess\-id\fR\ |\ \fB\-p\fR\ \fIprocess\-id\fR\ ]
34  [\fB\-\-port\fR\ \fIport\fR\ |\ \fB\-P\fR\ \fIport\fR]  .br
35  [\fB\-\-debug\fR\ |\ \fB\-D\fR]  [\ \fB\-\-database\fR\=\fIdatabase\fR\ |\ \fB\-d\fR\ \fIdatabase\fR\ ]
36  [\fBPR number\fR]  .br
37    [\ \fB\-\-filename\fR\=\fIfilename\fR\ |\ \fB\-f\fR\ \fIfilename\fR\ ]
38    .br
39    [\ \fB\-\-version\fR\ |\ \fB\-V\fR\ ]
40    [\ \fB\-\-help\fR\ |\ \fB\-h\fR\ ]
41    .br
42    [\ \fB\-\-user\fR\=\fIusername\fR\ |\ \fB\-v\fR\ \fIusername\fR\ ]
43    .br
44    [\ \fB\-\-passwd\fR\=\fIpassword\fR\ |\ \fB\-w\fR\ \fIpassword\fR\ ]
45    .br
46    [\ \fB\-\-host\fR\=\fIhost\fR\ |\ \fB\-H\fR\ \fIhost\fR\ ]
47    .br
48    [\ \fB\-\-port\fR\=\fIport\fR\ |\ \fB\-P\fR\ \fIport\fR\ ]
49    .br
50    [\ \fB\-\-debug\fR\ |\ \fB\-D\fR\ ]
51    .br
52    [\ \fIPR\fR\ ]
53  .ad b  .ad b
54  .hy 1  .hy 1
55  .SH DESCRIPTION  .SH DESCRIPTION
56  \fBpr\-edit\fR can be used to exit an existing \fIPR\fR by either  \fBpr\-edit\fR can be used to edit an existing \fIPR\fR by either
57  replacing or appending to particular fields within the \fIPR\fR, or  replacing or appending to particular fields within the \fIPR\fR, or
58  providing a new \fIPR\fR to replace the existing one. \fBpr\-edit\fR  providing a new \fIPR\fR to replace the existing one. \fBpr\-edit\fR
59  can also be used to create new \fIPR\fRs from scratch, or delete  can also be used to create new \fIPR\fRs from scratch, or delete
# Line 96  Deletes the specified \fIPR\fR from the Line 112  Deletes the specified \fIPR\fR from the
112  in a closed state, and not locked.  in a closed state, and not locked.
113  .LP  .LP
114  .RS 0.5i  .RS 0.5i
115  Only the user \fB@GNATS_USER@\fR is permitted to delete \fIPR\fRs.  Only the GNATS user (by default \fBgnats\fR) is permitted to delete \fIPR\fRs.
116  .RE  .RE
117  .TP 0.5i  .TP 0.5i
118  \fB\-\-lock\fR\ \fIusername\fR,\ \fB\-l\fR\ \fIusername\fR  \fB\-\-lock\fR\=\fIusername\fR,\ \fB\-l\fR\ \fIusername\fR
119  Locks the \fIPR\fR.  \fIusername\fR is associated with the lock, so  Locks the \fIPR\fR.  \fIusername\fR is associated with the lock, so
120  the system administrator can determine who actually placed the lock on  the system administrator can determine who actually placed the lock on
121  the \fIPR\fR.  However, anyone is permitted to remove locks on a  the \fIPR\fR.  However, anyone is permitted to remove locks on a
# Line 113  If the optional \fB\-\-process\-id\fR op Line 129  If the optional \fB\-\-process\-id\fR op
129  \fB\-\-unlock\fR,\ \fB\-u\fR  \fB\-\-unlock\fR,\ \fB\-u\fR
130  Unlocks the \fIPR\fR.  Unlocks the \fIPR\fR.
131  .TP  .TP
132  \fB\-\-append\fR\ \fIfield\fR,\ \fB\-a\fR\ \fIfield\fR  \fB\-\-append\fR\=\fIfield\fR,\ \fB\-a\fR\ \fIfield\fR
133  .TP  .TP
134  \fB\-\-replace\fR\ \fIfield\fR,\ \fB\-r\fR\ \fIfield\fR  \fB\-\-replace\fR\=\fIfield\fR,\ \fB\-r\fR\ \fIfield\fR
135  \fB\-\-append\fR and \fB\-\-replace\fR are used to append or replace  \fB\-\-append\fR and \fB\-\-replace\fR are used to append or replace
136  content of a specific field within a \fIPR\fR.  The new field content  content of a specific field within a \fIPR\fR.  The new field content
137  is read in from stdin (or from the file specified with the  is read in from stdin (or from the file specified with the
# Line 129  failed, a non-zero exit status is return Line 145  failed, a non-zero exit status is return
145  are printed to stdout.  are printed to stdout.
146  .RE  .RE
147  .TP 0.5i  .TP 0.5i
148  \fB[PR number]\fR  \fB\fB\-\-reason\fR\=\fIreason\fR,\ \fB\-R\fR\ \fIreason\fR
149  If only a \fIPR number\fR is specified with no other options, a  Certain PR fields are configured in the database configuration to
150    require a short text describing the reason for every change that is
151    made to them.  If you edit a PR and change any such fields, you must
152    provide a short text, the \fIreason\fR for the change, through this
153    option.  If the option is used and no change-reason requiring field is
154    actually changed, the option has no effect.
155    .RE
156    .TP 0.5i
157    \fI[PR]\fR
158    If only a \fIPR\fR number is specified with no other options, a
159  replacement \fIPR\fR is read in (either from stdin or the file  replacement \fIPR\fR is read in (either from stdin or the file
160  specified with \fB\-\-filename\fR).  If the \fIPR\fR contents are  specified with \fB\-\-filename\fR).  If the \fIPR\fR contents are
161  valid and correct, the existing \fIPR\fR is replaced with the new  valid and correct, the existing \fIPR\fR is replaced with the new
# Line 142  failed, a non-zero exit status is return Line 167  failed, a non-zero exit status is return
167  are printed to stdout.  are printed to stdout.
168  .RE  .RE
169  .TP 0.5i  .TP 0.5i
170  \fB\-\-database\fR\ \fIdatabase\fR,\ \fB\-d\fR\ \fIdatabase\fR  \fB\-\-database\fR\=\fIdatabase\fR,\ \fB\-d\fR\ \fIdatabase\fR
171  Specifies the database which is to be manipulated.  If no database is  Specifies the database which is to be manipulated.  If no database is
172  specified, the database named \fIdefault\fR is assumed.  This option  specified, the database named \fIdefault\fR is assumed.  This option
173  overrides the database specified in the \fBGNATSDB\fR environment  overrides the database specified in the \fBGNATSDB\fR environment
174  variable.  variable.
175  .TP 0.5i  .TP 0.5i
176  \fB\-\-filename\fR\ \fIfilename\fR,\ \fB\-f\fR\ \fIfilename\fR  \fB\-\-filename\fR\=\fIfilename\fR,\ \fB\-f\fR\ \fIfilename\fR
177  For actions that require reading in a \fIPR\fR or field content, this  For actions that require reading in a \fIPR\fR or field content, this
178  specifies the name of a file to read.  If \fB\-\-filename\fR is not  specifies the name of a file to read.  If \fB\-\-filename\fR is not
179  specified, the \fIPR\fR or field content is read in from stdin.  specified, the \fIPR\fR or field content is read in from stdin.
# Line 159  Displays the version number of the progr Line 184  Displays the version number of the progr
184  \fB\-\-help\fR,\ \fB\-h\fR  \fB\-\-help\fR,\ \fB\-h\fR
185  Prints a brief usage message.  Prints a brief usage message.
186  .TP 0.5i  .TP 0.5i
187  \fB\-\-host\fR\ \fIhost\fR,\ \fB\-H\fR\ \fIhost\fR  \fB\-\-host\fR\=\fIhost\fR,\ \fB\-H\fR\ \fIhost\fR
188  Hostname of the GNATS server.  Hostname of the GNATS server.
189  .TP 0.5i  .TP 0.5i
190  \fB\-\-port\fR\ \fIport\fR,\ \fB\-P\fR\ \fIport\fR  \fB\-\-port\fR\=\fIport\fR,\ \fB\-P\fR\ \fIport\fR
191  The port that the GNATS server runs on.  The port that the GNATS server runs on.
192  .TP 0.5i  .TP 0.5i
193  \fB\-\-user\fR\ \fInetid\fR,\ \fB\-v\fR\ \fInetid\fR  \fB\-\-user\fR\=\fIusername\fR,\ \fB\-v\fR\ \fIusername\fR
194  Username used when logging into the GNATS server.  Username used when logging into the GNATS server.
195  .TP 0.5i  .TP 0.5i
196  \fB\-\-passwd\fR\ \fIpassword\fR,\ \fB\-w\fR\ \fIpassword\fR  \fB\-\-passwd\fR\=\fIpassword\fR,\ \fB\-w\fR\ \fIpassword\fR
197  Password used when logging into the GNATS server.  Password used when logging into the GNATS server.
198  .TP 0.5i  .TP 0.5i
199  \fB\-\-debug\fR,\ \fB\-D\fR  \fB\-\-debug\fR,\ \fB\-D\fR
# Line 192  it is assumed that the database is local Line 217  it is assumed that the database is local
217  .I Keeping Track: Managing Messages With GNATS  .I Keeping Track: Managing Messages With GNATS
218  (also installed as the GNU Info file  (also installed as the GNU Info file
219  .BR gnats.info )  .BR gnats.info )
 and  
 .I Reporting Problems Using send-pr  
 (also installed as the GNU Info file  
 .BR send-pr.info ).  
220  .LP  .LP
221    .BR databases (5),
222    .BR dbconfig (5),
223    .BR delete-pr (8),
224    .BR edit-pr (1)
225    .BR file-pr (8),
226    .BR gen-index (8),
227  .BR gnats (7),  .BR gnats (7),
228  .BR send-pr (1),  .BR gnatsd (8),
229  .BR edit-pr (1),  .BR mkcat (8),
230    .BR mkdb (8),
231    .BR pr-edit (8),
232  .BR query-pr (1),  .BR query-pr (1),
 .BR file-pr (8),  
233  .BR queue-pr (8),  .BR queue-pr (8),
234  .BR rmcat (8),  .BR send-pr (1).
 .BR gen-index (8),  
 .BR mkcat (8).  
235  .SH COPYING  .SH COPYING
236  Copyright (c) 2000 Free Software Foundation, Inc.  Copyright (c) 2000, 2002, Free Software Foundation, Inc.
237  .PP  .PP
238  Permission is granted to make and distribute verbatim copies of  Permission is granted to make and distribute verbatim copies of
239  this manual provided the copyright notice and this permission notice  this manual provided the copyright notice and this permission notice

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.2

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26