home *** CD-ROM | disk | FTP | other *** search
/ Dream 46 / Amiga_Dream_46.iso / bo / extras / doc / bug-maint-info.txt < prev    next >
Text File  |  1996-10-22  |  6KB  |  137 lines
  1.  
  2.           Developers' information regarding the bug processing system
  3.                                        
  4.    Initially, a bug report is submitted by a user as an ordinary mail
  5.    message to submit@bugs.debian.org. This will then be given a number,
  6.    acknowledged to the user, and forwarded to the debian-devel list. If
  7.    the submitter included a Package line listing a package with a known
  8.    maintainer the maintainer will get a copy too.
  9.    
  10.    The Subject line will have Bug#nnn: added, and the Reply-To will be
  11.    set to include both the submitter of the report and
  12.    nnn@bugs.debian.org.
  13.    
  14. Closing bug reports
  15.  
  16.    A developer who sees a bug on debian-devel and takes responsibility
  17.    for it should hit Reply in their favourite mailreader, and then edit
  18.    the To field to say nnn-done@bugs.debian.org instead of nnn@bugs
  19.    (nnn-close is provided as an alias for nnn-done).
  20.    
  21.    The address of the original submitter of the bug report will be
  22.    included in the default To field, because the bug system included it
  23.    in the Reply-To.
  24.    
  25.    `Done' messages are not automatically forwarded to the mailing list,
  26.    so it may sometimes be worthwhile including the debian-devel mailing
  27.    list if the other developers are likely to be interested.
  28.    
  29.    The person closing the bug and the person who submitted it will each
  30.    get a notification about the change in status of the report.
  31.    
  32. Followup messages
  33.  
  34.    If a developer wishes to reply to a bug report without marking the bug
  35.    as done they may simply reply to the message. Their reply will (by
  36.    default) go to nnn@bugs and to the original submitter of the bug
  37.    report. The bug tracking system will file the reply with the rest of
  38.    the logs for that bug report and forward it to debian-devel. The bug
  39.    will not be marked as done.
  40.    
  41.    If you wish to send a followup message which is not appropriate for
  42.    debian-devel you can do so by sending it to nnn-quiet@bugs or
  43.    nnn-maintonly@bugs, which only file it (not forwarding it anywhere)
  44.    and send it on only to the maintainer of the package in question,
  45.    respectively.
  46.    
  47.    Do _not_ use the `reply to all recipients' or `followup' feature of
  48.    your mailer unless you intend to edit down the recipients
  49.    substantially. In particular, don't send a followup message both to
  50.    nnn@bugs.debian.org and to submit@bugs.debian.org, because the bug
  51.    system will then get two copies of it and each one will be forwarded
  52.    to debian-devel separately.
  53.    
  54. Recording that you have passed on a bug report
  55.  
  56.    When a developer forwards a bug report to the developer of the general
  57.    source package from which the Debian package is derived, they should
  58.    note this in the bug tracking system as follows:
  59.    
  60.    Make sure that the To field of your message to the author to has only
  61.    the author(s) address(es) in it; put both the person who reported the
  62.    bug and nnn-forwarded@bugs.debian.org in the CC field.
  63.    
  64.    Ask the author to preserve the CC to nnn-forwarded@bugs when they
  65.    reply, so that the bug tracking system will file their reply with the
  66.    original report.
  67.    
  68.    When the bug tracking system gets a message at nnn-forwarded it will
  69.    mark the relevant bug as having been forwarded to the address(es) in
  70.    the To field of the message it gets.
  71.    
  72.    You can also manipulate the `forwarded to' information by sending
  73.    messages to control@bugs.
  74.    
  75. Summary postings to debian-devel
  76.  
  77.    Every Friday a list of outstanding bug reports is posted to
  78.    debian-devel, sorted by age of report; every Tuesday a list of bug
  79.    reports that have gone unanswered too long is posted, sorted by
  80.    package maintainer.
  81.    
  82.    If the maintainer of a package is listed incorrectly this is usually
  83.    because the maintainer has changed recently, and the new maintainer
  84.    hasn't yet uploaded a new version of the package with a changed
  85.    Maintainer control file field. This will be fixed when the package is
  86.    uploaded; alternatively, there is an override file which the
  87.    distribution maintainers can edit to record the change in maintainer,
  88.    for example if a rebuild and reupload of the package is not expected
  89.    to be needed soon. Contact iwj-mastercron@master.debian.org for
  90.    changes to the override file.
  91.    
  92. Reopening, reassigning and manipulating bugs
  93.  
  94.    It is possible to reassign bug reports to other packages, to reopen
  95.    erroneously-closed ones, to modify the information saying to where, if
  96.    anywhere, a bug report has been forwarded, to change the titles of
  97.    reports and to merge and unmerge bug reports. This is done by sending
  98.    mail to control@bugs.debian.org.
  99.    
  100.    The format of these messages is described in another document
  101.    available on the World Wide Web or in the file
  102.    bug-maint-mailcontrol.txt. A plain text version can also be obtained
  103.    by mailing the word help to the server at the address above.
  104.    
  105. More-or-less obsolete subject-scanning feature
  106.  
  107.    Messages that arrive at submit or bugs whose Subject starts Bug#nnn
  108.    will be treated as having been sent to nnn@bugs. This is both for
  109.    backwards compatibility with mail forwarded from the old addresses,
  110.    and to catch followup mail sent to submit by mistake (for example, by
  111.    using reply to all recipients).
  112.    
  113.    A similar scheme operates for maintonly, done, quiet and forwarded,
  114.    which treat mail arriving with a Subject tag as having been sent to
  115.    the corresponding nnn-whatever@bugs address.
  116.    
  117.    Messages arriving at plain forwarded and done - ie, with no bug report
  118.    number in the address - and without a bug number in the Subject will
  119.    be filed under `junk' and kept for a few weeks, but otherwise ignored.
  120.    
  121. Future plans
  122.  
  123.    At some point the Package: secondary header field may become mandatory
  124.    - at the moment omitting it just produces a warning message.
  125.    
  126. Obsolete X-Debian-PR: quiet feature
  127.  
  128.    It used to be possible to prevent the bug tracking system from
  129.    forwarding anywhere messages it received at debian-bugs, by putting an
  130.    X-Debian-PR: quiet line in the actual mail header.
  131.    
  132.    This header line is now ignored. Instead, send your message to quiet
  133.    or nnn-quiet (or maintonly or nnn-maintonly).
  134.      _________________________________________________________________
  135.                                       
  136.     Ian Jackson / owner@bugs.debian.org. 20th July 1996.
  137.