← Back to branch summary

~ubuntu-branches/ubuntu/precise/xorg/precise

« back to all changes in this revision

Viewing changes to xsf-docs/howto/triage-bugs.mdwn

  • Committer: Bazaar Package Importer
  • Author(s): Timo Aaltonen, Bryce Harrington, Timo Aaltonen
  • Date: 2011-06-14 15:39:40 UTC
  • mfrom: (6.3.18 sid)
  • Revision ID: james.westby@ubuntu.com-20110614153940-b9i0fr1v2kchiozh
Tags: 1:7.6+7ubuntu1
https://launchpad.net/bugs/480744
https://launchpad.net/bugs/778758
* Merge from Debian unstable, remaining changes:
  - Add apport hook
  - Demote xfonts-{75DPI,100DPI} to Suggests. Demote xfonts-scalable to
    Recommends.
  - debian/local/Xsession:
    Truncate xsession-errors on startup if too big
  - debian/local/Xsession.d/20x11-common_process-args:
    Add support for session command containing args.
  - debian/local/Xsession.d/60x11-common_localhost:
    Authorise all processes running with the user's credentials to connect
    to the server.
  - debian/rules, debian/control:
    Add dependencies on x11-common, and symlink /usr/share/doc directories
    of all packages to x11-common's.
  - debian/scripts/vars.*:
    + Don't drop wacom from input-all.
    + Add -vmmouse to input-all for amd64 and i386.
    + Add -qxl to video-all for amd64 and i386.
    + Add -geode to video-all for i386.
    + Drop video drivers that are likely irrelevant for ARM.
  - debian/xserver-xorg.postinst.in: Also migrate users from psb → vesa.

[ Bryce Harrington ]
* apport/source_xorg.py:
  - Move Failsafe-X out of the xorg package to xdiagnose
    (LP: #480744)
  - Simplify answers for bug reporters filing post-release reports.
    (LP: #778758)
  - Remove attach_drm_info().  This is useful info but we use it very
    infrequently, and it is already available in other log files.  But the
    call makes bug reports a bit cluttered since it adds a lot of lines to
    the report itself.

[ Timo Aaltonen ]
* rules: A stampfile generation was commented out by mistake, uncomment
  it.
* Rework the x11-common.{postinst,postrm,preinst} failsafe conffile
  handling, the previous ones added in 1:7.6+4ubuntu1 were wrong too.
* scripts/vars.{amd64,i386,powerpc}: Remove apm, ark, chips, i128, i740,
  rendition, s3virge, tseng, voodoo from xserver-xorg-video-all
  dependencies. They are unmaintained and obsolete.

Show diffs side-by-side

added added

removed removed

Lines of Context:
xsf-docs/howto/triage-bugs.mdwn
1
 
# How to triage bugs
2
 
 
3
 
Cyril Brulebois <kibi@debian.org>
4
 
 
5
 
 
6
 
## Packaging bugs or upstream bugs?
7
 
 
8
 
It’d be nice to get all upstream bugs tagged as such (`upstream` tag),
9
 
forwarded upstream (which means the bugzilla instance on
10
 
<http://bugs.freedesktop.org/> for most packages), and marked as such.
11
 
 
12
 
A mail to `control@bugs.debian.org` would look like:
13
 
 
14
 
    tag X upstream
15
 
    forwarded X https://bugs.freedesktop.org/show_bug.cgi?id=Y
16
 
    thanks
17
 
 
18
 
Then [`bts-link`](http://bts-link.alioth.debian.org/) comes into play
19
 
and help us tracking upstream status, which is pretty nice to have.
20
 
 
21
 
 
22
 
## Usertags
23
 
 
24
 
Another feature of the BTS is usertagging. That lets people keep track
25
 
of additional tags, “attached” to a given mail address. For XSF,
26
 
that’s `debian-x@lists.debian.org`.
27
 
 
28
 
The list of all usertagged bugs can be seen on the following page; the
29
 
list of all used usertags is at the bottom, in the form.  
30
 
→ <http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x@lists.debian.org>
31
 
 
32
 
Let’s give some examples:
33
 
 
34
 
 * `i810`, `i915`: helps triaging `-video-intel` bugs depending on the
35
 
   chipset.
36
 
 * `r200`, `r300`: ditto for `-video-ati`.
37
 
 * `xset`, `xrandr`: helps triaging `x11-xserver-utils` bugs depending
38
 
   on the affected tool (like other `x11-*` packages, that’s a bundle
39
 
   of teeny tiny apps).
40
 
 * `squeeze-candidate`: helps keeping a list of bugs we’d like to get
41
 
   fixed in a point release (through a stable update).
42
 
 * `needs-forwarding`: of course, it’d be nice to have all upstream
43
 
   bugs reported upstream, but some might need special attention
44
 
   (*e.g.* security bugs).
45
 
 
46
 
Here’s an example of URL, for the last tags:  
47
 
→ <http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x@lists.debian.org&tag=squeeze-candidate>  
48
 
→ <http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x@lists.debian.org&tag=needs-forwarding>
49
 
 
50
 
By the way one should keep an eye on the list of found/fixed
51
 
versions since those bugs are likely marked as resolved (in `unstable`
52
 
or `experimental`), but might still affect a stable release.
53
 
 
54
 
To list the bugs marked `squeeze-candidate` but not
55
 
`squeeze-accepted`:  
56
 
→ <http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x@lists.debian.org&tag=squeeze-candidate&exclude=tag:squeeze-accepted>
57
 
 
58
 
 
59
 
## Categories
60
 
 
61
 
The BTS has yet another feature which can help, categories. That’s
62
 
based on usertags as well, but one has to use the package address
63
 
(`$package@packages.debian.org`), so that’s package-specific rather
64
 
than team-specific.
65
 
 
66
 
Categories are
67
 
[documented on the wiki](http://wiki.debian.org/bugs.debian.org/usertags),
68
 
and they would probably be welcome in the `intel` and `ati` cases
69
 
above, as well as in the “multiple tools in a single bundle”
70
 
cases… An example of what we could achieve is the
71
 
[devscripts bug page](http://bugs.debian.org/devscripts) (it takes
72
 
some time to load, plenty of bugs).
73
 
 
74
 
Needed steps for that to happen:
75
 
 
76
 
 * create usercategories.
77
 
 * move usertags from `debian-x@lists.debian.org` to
78
 
   `$package@packages.debian.org`, probably using the `bts select`
79
 
   command to get the list over which to iterate.
80
 
 * profit!
81
 
 
82
 
To move the usertags, something like that should do the job:
83
 
 
84
 
    # Adding usertags:
85
 
    user $package1@packages.debian.org
86
 
    usertag X xset
87
 
    usertag Y xrandr
88
 
    user $package2@packages.debian.org
89
 
    usertag Z i810
90
 
    
91
 
    # Removing tags which are no longer needed:
92
 
    user debian-x@lists.debian.org
93
 
    usertag X - xset
94
 
    usertag Y - xrandr
95
 
    usertag Z - i810