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