home *** CD-ROM | disk | FTP | other *** search
/ Boot Disc 15 / boot-disc-1997-11.iso / Debian / Docs / bug-log-mailserver.txt < prev    next >
Text File  |  1997-09-15  |  6KB  |  142 lines
  1.  
  2.                  Introduction to the bug system request server
  3.                                        
  4.    There is a mailserver which can send the bug reports and indices as
  5.    plain text on request.
  6.    
  7.    To use it you send a mail message to request@bugs.debian.org. The
  8.    Subject of the message is ignored, except for generating the Subject
  9.    of the reply.
  10.    
  11.    The body you send should be a series of commands, one per line. You'll
  12.    receive a reply which looks like a transcript of your message being
  13.    interpreted, with a response to each command. No notifications are
  14.    sent to anyone for most commands; however, the messages are logged and
  15.    made available in the WWW pages.
  16.    
  17.    Any text on a line starting with a hash sign # is ignored; the server
  18.    will stop processing when it finds a line starting with quit, stop,
  19.    thank or two hyphens (to avoid parsing a signature). It will also stop
  20.    if it encounters too many unrecognised or badly-formatted commands. If
  21.    no commands are successfully handled it will send the help text for
  22.    the server.
  23.    
  24.                               Commands available
  25.                                        
  26.    send bugnumber
  27.           
  28.    send-detail bugnumber
  29.           Requests the transcript for the bug report in question.
  30.           send-detail sends all of the `boring' messages in the
  31.           transcript, such as the various auto-acks (you should usually
  32.           use send as well, as the interesting messages are not sent by
  33.           send-detail).
  34.           
  35.    index [full]
  36.           
  37.    index-summary by-package
  38.           
  39.    index-summary by-number
  40.           Request the full index (with full details, and including done
  41.           and forwarded reports), or the summary sorted by package or by
  42.           number, respectively.
  43.           
  44.    index-maint
  45.           Requests the index page giving the list of maintainers with
  46.           bugs (open and recently-closed) in the tracking sytem.
  47.           
  48.    index maint maintainer
  49.           Requests the index pages of bugs in the system for all
  50.           maintainers containing the string maintainer. The search term
  51.           is a case insensitive substring. The bug index for each
  52.           matching maintainer will be sent in a separate message.
  53.           
  54.    send-unmatched [this|0]
  55.           
  56.    send-unmatched last|-1
  57.           
  58.    send-unmatched old|-2
  59.           Requests logs of messages not matched to a particular bug
  60.           report, for this week, last week and the week before. (Each
  61.           week ends on a Wednesday.)
  62.           
  63.    getinfo filename
  64.           Request a file containing information about package(s) and or
  65.           maintainer(s) - the files available are:
  66.           
  67.         maintainers
  68.                The unified list of packages' maintainers, as used by the
  69.                tracking system. This is derived from information in the
  70.                Packages files, override files and pseudo-packages files.
  71.         override.stable
  72.         override.development
  73.         override.contrib
  74.         override.non-free
  75.         override.experimental
  76.         override.codeword
  77.                Information about the priorities and sections of packages
  78.                and overriding values for the maintainers. This
  79.                information is used by the process which generates the
  80.                Packages files in the FTP archive. Information is
  81.                available for each of the main distribution trees
  82.                available; the current stable and development trees are
  83.                available by their codewords as well as by their release
  84.                status.
  85.         pseudo-packages.description
  86.         pseudo-packages.maintainers
  87.                List of descriptions and maintainers respectively for
  88.                pseudo-packages.
  89.                
  90.    refcards
  91.           Requests that the mailservers' reference card be sent in plain
  92.           ASCII.
  93.           
  94.    help
  95.           Requests that this help document be sent by email in plain
  96.           ASCII.
  97.           
  98.    quit
  99.           
  100.    stop
  101.           
  102.    thank...
  103.           
  104.    --...
  105.           Stops processing at this point of the message. After this you
  106.           may include any text you like, and it will be ignored. You can
  107.           use this to include longer comments than are suitable for #,
  108.           for example for the benefit of human readers of your message
  109.           (reading it via the tracking system logs or due to a CC or
  110.           BCC).
  111.           
  112.    #...
  113.           One-line comment. The # must be at the start of the line.
  114.           
  115.    debug level
  116.           Sets the debugging level to level, which should be a
  117.           nonnegative integer. 0 is no debugging; 1 is usually
  118.           sufficient. The debugging output appears in the transcript. It
  119.           is not likely to be useful to general users of the bug system.
  120.           
  121.    There is a reference card for the mailservers, available via the WWW,
  122.    in bug-mailserver-refcard.txt or by email using the refcard command
  123.    (see above).
  124.    
  125.    If you wish to manipulate bug reports you should use the
  126.    control@bugs.debian.org address, which understands a superset of the
  127.    commands listed above. This is described in another document,
  128.    available on the WWW, in the file bug-maint-mailcontrol.txt, or by
  129.    sending help to control@bugs.
  130.    
  131.    In case you are reading this as a plain text file or via email: an
  132.    HTML version is available via the bug system main contents page
  133.    http://www.debian.org/Bugs/.
  134.    
  135.    Suggestions for future additions are welcome. Please mail
  136.    owner@bugs.debian.org, debian-user@lists.debian.org or
  137.    debian-devel@lists.debian.org.
  138.    
  139.      _________________________________________________________________
  140.                                       
  141.     Ian Jackson / owner@bugs.debian.org. 20th July 1996.
  142.