X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=html%2Fserver-control.html.in;h=5ded4849b263f99b45c70fe65b2a87f5c129ff06;hb=refs%2Fheads%2Fdon%2Ffix_encoding;hp=bbdcd2a748d7b9cdc9b12cca738fa047abee049b;hpb=a640a40347c09403b7b5d9b99b2a56e56e0cf949;p=debbugs.git diff --git a/html/server-control.html.in b/html/server-control.html.in index bbdcd2a..5ded484 100644 --- a/html/server-control.html.in +++ b/html/server-control.html.in @@ -4,6 +4,7 @@ $gControlHtml = < $gProject $gBug system - control mail server commands + @@ -37,6 +38,7 @@ mailservers is available via the WWW, in
reassign bugnumber package + [ version ]
Records that $gBug #${gBug}number is a $gBug in package. This can be used to set the package if the user forgot the @@ -44,6 +46,9 @@ mailservers is available via the WWW, in are sent to anyone (other than the usual information in the processing transcript). +

If you supply a version, the $gBug tracking system will note + that the $gBug affects that version of the newly-assigned package. +

reopen bugnumber [ originator-address | = | ! ] @@ -68,6 +73,45 @@ mailservers is available via the WWW, in use the submitter command; note that this will inform the original submitter of the change. +

If the $gBug was recorded as being closed in a particular version of a + package but recurred in a later version, it is better to use the + found command instead. + +

found bugnumber [ version ] + +
Record that #bugnumber has been encountered in the given + version of the package to which it is assigned. + +

The $gBug tracking system uses this information, in conjunction with + fixed versions recorded when closing $gBugs, to display lists of $gBugs + open in various versions of each package. It considers a $gBug to be open + when it has no fixed version, or when it has been found more recently than + it has been fixed. + +

If no version is given, then the list of fixed versions for + the $gBug is cleared. This is identical to the behaviour of + reopen. + +

This command will only cause a bug to be marked as not done if no + version is specified, or if the version being marked found + is equal to the version which was last marked fixed. (If + you are certain that you want the bug marked as not done, + use reopen in conjunction with found.

+ +

This command was introduced in preference to reopen + because it was difficult to add a version to that command's + syntax without suffering ambiguity. + +

notfound bugnumber version + +
Remove the record that #bugnumber was encountered in the + given version of the package to which it is assigned. + +

This differs from closing the $gBug at that version in that the $gBug + is not listed as fixed in that version either; no information about that + version will be known. It is intended for fixing mistakes in the record of + when a $gBug was found. +

submitter bugnumber originator-address | ! @@ -113,7 +157,7 @@ mailservers is available via the WWW, in

For their meanings please consult the general developers' documentation for the $gBug system. -

clone bugnumber [ new IDs ] +
clone bugnumber NewID [ new IDs ... ]
The clone control command allows you to duplicate a $gBug report. It is useful in the case where a single report actually indicates that multiple @@ -165,6 +209,12 @@ mailservers is available via the WWW, in

Merged reports are all expired simultaneously, and only when all of the reports each separately meet the criteria for expiry. +

forcemerge bugnumber bugnumber ... +
Forcibly merges two or more $gBug reports. The first bug is + chosen as the master bug, and its seetings are assigned to the bugs + listed next in the command. See the text above for a description of + what merging means. +
unmerge bugnumber
Disconnects a $gBug report from any other reports with which it may have @@ -219,7 +269,24 @@ mailservers is available via the WWW, in

For their meanings please consult the general developers' documentation for the $gBug system. -

close bugnumber (deprecated) +
block|unblock bugnumber by|with bug [ bug ... ] + +
Use to note that one bug blocks another bug from being fixed. + The first listed bug is the one being blocked, and it is followed + by the bug or bugs that are blocking it. Use unblock + to unblock a bug. + +

Example usage:

+ + 
+        # indicates that 7890 cannot be fixed until 123456 is fixed
+        block 7890 by 123456
+        # indicates that 7890 can be fixed before 123456 after all
+        unblock 7890 by 123456
+
+ +
close bugnumber [ fixed-version ] + (deprecated)
Close $gBug report #bugnumber. @@ -231,6 +298,9 @@ mailservers is available via the WWW, in who reported the $gBug knows why it is being closed. The use of this command is therefore deprecated. +

If you supply a fixed-version, the $gBug tracking system + will note that the $gBug was fixed in that version of the package. +

package [ packagename ... ]
Limits the following commands so that they will only apply to bugs @@ -243,7 +313,7 @@ mailservers is available via the WWW, in 
         package foo
-        reassign 123456 bar
+        reassign 123456 bar 1.0-1
 
         package bar
         retitle 123456 bar: bar sucks
@@ -256,8 +326,8 @@ mailservers is available via the WWW, in
 
owner bugnumber address | !
 
   
Sets address to be the "owner" of #bugnumber.
-  The owner of a $gBug claims responsibility for fixing it and will receive
-  all mail regarding it.  This is useful to share out work in cases where a
+  The owner of a $gBug claims responsibility for fixing it.
+  This is useful to share out work in cases where a
   package has a team of maintainers.
 
   
If you wish to become the owner of the $gBug yourself, you can use the
@@ -268,6 +338,18 @@ mailservers is available via the WWW, in
   
Forgets any idea that the $gBug has an owner other than the usual
   maintainer.  If the $gBug had no owner recorded then this will do nothing.
 
+
archive bugnumber
+
+  
Archives a $gBug that was previously archived if the $gBug
+  fulfills the requirements for archival, ignoring time.
+
+
unarchive bugnumber
+
+  
Unarchives a $gBug that was previously archived. Unarchival
+  should generally be coupled with reopen and found/fixed as
+  approprite. Bugs that have been unarchived can be archived using
+  archive assuming the non-time based archival requirements are met.
+
 
#...
 
   
One-line comment. The # must be at the start of the line.
@@ -277,12 +359,20 @@ mailservers is available via the WWW, in
 
 
quit
 
stop
-
thank...
-
--...
-
-  
Tells the control server to stop processing the message; the remainder
-      of the message can include explanations, signatures or anything else,
-      none of it will be detected by the control server.
+
thank
+
thanks
+
thankyou
+
thank you
+
--
+
+
+
+
+  
On a line by itself, in any case, possibly followed by
+      whitespace, tells the control server to stop processing the
+      message; the remainder of the message can include explanations,
+      signatures or anything else, none of it will be detected by the
+      control server.