[project @ 2004-05-11 00:51:01 by cjwatson]

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

diff --git a/html/server-control.html.in b/html/server-control.html.in
index 64a4bb69840a49fd011e992f7f24300afa848b69..f5e96660ab43c02a1a254880854338606ff7babf 100644 (file)
--- a/html/server-control.html.in
+++ b/html/server-control.html.in
@@ -64,10 +64,22 @@ mailservers is available via the WWW, in
   again.
 
   <p>If the $gBug is not closed then reopen won't do anything, not even
-  change the originator.  There is no way to change the originator of an
-  open $gBug report (this is deliberate, so that you can't have a $gBug be
-  closed and then deleted $gRemoveAge days later without someone being told about
-  it).
+  change the originator.  To change the originator of an open $gBug report,
+  use the <code>submitter</code> command; note that this will inform the
+  original submitter of the change.
+
+<dt><code>submitter</code> <var>bugnumber</var>
+<var>originator-address</var> | <code>!</code>
+
+  <dd>Changes the originator of #<var>bugnumber</var> to
+  <var>originator-address</var>.
+
+  <p>If you wish to become the new originator of the report you can use
+  the <code>!</code> shorthand or specify your own email address.</p>
+
+  <p>While the <code>reopen</code> command changes the originator of other
+  bugs merged with the one being reopened, <code>submitter</code> does not
+  affect merged bugs.</p>
 
 <dt><code>forwarded</code> <var>bugnumber</var> <var>address</var>
 
@@ -119,10 +131,10 @@ mailservers is available via the WWW, in
         reassign -2 bar
         retitle -2 bar: bar sucks when used with foo
         severity -2 wishlist
-        clone 123456 -2
-        reassign -2 foo
-        retitle -2 foo: foo sucks
-        merge -1 -2
+        clone 123456 -3
+        reassign -3 foo
+        retitle -3 foo: foo sucks
+        merge -1 -3
   </pre>
 
 <dt><code>merge</code> <var>bugnumber</var> <var>bugnumber</var> ...
@@ -198,6 +210,50 @@ 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.
 
+<dt><code>package</code> [ <var>packagename</var> ... ]
+
+  <dd>Limits the following commands so that they will only apply to bugs
+  filed against the listed packages. You can list one or more packages. If
+  you don't list any packages, the following commands will apply to all
+  bugs. You're encouraged to use this as a safety feature in case you
+  accidentally use the wrong bug numbers.
+
+  <p>Example usage:</p>
+
+  <pre>
+        package foo
+        reassign 123456 bar
+
+        package bar
+        retitle 123456 bar: bar sucks
+        severity 123456 normal
+
+        package
+        severity 234567 wishlist
+  </pre>
+
+<dt><code>owner</code> <var>bugnumber</var> <var>address</var> | <code>!</code>
+
+  <dd>Sets <var>address</var> to be the "owner" of #<var>bugnumber</var>.
+  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
+  package has a team of maintainers.
+
+  <p>If you wish to become the owner of the $gBug yourself, you can use the
+  <code>!</code> shorthand or specify your own email address.</p>
+
+<dt><code>noowner</code> <var>bugnumber</var>
+
+  <dd>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.
+
+<dt><code>#</code>...
+
+  <dd>One-line comment. The <code>#</code> must be at the start of the line.
+  The text of comments will be included in the acknowledgement sent to the
+  sender and to affected maintainers, so you can use this to document the
+  reasons for your commands.
+
 <dt><code>quit</code>
 <dt><code>stop</code>
 <dt><code>thank</code>...
@@ -207,10 +263,6 @@ mailservers is available via the WWW, in
       of the message can include explanations, signatures or anything else,
       none of it will be detected by the control server.
 
-<dt><code>#</code>...
-
-  <dd>One-line comment. The <code>#</code> must be at the start of the line.
-
 </dl>
 
 <hr>