[project @ 2005-10-06 06:53:42 by ajt]

add some docs for usertags

diff --git a/html/server-refcard.html.in b/html/server-refcard.html.in
index dab14728826dc325c4c843106342492f1b70c1ee..ed83f893337516aed0928d36c0a1508b8f61d295 100644 (file)
--- a/html/server-refcard.html.in
+++ b/html/server-refcard.html.in
@@ -33,6 +33,8 @@ sending the word <code>help</code> to each mailserver.
   <li><code>getinfo</code> <var>filename</var> <em>(see below)</em>
   <li><code>help</code>
   <li><code>refcard</code>
+  <li><code>user</code> <var>email</var> 
+  <li><code>usertag</code> <var>bugnumber</var> [+-=] <var>tag</var> ...
   <li><code>quit</code>|<code>stop</code>|<code>thank</code>...|<code>--</code>...
   <li><code>#</code>... <em>(comment)</em>
   <li><code>debug</code> <var>level</var>

diff --git a/html/server-request.html.in b/html/server-request.html.in
index dcf57b5aaf3597b88ece2c383736746ff3418b70..f7f783656fdb104246914b547d64c8014929ebfe 100644 (file)
--- a/html/server-request.html.in
+++ b/html/server-request.html.in
@@ -103,6 +103,35 @@ server.
 
   <dd>Requests that the mailservers' reference card be sent in plain ASCII.
 
+<dt><code>user</code> <var>email</var>
+
+  <dd>Set the user to the given email address. The default user is the
+  email address set in your mail client's From: or Reply-To: field. You
+  should not use other people's email addresses without permission.
+
+<dt><code>usertag</code> <var>bugnumber</var> [ <code>+</code> | <code>-</code> | <code>=</code> ] <var>tag</var> [ <var>tag</var> ... ]
+
+  <dd>Sets usertags for the $gBug report #<var>bugnumber</var>. No
+  notification is sent to the user who reported the $gBug, nor to
+  the package maintainer. 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'
+        usertag 123456 patch
+  
+        # same as 'tags 123456 + help security'
+        usertag 123456 help security
+  </pre>
+
+  <p>The meaning of usertags is decided by the owner of the email address
+  they are associated with.
+
 <dt><code>help</code>
 
   <dd>Requests that this help document be sent by email in plain ASCII.