[project @ 2005-07-18 02:09:17 by cjwatson]

[debbugs.git] / html / server-control.html.in

diff --git a/html/server-control.html.in b/html/server-control.html.in
index bbdcd2a748d7b9cdc9b12cca738fa047abee049b..2683d8a536133a28ab9657b44081f4a67cdac750 100644 (file)
--- a/html/server-control.html.in
+++ b/html/server-control.html.in
@@ -37,6 +37,7 @@ mailservers is available via the WWW, in
 <dl>
 
 <dt><code>reassign</code> <var>bugnumber</var> <var>package</var>
+ [ <var>version</var> ]
 
   <dd>Records that $gBug #<var>${gBug}number</var> is a $gBug in <var>package</var>.
   This can be used to set the package if the user forgot the
@@ -44,6 +45,9 @@ mailservers is available via the WWW, in
   are sent to anyone (other than the usual information in the processing
   transcript).
 
+  <p>If you supply a <var>version</var>, the $gBug tracking system will note
+  that the $gBug affects that version of the newly-assigned package.
+
 <dt><code>reopen</code> <var>bugnumber</var>
  [ <var>originator-address</var> | <code>=</code> | <code>!</code> ]
 
@@ -68,6 +72,29 @@ mailservers is available via the WWW, in
   use the <code>submitter</code> command; note that this will inform the
   original submitter of the change.
 
+  <p>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
+  <code>found</code> command instead.
+
+<dt><code>found</code> <var>bugnumber</var> [ <var>version</var> ]
+
+  <dd>Record that #<var>bugnumber</var> has been encountered in the given
+  <var>version</var> of the package to which it is assigned.
+
+  <p>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.
+
+  <p>If no <var>version</var> is given, then the list of fixed versions for
+  the $gBug is cleared. This is identical to the behaviour of
+  <code>reopen</code>.
+
+  <p>This command was introduced in preference to <code>reopen</code>
+  because it was difficult to add a <var>version</var> to that command's
+  syntax without suffering ambiguity.
+
 <dt><code>submitter</code> <var>bugnumber</var>
 <var>originator-address</var> | <code>!</code>
 
@@ -219,7 +246,8 @@ mailservers is available via the WWW, in
   <p>For <a href="Developer.html#tags">their meanings</a> please consult the
   general developers' documentation for the $gBug system.
 
-<dt><code>close</code> <var>bugnumber</var> (deprecated)
+<dt><code>close</code> <var>bugnumber</var> [ <var>fixed-version</var> ]
+ (deprecated)
 
   <dd>Close $gBug report #<var>bugnumber</var>.
 
@@ -231,6 +259,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.
 
+  <p>If you supply a <var>fixed-version</var>, the $gBug tracking system
+  will note that the $gBug was fixed in that version of the package.
+
 <dt><code>package</code> [ <var>packagename</var> ... ]
 
   <dd>Limits the following commands so that they will only apply to bugs
@@ -243,7 +274,7 @@ mailservers is available via the WWW, in
 
   <pre>
         package foo
-        reassign 123456 bar
+        reassign 123456 bar 1.0-1
 
         package bar
         retitle 123456 bar: bar sucks