r10350 - in /packages/trunk/doc-debian: debian/changelog doc/bug-log-mailserver.wml doc/bug-maint-info.wml doc/bug-maint-mailcontrol.wml doc/bug-reporting.wml doc/social-contract.1.0.wml doc/social-contract.wml
Author: taffit
Date: Sun Dec 29 18:36:31 2013
New Revision: 10350
URL: http://svn.debian.org/wsvn/?sc=1&rev=10350
Log:
Update the contents to the latest available at the website
Modified:
packages/trunk/doc-debian/debian/changelog
packages/trunk/doc-debian/doc/bug-log-mailserver.wml
packages/trunk/doc-debian/doc/bug-maint-info.wml
packages/trunk/doc-debian/doc/bug-maint-mailcontrol.wml
packages/trunk/doc-debian/doc/bug-reporting.wml
packages/trunk/doc-debian/doc/social-contract.1.0.wml
packages/trunk/doc-debian/doc/social-contract.wml
Modified: packages/trunk/doc-debian/debian/changelog
URL: http://svn.debian.org/wsvn/packages/trunk/doc-debian/debian/changelog?rev=10350&op=diff
==============================================================================
--- packages/trunk/doc-debian/debian/changelog (original)
+++ packages/trunk/doc-debian/debian/changelog Sun Dec 29 18:36:31 2013
@@ -2,6 +2,7 @@
* move README.build to debian/README.source
* Add mailing-lists.txt to source (Closes: #713501)
+ * Update the contents to the latest available at the website
-- David Prévot <taffit@debian.org> Sun, 29 Dec 2013 13:02:33 -0400
Modified: packages/trunk/doc-debian/doc/bug-log-mailserver.wml
URL: http://svn.debian.org/wsvn/packages/trunk/doc-debian/doc/bug-log-mailserver.wml?rev=10350&op=diff
==============================================================================
--- packages/trunk/doc-debian/doc/bug-log-mailserver.wml (original)
+++ packages/trunk/doc-debian/doc/bug-log-mailserver.wml Sun Dec 29 18:36:31 2013
@@ -120,6 +120,117 @@
Requests that the mailservers' reference card be sent in plain ASCII.
</dd>
+<dt><a name="user"><code>user</code> <var>address</var></a></dt>
+<dd>
+Sets <var>address</var> to be the <q>user</q> of all <code>usertag</code>
+commands that follow.
+</dd>
+
+<dt><a name="usertag"><code>usertag</code> <var>bugnumber</var>
+ [ <code>+</code> | <code>-</code> | <code>=</code> ] <var>tag</var>
+ [ <var>tag</var> ... ]</a></dt>
+<dd>
+Allows to define tags on a per-user basis. The <code>usertag</code>
+command works just like the regular <code>tag</code> command, except
+that you get to make up whatever tags you like. By default, the address
+in the <code>From:</code> or <code>Reply-To:</code> header of your mail
+will be used to set the user of the <code>usertag</code>.
+</dd>
+
+<dt><a name="usercategory"><code>usercategory</code>
+ <var>category-name</var> [ <code>[hidden]</code> ]</a></dt>
+<dd>
+<p>
+Adds, updates or removes a <code>usercategory</code>. By default the user
+category is visible, if the optional argument <code>[hidden]</code>
+is specified then it will not be visible, but still be available to be
+referenced from other user category definitions.
+</p>
+
+<p>
+This command is somewhat special, as when adding or updating a user
+category it requires a body following immediately after the command. If
+the body is empty the user category will get removed instead. The body
+is composed of lines starting with any number of spaces. Each category
+should start with a line with <code>*</code>, and optionally it can be
+followed by several selection lines starting with <code>+</code>. The
+complete format is as follows:
+</p>
+
+<div>
+* <var>category-name-1</var><br />
+* <var>Category Title 2</var>
+ [ <code>[</code><var>selection-prefix</var><code>]</code> ]<br />
+ + <var>Selection Title 1</var> <code>[</code>
+ [ <var>order</var><code>:</code> ]
+ <var>selection-1</var> <code>]</code><br />
+ + <var>Selection Title 2</var> <code>[</code>
+ [ <var>order</var><code>:</code> ]
+ <var>selection-2</var> <code>]</code><br />
+ + <var>Default Selection Title</var> <code>[</code>
+ [ <var>order</var>: ] <code>]</code><br />
+* <var>category-name-3</var><br />
+</div>
+
+<p>
+The <var>category-names</var> appearing in the command and in the body
+are used to make references between them, to avoid unnecessary inlining.
+The <var>Category Titles</var> are used in the package report summary.
+</p>
+
+<p>
+The optional <var>selection-prefix</var> is prefixed to every
+<var>selection</var> on each entry in the category section. The first
+<var>selection</var> which matches gets the bug shown under it. The
+optional <var>order</var> parameter specifies the position when showing
+the selected entries, this is useful when using a match that selects a
+superset of the previous ones but that needs to be shown before them.
+</p>
+
+<p>
+The <var>category-name</var> <code>normal</code> has the special meaning
+of being the default view, so by replacing it with a different user category
+for the <var>pkgname</var>@packages.debian.org user one can change the
+default classification for a package.
+</p>
+
+<p>
+Example usage:
+</p>
+
+<pre>
+ usercategory dpkg-program [hidden]
+ * Program
+ + dpkg-deb [tag=dpkg-deb]
+ + dpkg-query [tag=dpkg-query]
+ + dselect [package=dselect]
+
+ usercategory new-status [hidden]
+ * Status [pending=]
+ + Outstanding with Patch Available [0:pending+tag=patch]
+ + Outstanding and Confirmed [1:pending+tag=confirmed]
+ + Outstanding and More Information Needed [pending+tag=moreinfo]
+ + Outstanding and Forwarded [pending+tag=forwarded]
+ + Outstanding but Will Not Fix [pending+tag=wontfix]
+ + Outstanding and Unclassified [2:pending]
+ + From other Branch [absent]
+ + Pending Upload [pending-fixed]
+ + Fixed in NMU [fixed]
+ + Resolved [done]
+ + Unknown Pending Status []
+
+ \# Change default view
+ usercategory normal
+ * new-status
+ * severity
+
+ usercategory old-normal
+ * status
+ * severity
+ * classification
+</pre>
+</dd>
+
<dt><code>help</code></dt>
<dd>
Requests that this help document be sent by email in plain ASCII.
Modified: packages/trunk/doc-debian/doc/bug-maint-info.wml
URL: http://svn.debian.org/wsvn/packages/trunk/doc-debian/doc/bug-maint-info.wml?rev=10350&op=diff
==============================================================================
--- packages/trunk/doc-debian/doc/bug-maint-info.wml (original)
+++ packages/trunk/doc-debian/doc/bug-maint-info.wml Sun Dec 29 18:36:31 2013
@@ -330,6 +330,20 @@
manager(s); do not set it yourself without explicit authorization from
them.</strong></dd>
+<dt><code>jessie</code></dt>
+ <dd>This is a release tag, which has two effects. When set on a
+ bug, the bug can only affect jessie (though it may also affect
+ other releases if other release tags are set) but
+ otherwise normal buggy/fixed/absent rules apply. The bug also
+ should not be archived until it is fixed in jessie.</dd>
+
+<dt><code>jessie-ignore</code></dt>
+ <dd>This release-critical bug is to be ignored for the purposes of
+ releasing jessie. <strong>This tag should only be used by the release
+ manager(s); do not set it yourself without explicit authorization from
+ them.</strong></dd>
+
+
<dt><code>sid</code></dt>
<dd>This is a release tag, which has two effects. When set on a
bug, the bug can only affect sid (though it may also affect
Modified: packages/trunk/doc-debian/doc/bug-maint-mailcontrol.wml
URL: http://svn.debian.org/wsvn/packages/trunk/doc-debian/doc/bug-maint-mailcontrol.wml?rev=10350&op=diff
==============================================================================
--- packages/trunk/doc-debian/doc/bug-maint-mailcontrol.wml (original)
+++ packages/trunk/doc-debian/doc/bug-maint-mailcontrol.wml Sun Dec 29 18:36:31 2013
@@ -90,6 +90,9 @@
<li><a href="#owner">owner</a> | <a href="#noowner">noowner</a></li>
<li><a href="#block">block</a> | <a href="#unblock">unblock</a></li>
<li><a href="#archive">archive</a> | <a href="#unarchive">unarchive</a></li>
+ <li><a href="server-request#user">user</a> |
+ <a href="server-request#usertag">usertag</a> |
+ <a href="server-request#usercategory">usercategory</a></li>
</ul>
</td>
</tr>
Modified: packages/trunk/doc-debian/doc/bug-reporting.wml
URL: http://svn.debian.org/wsvn/packages/trunk/doc-debian/doc/bug-reporting.wml?rev=10350&op=diff
==============================================================================
--- packages/trunk/doc-debian/doc/bug-reporting.wml (original)
+++ packages/trunk/doc-debian/doc/bug-reporting.wml Sun Dec 29 18:36:31 2013
@@ -308,7 +308,7 @@
to use this option.
</p>
-<h2>Control Commands</h2>
+<h2><a name="control">Control Commands</a></h2>
<pre>
Control: <var>control commands</var>
</pre>
@@ -316,9 +316,25 @@
<p>
Allows for any of the commands which must be sent to
<code>control@bugs.debian.org</code> to work when sent to <code>submit@bugs.debian.org</code> or
-<code>nnn@bugs.debian.org</code>. Please see <a href="server-control">the server
- control documentation</a> for more information on the control
-commands which are valid.</p>
+<code>nnn@bugs.debian.org</code>. -1 initially refers to the current
+ bug (that is, the bug created by a mail to submit@ or the bug
+ messaged with nnn@). Please see <a href="server-control">the
+ server control documentation</a> for more information on the
+ control commands which are valid.</p>
+
+<p>For example, the following pseudoheader in a message sent
+ to <code>12345@bugs.debian.org</code>:</p>
+
+<pre>
+Control: retitle -1 this is the title
+Control: severity -1 normal
+Control: summary -1 0
+Control: forward -1 http://bugs.debian.org/nnn
+</pre>
+
+<p>would cause 12345 to be retitled, its severity changed, summary set,
+and marked as forwarded.</p>
+
<h2>X-Debbugs- headers</h2>
Modified: packages/trunk/doc-debian/doc/social-contract.1.0.wml
URL: http://svn.debian.org/wsvn/packages/trunk/doc-debian/doc/social-contract.1.0.wml?rev=10350&op=diff
==============================================================================
--- packages/trunk/doc-debian/doc/social-contract.1.0.wml (original)
+++ packages/trunk/doc-debian/doc/social-contract.1.0.wml Sun Dec 29 18:36:31 2013
@@ -80,7 +80,7 @@
the license of the original software.</p>
<li><p><strong>Integrity of The Author's Source Code</strong>
<p>The license may restrict source-code from being distributed
- in modified form _<strong>only</strong>_ if the license allows
+ in modified form <strong>only</strong> if the license allows
the distribution of "<tt>patch files</tt>" with the source
code for the purpose of modifying the program at build
time. The license must explicitly permit distribution of
Modified: packages/trunk/doc-debian/doc/social-contract.wml
URL: http://svn.debian.org/wsvn/packages/trunk/doc-debian/doc/social-contract.wml?rev=10350&op=diff
==============================================================================
--- packages/trunk/doc-debian/doc/social-contract.wml (original)
+++ packages/trunk/doc-debian/doc/social-contract.wml Sun Dec 29 18:36:31 2013
@@ -103,7 +103,7 @@
the license of the original software.</p></li>
<li><p><strong>Integrity of The Author's Source Code</strong></p>
<p>The license may restrict source-code from being distributed
- in modified form _<strong>only</strong>_ if the license allows
+ in modified form <strong>only</strong> if the license allows
the distribution of <q><tt>patch files</tt></q> with the source
code for the purpose of modifying the program at build
time. The license must explicitly permit distribution of
Reply to: