<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 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>
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
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 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.
+ <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
+
+ # 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.
-<dt><code>package</code> <var>packagename</var> ...
+ <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
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.</dd>
+ accidentally use the wrong bug numbers.
<p>Example usage:</p>
<pre>
package foo
- reassign 1 bar
+ reassign 123456 bar 1.0-1
package bar
- retitle 1 bar: bar sucks
- severity 1 normal
+ retitle 123456 bar: bar sucks
+ severity 123456 normal
package
- severity 2 wishlist
+ 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>...
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>
projects / debbugs.git / blobdiff