<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
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> ]
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 will only cause a bug to be marked as not done if no
+ version is specified, or if the <var>version</var> being marked found
+ is equal to the <var>version</var> which was last marked fixed. (If
+ you are certain that you want the bug marked as not done,
+ use <code>reopen</code> in conjunction with <code>found</code>.</p>
+
+ <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>notfound</code> <var>bugnumber</var> <var>version</var>
+
+ <dd>Remove the record that #<var>bugnumber</var> was encountered in the
+ given <var>version</var> of the package to which it is assigned.
+
+ <p>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.
+
<dt><code>submitter</code> <var>bugnumber</var>
<var>originator-address</var> | <code>!</code>
<p>For <a href="Developer.html#severities">their meanings</a> please
consult the general developers' documentation for the $gBug system.
-<dt><code>clone</code> <var>bugnumber</var> [ <var>new IDs</var> ]
+<dt><code>clone</code> <var>bugnumber</var> <var>NewID</var> [ <var>new IDs</var> ... ]
<dd>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
package to which the $gBug is assigned), and all of the same severity.
If they don't start out in the same state you should use
<code>reassign</code>, <code>reopen</code> and so forth to make sure
- that they are before using <code>merge</code>.
+ that they are before using <code>merge</code>. Titles are not required
+ to match, and will not be affected by the merge.
<p>If any of the $gBugs listed in a <code>merge</code> command is already
merged with another $gBug then all the reports merged with any of the
<p>Merged reports are all expired simultaneously, and only when all of
the reports each separately meet the criteria for expiry.
+<dt><code>forcemerge</code> <var>bugnumber</var> <var>bugnumber</var> ...
+ <dd>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.
+
<dt><code>unmerge</code> <var>bugnumber</var>
<dd>Disconnects a $gBug report from any other reports with which it may have
command; if you want to disconnect more than one $gBug simply include
several <code>unmerge</code> commands in your message.
-<dt><code>tags</code> <var>bugnumber</var> [ <code>+</code> | <code>-</code> | <code>=</code> ] <var>tag</var>
+<dt><code>tags</code> <var>bugnumber</var> [ <code>+</code> | <code>-</code> | <code>=</code> ] <var>tag</var> [ <var>tag</var> ... ]
+
+ <dd>Sets tags for the $gBug report #<var>bugnumber</var>. No notification
+ is sent to the user who reported the $gBug. Setting the action to
+ <code>+</code> means to add each given <var>tag</var>, <code>-</code>
+ means to remove each given <var>tag</var>, and <code>=</code> means to
+ ignore the current tags and set them afresh to the list provided. The
+ default action is adding.
+
+ <p>Example usage:</p>
+
+ <pre>
+ # same as 'tags 123456 + patch'
+ tags 123456 patch
+
+ # same as 'tags 123456 + help security'
+ tags 123456 help security
- <dd>Sets a particular tag for the $gBug report #<var>bugnumber</var> to
- <var>tag</var>. No notification is sent to the user who reported the $gBug.
- <code>+</code> means adding, <code>-</code> means subtracting, and
- <code>=</code> means ignoring the current tags and setting them afresh.
- The default action is adding.
+ # add 'fixed' and 'pending' tags
+ tags 123456 + fixed pending
+
+ # remove 'unreproducible' tag
+ tags 123456 - unreproducible
+
+ # set tags to exactly 'moreinfo' and 'unreproducible'
+ tags 123456 = moreinfo unreproducible
+ </pre>
<p>Available tags currently include <code>patch</code>, <code>wontfix</code>,
<code>moreinfo</code>, <code>unreproducible</code>, <code>help</code>,
<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>
+<dt><code>block</code>|<code>unblock</code> <var>bugnumber</var> <code>by</code>|<code>with</code> <var>bug</var> [ <var>bug</var> ... ]
+
+ <dd>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 <code>unblock</code>
+ to unblock a bug.
+
+ <p>Example usage:</p>
+
+ <pre>
+ # 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
+ </pre>
+
+<dt><code>close</code> <var>bugnumber</var> [ <var>fixed-version</var> ]
+ (deprecated)
<dd>Close $gBug report #<var>bugnumber</var>.
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
<pre>
package foo
- reassign 123456 bar
+ reassign 123456 bar 1.0-1
package bar
retitle 123456 bar: bar sucks
<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
+ 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.
<p>If you wish to become the owner of the $gBug yourself, you can use the
<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>quit</code>
-<dt><code>stop</code>
-<dt><code>thank</code>...
-<dt><code>--</code>...
+<dt><code>archive</code> <var>bugnumber</var>
+
+ <dd>Archives a $gBug that was previously archived if the $gBug
+ fulfills the requirements for archival, ignoring time.
- <dd>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.
+<dt><code>unarchive</code> <var>bugnumber</var>
+
+ <dd>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.
<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>
+<dt><code>thanks</code>
+<dt><code>thankyou</code>
+<dt><code>thank you</code>
+<dt><code>--</code>
+<!-- #366093, I blame you! -->
+<!-- <dt><code>kthxbye</code> -->
+<!-- See... I documented it! -->
+
+ <dd>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.
</dl>