X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=html%2Fserver-request.html.in;h=7941c5327c58af601b7c53e5fcc6f793abc910cd;hb=14a0ebc67f8b2510e7ca09d3298f23469bd03c32;hp=7136cb389a159e8410dc7db1fb3b7848eee05203;hpb=96da3ca68f6f6492bfa7e7f414326c45290839f8;p=debbugs.git diff --git a/html/server-request.html.in b/html/server-request.html.in index 7136cb3..7941c53 100644 --- a/html/server-request.html.in +++ b/html/server-request.html.in @@ -1,30 +1,31 @@ $gRequestHtml = < -$gProject $gBug system - $gBug logs by mail server - - - -

Introduction to the $gBug system request server

- - -There is a mailserver which can send the $gBug reports and + + + + $gProject $gBug system - $gBug logs by mail server + + + + + + +

Introduction to the $gBug system request server

+ +

There is a mailserver which can send the $gBug reports and indices as plain text on request. -

-To use it you send a mail message to -request\@$gEmailDomain. +

To use it you send a mail message to +request\@$gEmailDomain. The Subject of the message is ignored, except for generating the Subject of the reply. -

-The body you send should be a series of commands, one per line. +

The body you send should be a series of commands, one per line. You'll receive a reply which looks like a transcript of your message being interpreted, with a response to each command. No notifications are sent to anyone for most commands; however, the messages are logged and made available in the WWW pages. -

-Any text on a line starting with a hash sign # is +

Any text on a line starting with a hash sign # is ignored; the server will stop processing when it finds a line starting with quit, stop, thank or two hyphens (to avoid parsing a signature). It will also stop if it @@ -37,151 +38,162 @@ server.

send bugnumber

send-detail bugnumber -

-Requests the transcript for the $gBug report in question. -send-detail sends all of the `boring' messages in the -transcript, such as the various auto-acks (you should usually use -send as well, as the interesting messages are not sent by -send-detail). +

Requests the transcript for the $gBug report in question. + send-detail sends all of the `boring' messages in the + transcript as well, such as the various auto-acks.

index [full]

index-summary by-package

index-summary by-number -

-Request the full index (with full details, and including done and -forwarded reports), or the summary sorted by package or by number, -respectively. +

Request the full index (with full details, and including done and + forwarded reports), or the summary sorted by package or by number, + respectively.

index-maint -

-Requests the index page giving the list of maintainers with $gBugs (open -and recently-closed) in the tracking sytem. +

Requests the index page giving the list of maintainers with $gBugs + (open and recently-closed) in the tracking system.

index maint maintainer -

-Requests the index pages of $gBugs in the system for all maintainers -containing the string maintainer. The search term is a -case insensitive substring. The $gBug index for each matching -maintainer will be sent in a separate message. +

Requests the index pages of $gBugs in the system for the maintainer + maintainer. The search term is an exact match. + The $gBug index will be sent in a separate message.

index-packages -

-Requests the index page giving the list of packages with $gBugs (open -and recently-closed) in the tracking sytem. +

Requests the index page giving the list of packages with $gBugs (open + and recently-closed) in the tracking system.

index packages package -

-Requests the index pages of $gBugs in the system for all packages -containing the string package. The search term is a case -insensitive substring. The $gBug index for each matching package will -be sent in a separate message. +

Requests the index pages of $gBugs in the system for the package + package. The search term is an exact match. + The $gBug index will be sent in a separate message.

send-unmatched [this|0]

send-unmatched last|-1

send-unmatched old|-2 -

-Requests logs of messages not matched to a particular $gBug report, for -this week, last week and the week before. (Each week ends on a -Wednesday.) +

Requests logs of messages not matched to a particular $gBug report, + for this week, last week and the week before. (Each week ends on a + Wednesday.)

getinfo filename -

-Request a file containing information about package(s) and or -maintainer(s) - the files available are: -

maintainers -

-The unified list of packages' maintainers, as used by the tracking -system. +

Request a file containing information about package(s) and or + maintainer(s) - the files available are: -$gCreateMaintainers +

maintainers +: The unified list of packages' maintainers, as used by the tracking + system. - + $gCreateMaintainers -
pseudo-packages.description -
pseudo-packages.maintainers -: -List of descriptions and maintainers respectively for pseudo-packages. -

+ + +

pseudo-packages.description +

pseudo-packages.maintainers +

List of descriptions and maintainers respectively for + pseudo-packages. +

+ +

refcard + +

Requests that the mailservers' reference card be sent in plain ASCII. + +

user email + +

Set the user to the given email address. The default user is the + email address set in your mail client's From: or Reply-To: field. You + should not use other people's email addresses without permission. -

refcards -

-Requests that the mailservers' reference card be sent in plain ASCII. +

usertag bugnumber [ + | - | = ] tag [ tag ... ] + +

Sets usertags for the $gBug report #bugnumber. No + notification is sent to the user who reported the $gBug, nor to + the package maintainer. Setting the action to + means + to add each given tag, - means to remove + each given tag, and = means to ignore the + current tags and set them afresh to the list provided. The default + action is adding. + +

Example usage:

+ +

+        # same as 'tags 123456 + patch'
+        usertag 123456 patch
+  
+        # same as 'tags 123456 + help security'
+        usertag 123456 help security
+

+ +

The meaning of usertags is decided by the owner of the email address + they are associated with.

help -

-Requests that this help document be sent by email in plain ASCII. + +

Requests that this help document be sent by email in plain ASCII.

quit

stop

thank...

--... -

-Stops processing at this point of the message. After this you may -include any text you like, and it will be ignored. You can use this -to include longer comments than are suitable for #, for -example for the benefit of human readers of your message (reading it -via the tracking system logs or due to a CC or -BCC). +

Stops processing at this point of the message. After this you may + include any text you like, and it will be ignored. You can use this + to include longer comments than are suitable for #, for + example for the benefit of human readers of your message (reading it + via the tracking system logs or due to a CC or + BCC).

#... -

-One-line comment. The # must be at the start of the -line. +

One-line comment. The # must be at the start of the + line.

debug level -

-Sets the debugging level to level, which should be a -nonnegative integer. 0 is no debugging; 1 is usually sufficient. The -debugging output appears in the transcript. It is not likely to be -useful to general users of the $gBug system. +

Sets the debugging level to level, which should be a + nonnegative integer. 0 is no debugging; 1 is usually sufficient. The + debugging output appears in the transcript. It is not likely to be + useful to general users of the $gBug system.

-There is a reference card for the +

There is a reference card for the mailservers, available via the WWW, in bug-mailserver-refcard.txt or by email using the refcard command (see above). -

-If you wish to manipulate $gBug reports you should use the +

If you wish to manipulate $gBug reports you should use the control\@gEmailDomain address, which understands a -superset of the commands listed -above. This is described in another document, available on the -WWW, in the file bug-maint-mailcontrol.txt, or by +superset of the commands listed +above. This is described in another document, available on the +WWW, in the file +bug-maint-mailcontrol.txt, or by sending help to control\@$gEmailDomain. -

-In case you are reading this as a plain text file or via email: an +

In case you are reading this as a plain text file or via email: an HTML version is available via the $gBug system main contents page http://$gWebDomain/. -

-Other pages: + +

Other pages: