~timrchavez/live-build/lb-sg-2.x-zsynczsync-fix-take2

« back to all changes in this revision

Viewing changes to includes/squeeze/common/doc/bug-log-mailserver.txt

  • Committer: Daniel Baumann
  • Date: 2011-03-09 18:17:33 UTC
  • Revision ID: daniel@debian.org-20110309181733-thqkefnkldyf3h59
Updating includes for squeeze.

Show diffs side-by-side

added added

removed removed

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