/usr/share/doc/xorg/howto/triage-bugs.html is in xserver-xorg 1:7.6+12ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.6.6" />
<title>How to triage bugs</title>
<link rel="stylesheet" href="../xsf.css" type="text/css" />
<script type="text/javascript" src="../asciidoc-xhtml11.js"></script>
<script type="text/javascript">
/*<![CDATA[*/
asciidoc.install(2);
/*]]>*/
</script>
</head>
<body class="article">
<div id="header">
<h1><a href="../index.html">XSF</a> / How to triage bugs</h1>
<span id="author">Cyril Brulebois</span><br />
<span id="email"><tt><<a href="mailto:kibi@debian.org">kibi@debian.org</a>></tt></span><br />
<div id="toc">
<div id="toctitle">Table of Contents</div>
<noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
</div>
</div>
<div id="content">
<div class="sect1">
<h2 id="_packaging_bugs_or_upstream_bugs">Packaging bugs or upstream bugs?</h2>
<div class="sectionbody">
<div class="paragraph"><p>It’d be nice to get all upstream bugs tagged as such (<tt>upstream</tt> tag),
forwarded upstream (which means the bugzilla instance on
<a href="http://bugs.freedesktop.org/">http://bugs.freedesktop.org/</a> for most packages), and marked as such.</p></div>
<div class="paragraph"><p>A mail to <tt>control@bugs.debian.org</tt> would look like:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>tag X upstream
forwarded X https://bugs.freedesktop.org/show_bug.cgi?id=Y
thanks</tt></pre>
</div></div>
<div class="paragraph"><p>Then <a href="http://bts-link.alioth.debian.org/"><tt>bts-link</tt></a> comes into play
and helps us tracking upstream status, which is pretty nice to have.</p></div>
<div style="page-break-after:always"></div>
</div>
</div>
<div class="sect1">
<h2 id="_usertags">Usertags</h2>
<div class="sectionbody">
<div class="paragraph"><p>Another feature of the BTS is usertagging. That lets people keep track
of additional tags, “attached” to a given mail address. For XSF,
that’s <tt>debian-x@lists.debian.org</tt>.</p></div>
<div class="paragraph"><p>The list of all usertagged bugs can be seen on the following page; the
list of all used usertags is at the bottom, in the form.<br />
→ <a href="http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org">http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org</a></p></div>
<div class="paragraph"><p>Let’s give some examples:</p></div>
<div class="ulist"><ul>
<li>
<p>
<tt>i810</tt>, <tt>i915</tt>: helps triaging <tt>-video-intel</tt> bugs depending on the
chipset.
</p>
</li>
<li>
<p>
<tt>r200</tt>, <tt>r300</tt>: ditto for <tt>-video-ati</tt>.
</p>
</li>
<li>
<p>
<tt>xset</tt>, <tt>xrandr</tt>: helps triaging <tt>x11-xserver-utils</tt> bugs depending
on the affected tool (like other <tt>x11-*</tt> packages, that’s a bundle
of teeny tiny apps).
</p>
</li>
<li>
<p>
<tt>squeeze-candidate</tt>: helps keeping a list of bugs we’d like to get
fixed in a point release (through a stable update).
</p>
</li>
<li>
<p>
<tt>needs-forwarding</tt>: of course, it’d be nice to have all upstream
bugs reported upstream, but some might need special attention
(<em>e.g.</em> security bugs).
</p>
</li>
</ul></div>
<div class="paragraph"><p>Here’s an example of URL, for the last tags:<br />
→ <a href="http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=squeeze-candidate">http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=squeeze-candidate</a><br />
→ <a href="http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=needs-forwarding">http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=needs-forwarding</a></p></div>
<div class="paragraph"><p>By the way one should keep an eye on the list of found/fixed
versions since those bugs are likely marked as resolved (in <tt>unstable</tt>
or <tt>experimental</tt>), but might still affect a stable release.</p></div>
<div class="paragraph"><p>To list the bugs marked <tt>squeeze-candidate</tt> but not
<tt>squeeze-accepted</tt>:<br />
→ <a href="http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=squeeze-candidate&exclude=tag:squeeze-accepted">http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x%40lists.debian.org&tag=squeeze-candidate&exclude=tag:squeeze-accepted</a></p></div>
<div style="page-break-after:always"></div>
</div>
</div>
<div class="sect1">
<h2 id="_categories">Categories</h2>
<div class="sectionbody">
<div class="paragraph"><p>The BTS has yet another feature which can help, categories. That’s
based on usertags as well, but one has to use the package address
(<tt>$package@packages.debian.org</tt>), so that’s package-specific rather
than team-specific.</p></div>
<div class="paragraph"><p>Categories are
<a href="http://wiki.debian.org/bugs.debian.org/usertags">documented on the wiki</a>,
and they would probably be welcome in the <tt>intel</tt> and <tt>ati</tt> cases
above, as well as in the “multiple tools in a single bundle”
cases… An example of what we could achieve is the
<a href="http://bugs.debian.org/devscripts">devscripts bug page</a> (it takes
some time to load, plenty of bugs).</p></div>
<div class="paragraph"><p>Needed steps for that to happen:</p></div>
<div class="ulist"><ul>
<li>
<p>
create usercategories.
</p>
</li>
<li>
<p>
move usertags from <tt>debian-x@lists.debian.org</tt> to
<tt>$package@packages.debian.org</tt>, probably using the <tt>bts select</tt>
command to get the list over which to iterate.
</p>
</li>
<li>
<p>
profit!
</p>
</li>
</ul></div>
<div class="paragraph"><p>To move the usertags, something like that should do the job:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt># Adding usertags:
user $package1@packages.debian.org
usertag X xset
usertag Y xrandr
user $package2@packages.debian.org
usertag Z i810
# Removing tags which are no longer needed:
user debian-x@lists.debian.org
usertag X - xset
usertag Y - xrandr
usertag Z - i810</tt></pre>
</div></div>
</div>
</div>
</div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
Last updated 2011-06-06 07:22:56 UTC
</div>
</div>
</body>
</html>
|