.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "BTS.DE 1"
.TH BTS.DE 1 "2015-06-15" "Debian-Hilfswerkzeuge" " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "BEZEICHNUNG"
.IX Header "BEZEICHNUNG"
bts \- Befehlszeilenschnittstelle der Entwickler zum \s-1BTS\s0
.SH "ÜBERSICHT"
.IX Header "ÜBERSICHT"
\&\fBbts\fR [\fIOptionen\fR] \fIBefehl\fR [\fIArgumente\fR] [\fB#\fR\fIKommentar\fR] [\fB.\fR|\fB,\fR
\&\fIBefehl\fR [\fIArgumente\fR] [\fB#\fR\fIKommentar\fR]] …
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
Dies ist eine Befehlszeilenschnittstelle zur Debian-Fehlerdatenbank (\s-1BTS\s0),
die hauptsächlich für den Gebrauch durch Entwickler gedacht ist. Sie
ermöglicht die Manipulation des \s-1BTS\s0 durch einfache Befehle, die an der
Eingabeaufforderung oder in einem Skript ausgeführt werden können, führt
verschiedene Plausibilitätsprüfungen der Eingabe durch und konstruiert und
sendet E\-Mails für Sie an die BTS-Steueradresse. Außerdem kann ein lokaler
Zwischenspeicher von Webseiten und E\-Mails vom \s-1BTS\s0 erzeugt und aktualisiert
werden.
.PP
Im Allgemeinen ist die Befehlszeilenschnittstelle das, was Sie in einer Mail
an control@bugs.debian.org schreiben würden, nur mit vorangestelltem
»bts«. Zum Beispiel:
.PP
.Vb 3
\& % bts severity 69042 normal
\& % bts merge 69042 43233
\& % bts retitle 69042 blah blah
.Ve
.PP
Für Ihren Komfort wurden ein paar zusätzliche Befehle hinzugefügt und dieses
Programm ist ist weniger strikt in dem, was eine gültige Fehlernummer
darstellt. Beispielsweise wird »severity Bug#85942 normal« wie auch
»severity #85942 normal« verstanden. (Allerdings könnte Ihre Shell »#« als
Kommentarzeichen ansehen, weswegen Sie es maskieren müssen!)
.PP
Außerdem ermöglicht Ihnen dieses Programm zu Ihrer Annehmlichkeit Befehle
auf die kleinste eindeutige Teilzeichenkette abzukürzen (ähnlich wie Sie \s-1CVS\s0
Befehle abkürzen lässt). So versteht es Dinge wie »bts cl 85942«.
.PP
Es ist ebenfalls möglich, der E\-Mail an das \s-1BTS\s0 einen Kommentar
beizufügen. Falls Ihre Shell nicht den Kommentar in einem Befehl wie »bts
severity 30321 normal #inflated severity« streicht, dann ist dieses Programm
schlau genug herauszufinden, wo der Kommentar ist und ihn in die E\-Mail
einzufügen. Beachten Sie, dass die meisten Shells solche Kommentare
streichen, bevor sie beim Programm ankommen, es sei denn, der Kommentar ist
maskiert. (Etwas wie »bts severity #85942 normal« wird nicht als Kommentar
angesehen!)
.PP
Sie können mehrere Befehle angeben, indem Sie sie durch einen einzelnen
Punkt trennen, ungefähr wie \fBupdate\-rc.d\fR; ein einzelnes Komma könnte auch
benutzt werden; alle die Befehle werden in einer einzigen E\-Mail gesandt. Es
ist wichtig, dass der Punkt/das Komma von Leerzeichen umgeben ist, damit es
nicht als Teil des Befehls missverstanden wird. Zum Beispiel (wo nötig
maskieren, so dass \fBbts\fR den Kommentar sieht):
.PP
.Vb 1
\& % bts severity 95672 normal , merge 95672 95673 \e#sie sind identisch!
.Ve
.PP
Die Abkürzung »it« könnte benutzt werden, um auf die zuletzt erwähnte
Fehlernummer Bezug zu nehmen, daher können Sie schreiben:
.PP
.Vb 1
\& % bts severity 95672 wishlist , retitle it "bts: please add a \-\-foo option"
.Ve
.PP
Bitte benutzen Sie dieses Programm verantwortungsvoll und berücksichtigen
Sie unsere Anwender.
.SH "OPTIONEN"
.IX Header "OPTIONEN"
\&\fBbts\fR durchsucht die \fBdevscripts\fR\-Konfigurationsdateien wie oben
beschrieben. Befehlszeilenoptionen setzen jedoch die Einstellungen der
Konfigurationsdatei außer Kr.
.IP "\fB\-o\fR, \fB\-\-offline\fR" 4
.IX Item "-o, --offline"
sorgt dafür, dass \fBbts\fR zwischengespeicherte Fehler für die Befehle \fBshow\fR
und \fBbugs\fR benutzt, falls für die angeforderten Daten ein Zwischenspeicher
verfügbar ist. Im Nachstehenden finden Sie Informationen zum Befehl
\&\fBcache\fR, wie Sie einen Zwischenspeicher einrichten.
.IP "\fB\-\-online\fR, \fB\-\-no\-offline\fR" 4
.IX Item "--online, --no-offline"
Gegenteil von \fB\-\-offline\fR; setzt alle Konfigurationsdatei-Direktiven außer
Kraft, um offline zu arbeiten
.IP "\fB\-n\fR, \fB\-\-no\-action\fR" 4
.IX Item "-n, --no-action"
sendet keine E\-Mails, gibt sie aber auf der Standardausgabe aus.
.IP "\fB\-\-cache\fR, \fB\-\-no\-cache\fR" 4
.IX Item "--cache, --no-cache"
Soll versucht werden, neue Versionen der BTS-Seiten bei der Ausführung der
Befehle \fBshow\fR/\fBbugs\fR zwischenzuspeichern? Vorgabe ist
Zwischenspeicherung.
.IP "\fB\-\-cache\-mode=\fR{\fBmin\fR|\fBmbox\fR|\fBfull\fR}" 4
.IX Item "--cache-mode={min|mbox|full}"
Soll nur der reine Fehler (\fBmin\fR) oder auch die Mbox-Version (\fBmbox\fR)
wiedergegeben werden oder soll das ganze Ding, einschließlich der Mbox, den
langweiligen Anhängen an die BTS-Fehlerseiten und die Bestätigungs\-E\-Mails
(\fBfull\fR) wiedergegeben werden, wenn ein \fBbts cache\fR\-Befehl ausgeführt
wird? Vorgabe ist \fBmin\fR.
.IP "\fB\-\-cache\-delay=\fR\fISekunden\fR" 4
.IX Item "--cache-delay=Sekunden"
Zeit in Sekunden, die zwischen jedem Herunterladen gewartet wird, um zu
verhindern, dass auf den BTS-Webserver eingehämmert wird. Vorgabe ist fünf
Sekunden.
.IP "\fB\-\-mbox\fR" 4
.IX Item "--mbox"
öffnet ein E\-Mail-Programm, um die Mbox zu lesen, die zu einer gegebenen
Fehlernummer für \fBshow\fR\- und \fBbugs\fR\-Befehle gehört.
.IP "\fB\-\-mailreader=\fR\fIE\-MAIL-PROGRAMM\fR" 4
.IX Item "--mailreader=E-MAIL-PROGRAMM"
gibt den Befehl zum Lesen der Mbox an; muss eine »\fB\f(CB%s\fB\fR«\-Zeichenkette (ohne
Anführungszeichen) enthalten, die durch den Namen der Mbox-Datei ersetzt
wird. Der Befehl wird bei Leerzeichen getrennt und nicht an eine Shell
übergeben. Vorgabe ist »\fBmutt \-f \f(CB%s\fB\fR«. (Außerdem wird \fB%%\fR durch ein
einzelnes \fB%\fR ersetzt, falls dies nötig ist.)
.IP "\fB\-\-cc\-addr=\fR\fI\s-1CC_E\-MAIL_ADRESSE\s0\fR" 4
.IX Item "--cc-addr=CC_E-MAIL_ADRESSE"
sendet Kopien an eine Liste von Anwendern. \fI\s-1CC_E\-MAIL_ADRESSE\s0\fR sollte eine
durch Kommas getrennte Liste von E\-Mail-Adressen sein.
.IP "\fB\-\-use\-default\-cc\fR" 4
.IX Item "--use-default-cc"
fügt die in der Konfigurationsdateioption \fB\s-1BTS_DEFAULT_CC\s0\fR angegebenen
Adressen der Liste hinzu, die mittels \fB\-\-cc\-addr\fR angegeben wurde. Dies ist
die Vorgabe.
.IP "\fB\-\-no\-use\-default\-cc\fR" 4
.IX Item "--no-use-default-cc"
fügt der Liste der Kopien keine in \fB\s-1BTS_DEFAULT_CC\s0\fR angegebenen Adressen
hinzu.
.IP "\fB\-\-sendmail=\fR\fISENDMAIL-BEFEHL\fR" 4
.IX Item "--sendmail=SENDMAIL-BEFEHL"
gibt den \fBsendmail\fR\-Befehl an. Der Befehl wird bei Leerzeichen getrennt und
nicht an eine Shell übergeben. Vorgabe ist \fI/usr/sbin/sendmail\fR. Die Option
\&\fB\-t\fR wird automatisch hinzugefügt, falls der Befehl \fI/usr/sbin/sendmail\fR
oder \fI/usr/sbin/exim*\fR lautet. Für andere E\-Mail-Programme muss dies, falls
sie eine \fB\-t\fR\-Option benötigen, in den \fISENDMAIL-BEFEHL\fR eingefügt werden,
zum Beispiel: \fB\-\-sendmail=\*(L"/usr/sbin/mymailer \-t\*(R"\fR.
.IP "\fB\-\-mutt\fR" 4
.IX Item "--mutt"
benutzt \fBmutt\fR für den Versand von E\-Mails. Standardmäßig wird \fBmutt\fR
nicht benutzt, außer für einige Befehle.
.Sp
Beachten Sie, dass \fB\f(CB$DEBEMAIL\fB\fR oder \fB\f(CB$EMAIL\fB\fR in der Umgebung gesetzt sein
müssen, um \fBmutt\fR zum Senden von E\-Mails zu verwenden.
.IP "\fB\-\-no\-mutt\fR" 4
.IX Item "--no-mutt"
benutzt \fBmutt\fR nicht für den Versand von E\-Mails.
.IP "\fB\-\-smtp\-host=\fR\fI\s-1SMTPHOST\s0\fR" 4
.IX Item "--smtp-host=SMTPHOST"
gibt einen SMTP-Rechner an. Falls angegeben wird \fBbts\fR E\-Mails versenden,
indem es direkt mit diesem Rechner kommuniziert, statt den
\&\fBsendmail\fR\-Befehl aufzurufen.
.Sp
Dem Rechnername könnte ein Doppelpunkt (»:«) und eine Port-Nummer folgen, um
einen anderen Port als den vorgegebenen zu benutzen, Er könnte außerdem mit
»ssmtp://« oder »ssmtps://« beginnen, um anzuzeigen, dass \s-1SMTPS\s0 benutzt
werden soll.
.Sp
Beachten Sie, dass \fB\f(CB$DEBEMAIL\fB\fR oder \fB\f(CB$EMAIL\fB\fR in der Umgebung gesetzt sein
müssen, um direkte SMTP-Verbindungen zum Senden von E\-Mails zu verwenden.
.Sp
Beachten Sie, wenn Sie direkt über einen SMTP-Rechner senden, dass die
Angabe von Adressen in \fB\-\-cc\-addr\fR oder \fB\s-1BTS_DEFAULT_CC\s0\fR, für die der
SMTP-Rechner keine Weiterleitung durchführt, dazu führt, dass der
SMTP-Rechner die ganze E\-Mail abweist.
.Sp
Beachten Sie außerdem, dass die Benutzung des Befehls \fBreassign\fR, wenn
entweder der Modus \fB\-\-interactive\fR oder \fB\-\-force\-interactive\fR aktiviert
ist, dazu führen kann, dass ein Cc an \fI\f(CI$newpackage\fI\fR\f(CW@packages\fR.debian.org
hinzugefügt wird. In diesen Fällen findet der Hinweis oben bezüglich
Weiterleitung Anwendung. Die Übertragungsschnittstelle (Port 587) auf
reportbug.debian.org unterstützt keine Weiterleitung und sollte als solche
nicht als SMTP-Server für \fBbts\fR unter den in diesem Absatz beschriebenen
Umständen genutzt werden.
.IP "\fB\-\-smtp\-username=\fR\fI\s-1BENUTZERNAME\s0\fR, \fB\-\-smtp\-password=\fR\fI\s-1PASSWORT\s0\fR" 4
.IX Item "--smtp-username=BENUTZERNAME, --smtp-password=PASSWORT"
gibt die Anmeldedaten an, die benutzt werden, wenn eine Verbindung zu dem
durch \fB\-\-smtp\-host\fR angegebenen SMTP-Server hergestellt wird. Falls der
Server keine Authentifizierung verlangt, dann sollten diese Optionen nicht
verwendet werden.
.Sp
Falls ein Benutzername aber kein Passwort angegeben wurde, wird \fBbts\fR vor
dem Senden der E\-Mail nach dem Passwort fragen.
.IP "\fB\-\-smtp\-helo=\fR\fI\s-1HELO\s0\fR" 4
.IX Item "--smtp-helo=HELO"
gibt den Namen an, der im Befehl \fI\s-1HELO\s0\fR benutzt wird, wenn eine Verbindung
zu dem SMTP-Server hergestellt wird; Vorgabe ist der Inhalt der Datei
\&\fI/etc/mailname\fR, falls sie existiert.
.Sp
Beachten Sie, dass einige STMP-Server die Benutzung eines \fI\s-1HELO\s0\fR
möglicherweise abweisen, die sie entweder nicht auflösen oder die nicht zum
benutzenden Rechner gehören.
.IP "\fB\-\-bts\-server\fR" 4
.IX Item "--bts-server"
benutzt einen anderen Debbugs-Server als bugs.debian.org.
.IP "\fB\-f\fR, \fB\-\-force\-refresh\fR" 4
.IX Item "-f, --force-refresh"
lädt einen Fehlerbericht erneut herunter, sogar dann, wenn er sich seit dem
letzten \fBcache\fR\-Befehl nicht geändert zu haben scheint; nützlich, falls ein
\&\fB\-\-cache\-mode=full\fR zum ersten Mal angefragt wurde (andernfalls werden
unveränderte Fehlerberichte nicht erneut heruntergeladen, nicht einmal, wenn
die langweiligen Teile nicht heruntergeladen wurden.
.IP "\fB\-\-no\-force\-refresh\fR" 4
.IX Item "--no-force-refresh"
unterdrückt jegliche \fB\-\-force\-refresh\fR\-Konfigurationsdateioptionen.
.IP "\fB\-\-only\-new\fR" 4
.IX Item "--only-new"
lädt nur neue Fehler beim Zwischenspeichern herunter; prüft nicht, ob es in
bereits vorhandenen Fehlern Aktualisierungen gibt.
.IP "\fB\-\-include\-resolved\fR" 4
.IX Item "--include-resolved"
wenn Fehlerberichte zwischengespeichert werden, die einbeziehen, die als
gelöst markiert sind. Dies ist das Standardverhalten.
.IP "\fB\-\-no\-include\-resolved\fR" 4
.IX Item "--no-include-resolved"
kehrt das Verhalten der vorherigen Option um. Sprich, Fehler, die als gelöst
markiert sind, werden nicht zwischengespeichert.
.IP "\fB\-\-no\-ack\fR" 4
.IX Item "--no-ack"
unterdrückt Bestätigungs\-E\-Mails vom \s-1BTS.\s0 Beachten Sie, dass dies nur die
CC-Kopien der Nachrichten beeinflusst, die Kopien für Fehler sind, die nicht
an das Steuerungsprogramm gesandt wurden.
.IP "\fB\-\-ack\fR" 4
.IX Item "--ack"
unterdrückt keine Bestätigungs\-E\-Mails. Dies ist das Standardverhalten.
.IP "\fB\-i\fR, \fB\-\-interactive\fR" 4
.IX Item "-i, --interactive"
zeigt vor dem Senden einer E\-Mail an das Steuerungsprogramm den Inhalt an
und ermöglicht, ihn zu bearbeiten oder das Versenden abzubrechen.
.IP "\fB\-\-force\-interactive\fR" 4
.IX Item "--force-interactive"
ähnlich wie \fB\-\-interactive\fR, mit der Ausnahme, dass sich ein Editor öffnet
bevor nach der Bestätigung gefragt wird, ob die Nachricht versandt werden
soll.
.IP "\fB\-\-no\-interactive\fR" 4
.IX Item "--no-interactive"
sendet Steuerungs-E-Mails ohne Bestätigung. Dies ist das Standardverhalten.
.IP "\fB\-q\fR, \fB\-\-quiet\fR" 4
.IX Item "-q, --quiet"
zeigt, wenn \fBbts cache\fR ausgeführt wird, nur Informationen über neu
zwischengespeicherte Seiten an, keine Nachrichten, die aussagen, was bereits
zwischengespeichert ist. Falls diese Option zweimal angegeben wurde, werden
nur Fehlermeldungen (an die Standardfehlerausgabe) ausgegeben.
.IP "\fB\-\-no\-conf\fR, \fB\-\-noconf\fR" 4
.IX Item "--no-conf, --noconf"
keine Konfigurationsdateien lesen, Dies kann nur als erste auf der
Befehlszeile angegebene Option benutzt werden.
.SH "BEFEHLE"
.IX Header "BEFEHLE"
Sämtliche Einzelheiten über die Befehle finden Sie in der
BTS-Dokumentation. <http://www.debian.org/Bugs/server\-control>
.IP "\fBshow\fR [\fIOptionen\fR] [\fIFehlernummer\fR | \fIPaket\fR | \fIPaketbetreuer\fR | \fB:\fR ] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4
.IX Item "show [Optionen] [Fehlernummer | Paket | Paketbetreuer | : ] [Opt=Wert …]"
.PD 0
.IP "\fBshow\fR [\fIOptionen\fR] [\fBsrc:\fR\fIPaket\fR | \fBfrom:\fR\fIAbsender\fR] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4
.IX Item "show [Optionen] [src:Paket | from:Absender] [Opt=Wert …]"
.IP "\fBshow\fR [\fIOptionen\fR] [\fBtag:\fR\fIMarkierung\fR | \fBusertag:\fR\fIMarkierung\fR ] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4
.IX Item "show [Optionen] [tag:Markierung | usertag:Markierung ] [Opt=Wert …]"
.IP "\fBshow\fR [\fBrelease-critical\fR | \fBrelease\-critical/\fR … | \fB\s-1RC\s0\fR]" 4
.IX Item "show [release-critical | release-critical/ … | RC]"
.PD
Dies ist ein Synonym für \fBbts bugs\fR.
.IP "\fBbugs\fR [\fIOptionen\fR] [\fIFehlernummer\fR | \fIPaket\fR | \fIPaketbetreuer\fR | \fB:\fR ] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4
.IX Item "bugs [Optionen] [Fehlernummer | Paket | Paketbetreuer | : ] [Opt=Wert …]"
.PD 0
.IP "\fBbugs\fR [\fIOptionen\fR] [\fBsrc:\fR\fIPaket\fR | \fBfrom:\fR\fIAbsender\fR] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4
.IX Item "bugs [Optionen] [src:Paket | from:Absender] [Opt=Wert …]"
.IP "\fBbugs\fR [\fIOptionen\fR] [\fBtag:\fR\fIMarkierung\fR | \fBusertag:\fR\fIMarkierung\fR ] [\fIOpt\fR\fB=\fR\fIWert\fR …]" 4
.IX Item "bugs [Optionen] [tag:Markierung | usertag:Markierung ] [Opt=Wert …]"
.IP "\fBbugs\fR [\fBrelease-critical\fR | \fBrelease\-critical/\fR … | \fB\s-1RC\s0\fR]" 4
.IX Item "bugs [release-critical | release-critical/ … | RC]"
.PD
zeigt die Seite, die die angefragten Fehler in einem Webbrowser auflistet,
unter Benutzung von \fIsensible\-browser\fR\|(1).
.Sp
Optionen könnten nach dem Befehl \fBbugs\fR zusätzlich oder anstelle von
Optionen am Anfang der Befehlszeile angegeben werden: An diesem Punkt
erkannte Optionen sind: \fB\-o\fR/\fB\-\-offline\fR/\fB\-\-online\fR, \fB\-m\fR/\fB\-\-mbox\fR,
\&\fB\-\-mailreader\fR und \fB\-\-\fR[\fBno\-\fR]\fBcache\fR. Diese wurden an früherer Stelle
in dieser Handbuchseite beschrieben. Falls Sie entweder die Option \fB\-o\fR
oder \fB\-\-offline\fR benutzt haben oder es bereits eine aktuelle Kopie des
lokalen Zwischenspeichers gibt, wird die zwischengespeicherte Version
benutzt.
.Sp
Die möglichen Argumente haben folgende Bedeutung:
.RS 4
.IP "(keins)" 8
.IX Item "(keins)"
Falls keins angegeben wurde, wird \fBbts bugs\fR Ihre Fehler unter der Annahme
anzeigen, dass entweder \fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR (in dieser Reihenfolge
geprüft) auf die geeignete E\-Mail-Adresse gesetzt ist.
.IP "\fIFehlernummer\fR" 8
.IX Item "Fehlernummer"
zeigt Fehler Nummer \fIFehlernummer\fR.
.IP "\fIPaket\fR" 8
.IX Item "Paket"
zeigt die Fehler des Pakets \fIPaket\fR.
.IP "\fBsrc:\fR\fIPaket\fR" 8
.IX Item "src:Paket"
zeigt die Fehler des Quellpakets \fIPaket\fR.
.IP "\fIPaketbetreuer\fR" 8
.IX Item "Paketbetreuer"
zeigt die Fehler für die Paketbetreuer-E-Mail-Adresse \fIPaketbetreuer\fR
.IP "\fBfrom:\fR\fIAbsender\fR" 8
.IX Item "from:Absender"
zeigt die Fehler für die Absender-E-Mail-Adresse \fIAbsender\fR
.IP "\fBtag:\fR\fIMarkierung\fR" 8
.IX Item "tag:Markierung"
zeigt die Fehler, die mit \fIMarkierung\fR gekennzeichnet sind.
.IP "\fBusertag:\fR\fIMarkierung\fR" 8
.IX Item "usertag:Markierung"
zeigt die Fehler, die mit der Benutzermarkierung \fIMarkierung\fR
gekennzeichnet sind. Weitere Informationen über Benutzermarkierungen finden
Sie in der BTS-Dokumentation. Dies wird die Verwendung der Option
\&\fBusers=\fR\fIE\-Mail\fR erfordern.
.IP "\fB:\fR" 8
.IX Item ":"
Einzelheiten der Fehlerdatenbank selbst können, neben einer Fehlermeldeseite
mit mehr Optionen als diesem Skript, unter http://bugs.debian.org/ gefunden
werden. Diese Seite selbst wird geöffnet, falls der Befehl »bts bugs :«
benutzt wird.
.IP "\fBrelease-critical\fR, \fB\s-1RC\s0\fR" 8
.IX Item "release-critical, RC"
zeigt die Einstiegssseite der release-kritischen Seiten des \s-1BTS.\s0 Dies ist
ein Synonym für http://bugs.debian.org/release\-critical/index.html. Es ist
außerdem möglich, release\-critical/debian/main.html und dergleichen zu
sagen. \s-1RC\s0 ist ein Synonym für release\-critical/other/all.html.
.RE
.RS 4
.Sp
Nach dem Argument, das spezifiziert, was angezeigt wird, können Sie
wahlweise Optionen angeben, um die Seite zu formatieren oder um zu ändern,
was angezeigt wird. Diese werden in der heruntergeladenen \s-1URL\s0 an das \s-1BTS\s0
übergeben. Übergeben Sie zum Beispiel »dist=stable«, um Fehler zu sehen, die
die stabile Version des Pakets beeinflussen, »version=1.0«, um Fehler zu
sehen, die diese Version des Pakets beeinflussen oder »reverse=yes«, um die
neusten Nachrichten im Fehlerprotokoll zuerst zu sehen.
.Sp
Falls Zwischenspeicherung aktiviert wurde (sprich \fB\-\-no\-cache\fR wurde nicht
benutzt und \fB\s-1BTS_CACHE\s0\fR wurde nicht auf \fBno\fR gesetzt), dann wird
automatisch jede durch \fBbts show\fR angeforderte Seite zwischengespeichert
und danach offline verfügbar sein. Seiten, die automatisch auf diese Weise
zwischengespeichert wurden, werden bei nachfolgenden Aufrufen von »\fBbts
show\fR|\fBbugs\fR|\fBcache\fR« gelöscht, falls nicht innerhalb von 30 Tagen darauf
zugegriffen wurde. Warnung: Auf einem Dateisystem, das mit der Option
»noatime« eingehängt wurde, aktualisiert die Ausführung von »\fBbts
show\fR|\fBbugs\fR« nicht die Zugriffszeiten der Zwischenspeicherdateien; ein
zwischengespeicherter Fehler wird dann Gegenstand der automatischen
Bereinigung 30 Tage nach seinem anfänglichen Herunterladen, sogar dann, wenn
auf ihn in der Zwischenzeit zugegriffen wurde.
.Sp
Alle anderen \fBbts\fR\-Befehle, die dieser Befehlszeile folgen, werden nach dem
Beenden des Browsers ausgeführt.
.Sp
Der gewünschte Browser kann durch Setzen der Umgebungsvariable \fB\s-1BROWSER\s0\fR
angegeben und konfiguriert werden. Die Konventionen folgen denen, die Eric
Raymond auf http://www.catb.org/~esr/BROWSER/ definiert hat; hier wird der
maßgebliche Teil wiedergegeben.
.Sp
Der Wert von \fB\s-1BROWSER\s0\fR kann aus einer Reihe von durch Doppelpunkt
getrennten Browser-Befehlsteilen bestehen. Diese sollten nacheinander
durchprobiert werden, bis einer erfolgreich ist. Jeder Befehlsteil kann
optional die Zeichenkette \fB\f(CB%s\fB\fR enthalten; ist dies der Fall, wird die \s-1URL,\s0
die betrachtet werden soll, dort ersetzt. Falls der Befehlsteil kein \fB\f(CB%s\fB\fR
enthält, wird der Browser gestartet, als ob die \s-1URL\s0 als sein erstes Argument
bereitgestellt worden wäre. Die Zeichenkette \fB%%\fR muss durch ein einzelnes
% ersetzt werden.
.Sp
Begründung: Es muss möglich sein, mehrere Browser-Befehle anzugeben, damit
Programme, die dieser Konvention folgen, in X\- oder Konsolenumgebungen das
Richtige tun können. Dabei wird X zuerst probiert. Die Angabe mehrerer
Befehle kann außerdem für Leute nützlich sein, die Dateien wie \fI.profile\fR
über mehrere Systeme hinweg gemeinsam benutzen. \fB\f(CB%s\fB\fR wird benötigt, da
einige populäre Browser eine Aufrufsyntax aus der Ferne haben, die dies
erfordern. Falls \fB%%\fR nicht auf % verkürzt würde, wäre es unmöglich, ein
Buchstabensymbol \fB\f(CB%s\fB\fR in der Zeichenkette zu haben.
.Sp
Auf den meisten Linux-Systemen wäre zum Beispiel Folgendes ein gute Sache:
.Sp
BROWSER='mozilla \-raise \-remote \*(L"openURL(%s,new\-window)\*(R":links'
.RE
.IP "\fBselect\fR [\fISchlüssel\fR\fB:\fR\fIWert\fR …]" 4
.IX Item "select [Schlüssel:Wert …]"
benutzt die SOAP-Schnittstelle, um eine Liste von Fehlern auszugeben, die zu
den gegebenen Auswahlanforderungen passen.
.Sp
Die folgenden Schlüssel sind erlaubt und können mehrmals abgegeben werden.
.RS 4
.IP "\fBpackage\fR" 8
.IX Item "package"
Name des Binärpakets
.IP "\fBsource\fR" 8
.IX Item "source"
Name des Quellpakets
.IP "\fBmaintainer\fR" 8
.IX Item "maintainer"
E\-Mail-Adresse des Paketbetreuers
.IP "\fBsubmitter\fR" 8
.IX Item "submitter"
E\-Mail-Adresse des Absenders
.IP "\fBseverity\fR" 8
.IX Item "severity"
Schweregrad des Fehlers
.IP "\fBstatus\fR" 8
.IX Item "status"
Status des Fehlers; entweder \fBopen\fR, \fBdone\fR oder \fBforwarded\fR
.IP "\fBtag\fR" 8
.IX Item "tag"
auf den Fehler bezogene Markierungen. Falls \fBusers\fR angegeben ist, könnten
zusätzlich zu den Standardmarkierungen Benutzermarkierungen enthalten sein.
.IP "\fBowner\fR" 8
.IX Item "owner"
Besitzer des Fehlers
.IP "\fBcorrespondent\fR" 8
.IX Item "correspondent"
Adresse von jemandem, der E\-Mail an das Protokoll sandte
.IP "\fBaffects\fR" 8
.IX Item "affects"
Fehler, die dieses Paket beeinflussen
.IP "\fBbugs\fR" 8
.IX Item "bugs"
Liste von Fehlern, in der gesucht wird
.IP "\fBusers\fR" 8
.IX Item "users"
Namen von Anwendern, die beim Abfragen von Benutzermarkierungen benutzt
werden
.IP "\fBarchive\fR" 8
.IX Item "archive"
gibt an, ob archivierte oder normale Fehler gesucht werden; Vorgabe ist \fB0\fR
(d.h. nur normale Fehler werden gesucht). Als Sonderfall werden, falls
»archive« \fBboth\fR ist, archivierte und nicht archivierte Fehler
zurückgegeben.
.RE
.RS 4
.Sp
Um zum Beispiel die Sammlung von Fehlern auszuwählen, die von
jrandomdeveloper@example.com versandt und mit \fBwontfix\fR markiert würde,
könnte Folgendes benutzt werden:
.Sp
bts select submitter:jrandomdeveloper@example.com tag:wontfix
.Sp
Falls ein Schlüssel mehrfach benutzt wird, dann enthält die ausgewählte
Fehlerzusammenstellung jene, die auf einen der bereitgestellten Werte
passen, zum Beispiel gibt
.Sp
bts select package:foo severity:wishlist severity:minor
.Sp
alle Fehler des Pakets Foo zurück, die entweder den Schweregrad »wishlist«
oder »minor« haben.
.RE
.IP "\fBstatus\fR [\fIFehler\fR | \fBfile:\fR\fIDatei\fR | \fBfields:\fR\fIFeld\fR[\fB,\fR\fIFeld\fR …] | \fBverbose\fR] …" 4
.IX Item "status [Fehler | file:Datei | fields:Feld[,Feld …] | verbose] …"
benutzt die SOAP-Schnittstelle, um Informationen über die angegebenen Fehler
auszugeben (oder die, die aus den aufgelisteten Dateien gelesen wurden –
verwenden Sie \fB\-\fR, um die Standardeingabe auszuwählen).
.Sp
Standardmäßig werden alle ausgefüllten Felder für einen Fehler angezeigt.
.Sp
Falls \fBverbose\fR angegeben ist, werden außerdem leere Felder angezeigt.
.Sp
Falls \fBfields\fR angegeben ist, werden nur diese Felder angezeigt. Es wird
keine Gültigkeitsprüfung für irgendwelche angegebenen Felder durchgeführt.
.IP "\fBclone\fR \fIFehler\fR \fIneue_Kennung\fR [\fIneue_Kennung\fR …]" 4
.IX Item "clone Fehler neue_Kennung [neue_Kennung …]"
Der Steuerbefehl \fBclone\fR ermöglicht es Ihnen, einen \fIFehler\fRbericht zu
kopieren. Das ist in dem Fall nützlich, in dem ein einziger Bericht
tatsächlich anzeigt, dass mehrere eigenständige Fehler aufgetreten
sind. »Neue Kennungen« sind durch Leerzeichen getrennte negative Zahlen, die
in nachfolgenden Steuerbefehlen benutzt werden können, um auf die neu
kopierten Fehler Bezug zu nehmen. Für jede neue Kennung wird ein neuer
Fehler erzeugt.
.IP "\fBdone\fR \fIFehler\fR [\fIVersion\fR]" 4
.IX Item "done Fehler [Version]"
markiert einen Fehler als erledigt. Dies erzwingt einen interaktiven Modus,
da erledigt-Nachrichten eine Erklärung enthalten sollten, weshalb der Fehler
geschlossen wird. Sie sollten angeben, welche Version des Pakets den Fehler
schließt, falls möglich.
.IP "\fBreopen\fR \fIFehler\fR [\fIAbsender\fR]" 4
.IX Item "reopen Fehler [Absender]"
öffnet einen \fIFehler\fR mit optionalem \fIAbsender\fR erneut.
.IP "\fBarchive\fR \fIFehler\fR" 4
.IX Item "archive Fehler"
archiviert einen \fIFehler\fR, der vorher archiviert war, es gegenwärtig aber
nicht ist. Der \fIFehler\fR muss alle Anforderungen für die Archivierung außer
den zeitbasierten erfüllen.
.IP "\fBunarchive\fR \fIFehler\fR" 4
.IX Item "unarchive Fehler"
nimmt einen derzeit archivierten \fIFehler\fR aus dem Archiv heraus.
.IP "\fBretitle\fR \fIFehler\fR \fITitel\fR" 4
.IX Item "retitle Fehler Titel"
ändert den \fITitel\fR des \fIFehler\fRs.
.IP "\fBsummary\fR \fIFehler\fR [\fINachrichtennummer\fR]" 4
.IX Item "summary Fehler [Nachrichtennummer]"
wählt eine Nachrichtennummer, die als Zusammenfassung von \fIFehler\fR benutzt
werden soll.
.Sp
Falls keine Nachrichtennummer angegeben ist, wird die Zusammenfassung
geleert.
.IP "\fBsubmitter\fR \fIFehler\fR [\fIFehler\fR] … \fIAbsender-E-Mail-Adresse\fR" 4
.IX Item "submitter Fehler [Fehler] … Absender-E-Mail-Adresse"
ändert die Adresse des Einreichenden eines \fIFehler\fRs oder einer Reihe von
Fehlern. \fB!\fR bedeutet »die Adresse der aktuellen E\-Mail als neue Adresse
des Einreichenden verwenden«.
.IP "\fBreassign\fR \fIFehler\fR [\fIFehler\fR …] \fIPaket\fR [\fIVersion\fR]" 4
.IX Item "reassign Fehler [Fehler …] Paket [Version]"
weist einem \fIFehler\fR oder einer Reihe von Fehlern einem anderen \fIPaket\fR
zu. Das Feld \fIVersion\fR ist optional; lesen Sie die Erklärung auf
<http://www.debian.org/Bugs/server\-control>.
.IP "\fBfound\fR \fIFehler\fR [\fIVersion\fR]" 4
.IX Item "found Fehler [Version]"
Indicate that a \fIbug\fR was found to exist in a particular package version.
Without \fIversion\fR, the list of fixed versions is cleared and the bug is
reopened.
.IP "\fBnotfound\fR \fIFehler\fR \fIVersion\fR" 4
.IX Item "notfound Fehler Version"
entfernt den Datensatz, mit dem \fIFehler\fR in der gegebenen Version des
Pakets, dem er zugewiesen ist, vorgefunden wurde.
.IP "\fBfixed\fR \fIFehler\fR \fIVersion\fR" 4
.IX Item "fixed Fehler Version"
zeigt an, dass ein \fIFehler\fR in einer bestimmten Paketversion behoben wurde
ohne den Offen\-/Geschlossenstatus des \fIFehler\fRs zu beeinflussen.
.IP "\fBnotfixed\fR \fIFehler\fR \fIVersion\fR" 4
.IX Item "notfixed Fehler Version"
entfernt den Datensatz mit dem ein \fIFehler\fR in der gegebenen Version des
Pakets, dem er zugewiesen ist, behoben wurde.
.Sp
Dies ist gleichbedeutend mit der Abfolge der Befehle »\fBfound\fR \fIFehler\fR
\&\fIVersion\fR«, »\fBnotfound\fR \fIFehler\fR \fIVersion\fR«.
.IP "\fBblock\fR \fIFehler\fR \fBby\fR|\fBwith\fR \fIFehler\fR [\fIFehler\fR …]" 4
.IX Item "block Fehler by|with Fehler [Fehler …]"
weist darauf hin, dass ein \fIFehler\fR von der Behebung durch einen Satz
anderer Fehler blockiert ist.
.IP "\fBunblock\fR \fIFehler\fR \fBby\fR|\fBwith\fR \fIFehler\fR [\fIFehler\fR …]" 4
.IX Item "unblock Fehler by|with Fehler [Fehler …]"
weist darauf hin, dass ein \fIFehler\fR nicht länger von der Behebung durch
einen Satz anderer Fehler blockiert ist.
.IP "\fBmerge\fR \fIFehler\fR \fIFehler\fR [\fIFehler\fR …]" 4
.IX Item "merge Fehler Fehler [Fehler …]"
fügt einen Satz Fehler zusammen.
.IP "\fBforcemerge\fR \fIFehler\fR \fIFehler\fR [\fIFehler\fR …]" 4
.IX Item "forcemerge Fehler Fehler [Fehler …]"
fügt einen Satz Fehler mit Gewalt zusammen. Der erste aufgeführte \fIFehler\fR
ist der Hauptfehler und seine Einstellungen (diejenigen, die denen in einem
normalen \fBmerge\fR entsprechen müssen) werden den nachfolgend aufgeführten
Fehlern zugewiesen.
.IP "\fBunmerge\fR \fIFehler\fR" 4
.IX Item "unmerge Fehler"
macht das Zusammenführen eines \fIFehler\fRs rückgängig.
.IP "\fBtag\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIMarkierung\fR [\fIMarkierung\fR …]" 4
.IX Item "tag Fehler [+|-|=] Markierung [Markierung …]"
.PD 0
.IP "\fBtags\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIMarkierung\fR [\fIMarkierung\fR …]" 4
.IX Item "tags Fehler [+|-|=] Markierung [Markierung …]"
.PD
setzt oder entfernt eine \fIMarkierung\fR für einen \fIFehler\fR. Die Markierung
kann entweder der exakte Markierungsname sein oder er kann auf eine
eindeutige Teilzeichenkette abgekürzt werden. (Daher wird \fBfixed\fR
beispielsweise die Markierung \fBfixed\fR, nicht \fBfixed-upstream\fR setzen, aber
\&\fBfix\fR wäre nicht zulässig.) Mehrere Markierungen können ebenfalls angegeben
werden. Die beiden Befehle (»tag« und »tags«) sind identisch. Wenn der
Schalter \fB=\fR nicht benutzt wird, muss mindestens eine Markierung angegeben
werden, wobei der Befehl
.Sp
.Vb 1
\&  bts tags <Fehler> =
.Ve
.Sp
alle Markierungen vom angegebenen \fIFehler\fR entfernen wird.
.Sp
Als Sonderfall wird die inoffizielle Markierung \fBgift\fR zusätzlich zu den
offiziellen Markierungsnamen unterstützt. \fBgift\fR wird als Kurzschrift für
die Benutzermarkierung \fBgift\fR verwendet; siehe
<http://wiki.debian.org/qa.debian.org/GiftTag>. Entfernen/Hinzufügen der
Markierung \fBgift\fR wird die Benutzermarkierung \fBgift\fR entfernen/hinzufügen,
die zum Benutzer »debian\-qa@lists.debian.org« gehört.
.Sp
Adding/removing the \fBsecurity\fR tag will add \*(L"team\e@security.debian.org\*(R" to
the Cc list of the control email.
.IP "\fBaffects\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIPaket\fR [\fIPaket\fR …]" 4
.IX Item "affects Fehler [+|-|=] Paket [Paket …]"
zeigt an, dass ein \fIFehler\fR ein anderes \fIPaket\fR betrifft, als das, gegen
das er eingereicht wurde, was dazu führt, dass der \fIFehler\fR standardmäßig
in der \fIPaket\fRliste des anderen Pakets aufgeführt wird. Dies sollte
üblicherweise benutzt werden, wo der \fIFehler\fR ernst genug ist, um mehrere
Berichte von Benutzern dem falschen Paket zuzuweisen. Es muss mindestens ein
\&\fIPaket\fR angegeben werden, sogar, wenn der Schalter \fB=\fR benutzt wird, wobei
der Befehl
.Sp
.Vb 1
\&  bts affects <Fehler> =
.Ve
.Sp
alle Hinweise entfernt, dass \fIFehler\fR andere Pakete beeinflusst.
.IP "\fBuser\fR \fIE\-Mail-Adresse\fR" 4
.IX Item "user E-Mail-Adresse"
gibt eine Benutzer\-\fIE\-Mail\fR\-Adresse an, bevor der Befehl \fBusertags\fR
verwendet wird.
.IP "\fBusertag\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIMarkierung\fR [\fIMarkierung\fR …]" 4
.IX Item "usertag Fehler [+|-|=] Markierung [Markierung …]"
.PD 0
.IP "\fBusertags\fR \fIFehler\fR [\fB+\fR|\fB\-\fR|\fB=\fR] \fIMarkierung\fR [\fIMarkierung\fR …]" 4
.IX Item "usertags Fehler [+|-|=] Markierung [Markierung …]"
.PD
setzt oder entfernt eine Benutzermarkierung für einen \fIFehler\fR. Die
\&\fIMarkierung\fR muss exakt den gewünschten Markierungsnamen haben; es gibt
dort keine Vorgaben oder Prüfungen von Markierungsnamen. Mehrere
Markierungen können ebenfalls angegeben werden. Die beiden Befehle
(\fBusertag\fR und \fBusertags\fR) sind identisch. Wenn der Schalter \fB=\fR nicht
benutzt wird, muss mindestens eine Markierung angegeben werden, wobei der
Befehl
.Sp
.Vb 1
\&  bts usertags <Fehler> =
.Ve
.Sp
alle Benutzermarkierungen vom angegebenen \fIFehler\fR entfernt.
.IP "\fBclaim\fR \fIFehler\fR [\fIAnspruch\fR]" 4
.IX Item "claim Fehler [Anspruch]"
zeichnet auf, dass Sie Anspruch auf einen Fehler erheben (z.B. für ein
Fehlerbearbeitungstreffen, eine »Bug Squashing Party«). \fIAnspruch\fR sollte
ein eindeutiges Kürzel sein, das es ermöglicht, die Fehler, auf die Sie
Anspruch erheben, zu identifizieren; oft wird eine E\-Mail-Adresse benutzt.
.Sp
Falls kein \fIAnspruch\fR angegeben wurde, wird die Umgebungsvariable
\&\fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR (in dieser Reihenfolge geprüft) benutzt.
.IP "\fBunclaim\fR \fIFehler\fR [\fIAnspruch\fR]" 4
.IX Item "unclaim Fehler [Anspruch]"
entfernt den Datensatz, mit dem Sie Anspruch auf einen Fehler erheben.
.Sp
Falls kein \fIAnspruch\fR angegeben wurde, wird die Umgebungsvariable
\&\fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR (in dieser Reihenfolge geprüft) benutzt.
.IP "\fBseverity\fR \fIFehler\fR \fISchweregrad\fR" 4
.IX Item "severity Fehler Schweregrad"
ändert den \fISchweregrad\fR eines \fIFehler\fRs. Verfügbare Schweregrade sind:
\&\fBwishlist\fR, \fBminor\fR, \fBnormal\fR, \fBimportant\fR, \fBserious\fR, \fBgrave\fR und
\&\fBcritical\fR. Der Schweregrad kann auf irgendeine eindeutige Teilzeichenkette
abgekürzt werden.
.IP "\fBforwarded\fR \fIFehler\fR \fIAdresse\fR" 4
.IX Item "forwarded Fehler Adresse"
markiert den \fIFehler\fR als an die angegebene \fIAdresse\fR weitergeleitet
(üblicherweise eine E\-Mail-Adresse oder eine \s-1URL\s0 für eine Fehlerdatenbank
der Originalautoren).
.IP "\fBnotforwarded\fR \fIFehler\fR" 4
.IX Item "notforwarded Fehler"
markiert einen \fIFehler\fR als nicht weitergeleitet.
.IP "\fBpackage\fR [\fIPaket\fR …]" 4
.IX Item "package [Paket …]"
Die folgenden Befehle werden nur auf Fehler gegen die aufgeführten \fIPaket\fRe
angewandt; dies dient als Sicherheitsmechanismus für die
Fehlerdatenbank. Falls keine Pakete aufgeführt sind, wird die Prüfung wieder
ausgeschaltet.
.IP "\fBlimit\fR [\fISchlüssel\fR[\fB:\fR\fIWert\fR]] …" 4
.IX Item "limit [Schlüssel[:Wert]] …"
Die folgenden Befehle werden nur auf Fehler angewandt, die dem angegebenen
Kriterium entsprechen; dies dient als Sicherheitsmechanismus für die
Fehlerdatenbank. Falls keine \fIWert\fRe aufgeführt sind, werden die
Beschränkungen für diesen \fISchlüssel\fR wieder ausgeschaltet. Falls keine
\&\fISchlüssel\fR angegeben wurden, werden alle Beschränkungen zurückgesetzt.
.RS 4
.IP "\fBsubmitter\fR" 8
.IX Item "submitter"
E\-Mail-Adresse des Absenders
.IP "\fBdate\fR" 8
.IX Item "date"
Datum, an dem der Fehler versandt wurde
.IP "\fBsubject\fR" 8
.IX Item "subject"
Betreff dieses Fehlers
.IP "\fBmsgid\fR" 8
.IX Item "msgid"
Nachrichtenkennung des anfänglichen Fehlerberichts
.IP "\fBpackage\fR" 8
.IX Item "package"
Name des Binärpakets
.IP "\fBsource\fR" 8
.IX Item "source"
Name des Quellpakets
.IP "\fBtag\fR" 8
.IX Item "tag"
auf den Fehler bezogene Markierungen
.IP "\fBseverity\fR" 8
.IX Item "severity"
Schweregrad des Fehlers
.IP "\fBowner\fR" 8
.IX Item "owner"
Besitzer des Fehlers
.IP "\fBaffects\fR" 8
.IX Item "affects"
Fehler, die dieses Paket beeinflussen
.IP "\fBarchive\fR" 8
.IX Item "archive"
gibt an, ob archivierte oder normale Fehler gesucht werden; Vorgabe ist \fB0\fR
(d.h. nur normale Fehler werden gesucht). Als Sonderfall werden, falls
»archive« \fBboth\fR ist, archivierte und nicht archivierte Fehler
zurückgegeben.
.RE
.RS 4
.Sp
Um zum Beispiel die Zusammenstellung von Fehlern, die von nachfolgenden
Steuerbefehlen beeinflusst werden, auf diejenigen zu beschränken, die von
jrandomdeveloper@example.com versandt und mit \fBwontfix\fR markiert wurden,
könnte Folgendes verwendet werden:
.Sp
bts limit submitter:jrandomdeveloper@example.com tag:wontfix
.Sp
Falls ein Schlüssel mehrfach benutzt wird, dann enthält die ausgewählte
Fehlerzusammenstellung jene, die auf einen der bereitgestellten Werte
passen, zum Beispiel gibt
.Sp
bts limit package:foo severity:wishlist severity:minor
.Sp
wird nur auf nachfolgende Steuerbefehle für Fehler des Pakets Foo angewandt,
die entweder den Schweregrad \fBwishlist\fR oder \fBminor\fR aufweisen.
.RE
.IP "\fBowner\fR \fIFehler\fR \fIBesitzer-E-Mail-Adresse\fR" 4
.IX Item "owner Fehler Besitzer-E-Mail-Adresse"
ändert die »Besitzer«\-Adresse eines \fIFehler\fRs, wobei \fB!\fR »benutze die
Adresse der aktuellen E\-Mail als neue Besitzeradresse« bedeutet.
.Sp
Der Besitzer eines Fehlers akzeptiert die Verantwortung, ihn zu erledigen.
.IP "\fBnoowner\fR \fIFehler\fR" 4
.IX Item "noowner Fehler"
markiert, dass ein Fehler keinen »Besitzer« hat.
.IP "\fBsubscribe\fR \fIFehler\fR [\fIE\-Mail\fR]" 4
.IX Item "subscribe Fehler [E-Mail]"
abonniert die gegebene \fIE\-Mail\fR\-Adresse für den angegebenen
\&\fIFehler\fR. Falls keine E\-Mail-Adresse angegeben wurde, wird die
Umgebungsvariable \fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR (in dieser Reihenfolge)
benutzt. Falls diese nicht gesetzt sind oder \fB!\fR als E\-Mail-Adresse
angegeben ist, wird Ihre Standard-E-Mail-Adresse verwendet.
.Sp
Nach der Ausführung dieses Befehls wird ihnen eine Abonnement\-Bestätigung
gesandt, auf die Sie antworten müssen. Wenn Sie einen Fehlerbericht
abonniert haben, erhalten Sie alle relevanten E\-Mails und
Benachrichtigungen, Benutzen Sie den Befehl unsubscribe, um das Abonnement
zu beenden.
.IP "\fBunsubscribe\fR \fIFehler\fR [\fIE\-Mail\fR]" 4
.IX Item "unsubscribe Fehler [E-Mail]"
beendet das Abonnement der angegebenen E\-Mail-Adresse für den angegebenen
Fehlerbericht. Wie beim vorhergehenden Abonnieren werden, falls keine
E\-Mail-Adresse angegeben wurde, die Umgebungsvariablen \fB\s-1DEBEMAIL\s0\fR oder
\&\fB\s-1EMAIL\s0\fR (in dieser Reihenfolge) benutzt. Falls diese nicht gesetzt sind
oder \fB!\fR als E\-Mail-Adresse angegeben ist, wird Ihre
Standard-E-Mail-Adresse verwendet.
.Sp
Nach der Ausführung dieses Befehls wird Ihnen eine Bestätigung für das
Beenden des Abonnements gesandt, auf die Sie antworten müssen. Benutzen Sie
zum Abonnieren den Befehl \fBsubscribe\fR.
.IP "\fBreportspam\fR \fIFehler\fR …" 4
.IX Item "reportspam Fehler …"
Der Befehl \fBreportspam\fR ermöglicht es Ihnen, zu melden, dass ein
\&\fIFehler\fRbericht Spam enthält. Er bewahrt davor, auf die Fehler-Website
gehen zu müssen, um dies zu tun.
.IP "\fBspamreport\fR \fIFehler\fR …" 4
.IX Item "spamreport Fehler …"
\&\fBspamreport\fR ist ein Synonym für \fBreportspam\fR.
.IP "\fBcache\fR [\fIOptionen\fR] [\fIBetreuer-E-Mail-Adresse\fR | \fIPaket\fR | \fBsrc:\fR\fIPaket\fR | \fBfrom:\fR\fIAbsender\fR]" 4
.IX Item "cache [Optionen] [Betreuer-E-Mail-Adresse | Paket | src:Paket | from:Absender]"
.PD 0
.IP "\fBcache\fR [\fIOptionen\fR] [\fBrelease-critical\fR | \fBrelease\-critical/\fR … | \fB\s-1RC\s0\fR]" 4
.IX Item "cache [Optionen] [release-critical | release-critical/ … | RC]"
.PD
erzeugt oder aktualisiert einen Zwischenspeicher von Fehlerberichten für die
gegebene E\-Mail-Adresse oder das gegebene Paket. Standardmäßig lädt es alle
Fehler herunter, die zu der E\-Mail-Adresse in der Umgebungsvariable
\&\fB\s-1DEBEMAIL\s0\fR gehören (oder der Umgebungsvariable \fB\s-1EMAIL\s0\fR, falls \fB\s-1DEBEMAIL\s0\fR
nicht gesetzt ist). Dieser Befehl kann wiederholt werden, um Fehler
zwischenzuspeichern, die zu mehreren Leuten oder Paketen gehören. Falls
mehrere Pakete oder Adressen mitgegeben werden, werden Fehler
zwischengespeichert, die zu allen Argumenten gehören; diejenigen, die zu
mehr als einem Argument gehören, werden nur einmal heruntergeladen. Die
zwischengespeicherten Fehler werden in \fI~/.devscripts_cache/bts/\fR
gespeichert.
.Sp
Sie können die zwischengespeicherten Fehler mit dem Schalter \fB\-o\fR
verwenden. Zum Beispiel:
.Sp
.Vb 2
\&  bts \-o bugs
\&  bts \-o show 12345
.Ve
.Sp
Außerdem wird \fBbts\fR die Dateien darin auf unsystematische Weise
aktualisieren, da es Informationen von der Fehlerdatenbank unter Benutzung
des Befehls \fBshow\fR herunterlädt. Sie könnten daher den Zwischenspeicher
einrichten, indem Sie die automatischen Zwischenspeicheraktualisierungen die
Fehler aktualisieren lassen, auf die Sie häufig während der Woche Bezug
nehmen.
.Sp
Einige Optionen beeinflussen das Verhalten des Befehls \fBcache\fR. Die erste
ist die Einstellung von \fB\-\-cache\-mode\fR, die steuert, wieviel \fBbts\fR von den
referenzierten Verweisen von der Fehlerseite herunterlädt, einschließlich
langweiliger Teile, wie den Bestätigungs\-E\-Mails, E\-Mails an den Steuer-Bot
und der Mbox-Version des Fehlerberichts. Sie kann drei Werte annehmen:
\&\fBmin\fR (das Minimum), \fBmbox\fR (das Minimum plus der Mbox-Version des
Fehlerberichts herunterladen) oder \fBfull\fR (alles). Die zweite ist
\&\fB\-\-force\-refresh\fR oder \fB\-f\fR. Sie erzwingt das Herunterladen sogar dann,
wenn der zwischengespeicherte Fehler aktuell ist. Die Option
\&\fB\-\-include\-resolved\fR zeigt an, ob Fehlerberichte, die als behoben markiert
sind, während des Zwischenspeicherns heruntergeladen werden sollen.
.Sp
Jedes davon ist, wie nachfolgend beschrieben, in der Konfigurationsdatei
einstellbar. Dies könnte außerdem nach dem Befehl \fBcache\fR, ebenso wie am
Anfang der Befehlszeile angegeben werden.
.Sp
Schlussendlich wird \fB\-q\fR oder \fB\-\-quiet\fR Nachrichten darüber, ob der
Zwischenspeicher aktuell ist, unterdrücken. Wird diese Option zweimal
angegeben, werden alle Zwischenspeichernachrichten (mit Ausnahme von
Fehlermeldungen) unterdrückt.
.Sp
Vorsicht allerdings beim Zwischenspeichern von RC-Fehlern: Es wird \s-1LANGE\s0
dauern! (Mit über 1000 RC-Fehlern und einer Verzögerung von fünf Sekunden
zwischen Fehlern, sehen Sie sich mindestens 1,5 Stunden und wahrscheinlich
bedeutend mehr als dem gegenüber.)
.IP "\fBcleancache\fR \fIPaket\fR | \fBsrc:\fR\fIPaket\fR | \fIPaketbetreuer\fR" 4
.IX Item "cleancache Paket | src:Paket | Paketbetreuer"
.PD 0
.IP "\fBcleancache from:\fR\fIAbsender\fR | \fBtag:\fR\fIMarkierung\fR | \fBusertag:\fR\fIMarkierung\fR | \fIZahl\fR | \fB\s-1ALL\s0\fR" 4
.IX Item "cleancache from:Absender | tag:Markierung | usertag:Markierung | Zahl | ALL"
.PD
bereinigt den Zwischenspeicher für das angegebene \fIPaket\fR, den
\&\fIPaketbetreuer\fR. etc., wie oben für den Befehl \fBbugs\fR beschrieben oder
bereinigt den kompletten Zwischenspeicher, falls \fB\s-1ALL\s0\fR angegeben
wurde. Dies ist nützlich, falls Sie einen permanenten Netzwerkzugang haben
oder falls Ihre Datenbank aus irgend einem Grund beschädigt wurde. Beachten
Sie, dass dieser Befehl aus Sicherheitsgründen nicht standardmäßig den Wert
\&\fB\s-1DEBEMAIL\s0\fR oder \fB\s-1EMAIL\s0\fR hat.
.IP "\fBversion\fR" 4
.IX Item "version"
zeigt Version und Copyright-Information an.
.IP "\fBhelp\fR" 4
.IX Item "help"
zeigt eine kurze Zusammenfassung der Befehle, verdächtig ähnlich zu Teilen
dieser Handbuchseite.
.SH "UMGEBUNGSVARIABLEN"
.IX Header "UMGEBUNGSVARIABLEN"
.IP "\fB\s-1DEBEMAIL\s0\fR" 4
.IX Item "DEBEMAIL"
Falls diese gesetzt ist, wird die Von:\-Zeile in der E\-Mail gesetzt, um diese
E\-Mail-Adresse anstelle Ihrer normalen E\-Mail-Adresse zu benutzen (als wäre
sie durch \fBmail\fR festgelegt).
.IP "\fB\s-1DEBFULLNAME\s0\fR" 4
.IX Item "DEBFULLNAME"
Falls \fB\s-1DEBEMAIL\s0\fR gesetzt ist, wird \fB\s-1DEBFULLNAME\s0\fR geprüft, um den
vollständigen Namen, der verwendet wird, zu bestimmen; falls dies nicht
gesetzt ist, versucht \fBbts\fR einen Namen von Ihrem \fIpasswd\fR\-Eintrag zu
bestimmen.
.IP "\fB\s-1BROWSER\s0\fR" 4
.IX Item "BROWSER"
Falls gesetzt, gibt es den Browser an, der für die Optionen \fBshow\fR und
\&\fBbugs\fR verwendet wird. Lesen Sie die vorhergehende Beschreibung.
.SH "KONFIGURATIONSVARIABLEN"
.IX Header "KONFIGURATIONSVARIABLEN"
Die beiden Konfigurationsdateien \fI/etc/devscripts.conf\fR und
\&\fI~/.devscripts\fR werden in dieser Reihenfolge durch eine Shell eingelesen,
um Konfigurationsvariablen zu setzen. Befehlszeilenoptionen können benutzt
werden, um Einstellungen aus Konfigurationsdateien außer Kraft zu
setzen. Einstellungen aus Umgebungsvariablen werden zu diesem Zweck
ignoriert. Die derzeit bekannten Variablen sind:
.IP "\fB\s-1BTS_OFFLINE\s0\fR" 4
.IX Item "BTS_OFFLINE"
Falls dies auf \fByes\fR gesetzt ist, dann ist es genauso, als wenn der
Befehlszeilenparameter \fB\-\-offline\fR benutzt würde. Es hat nur Auswirkungen
auf die Befehle \fBshow\fR und \fBbugs\fR. Vorgabe ist \fBno\fR. Weitere
Informationen finden Sie in der vorhergehenden Beschreibung des Befehls
\&\fBshow\fR.
.IP "\fB\s-1BTS_CACHE\s0\fR" 4
.IX Item "BTS_CACHE"
Falls dies auf \fBno\fR gesetzt ist, dann ist es genauso, als wenn der
Befehlszeilenparameter \fB\-\-no\-cache\fR benutzt würde. Es hat nur Auswirkungen
auf die Befehle \fBshow\fR und \fBbug\fR. Vorgabe ist \fByes\fR. Weitere
Informationen finden Sie wieder beim Befehl \fBshow\fR weiter oben.
.IP "\fBBTS_CACHE_MODE=\fR{\fBmin\fR,\fBmbox\fR,\fBfull\fR}" 4
.IX Item "BTS_CACHE_MODE={min,mbox,full}"
Wieviel von der Fehlerdatenbank sollte gespiegelt werden, wenn danach
gefragt wird, etwas zwischenzuspeichern? Nur das Minimum oder auch die Mbox
oder das Ganze? Vorgabe ist \fBmin\fR, was die gleiche Bedeutung hat wie der
Befehlszeilenparameter \fB\-\-cache\-mode\fR. Dies hat nur Auswirkungen auf den
Zwischenspeicher. Weitere Informationen finden Sie beim Befehl \fBcache\fR.
.IP "\fB\s-1BTS_FORCE_REFRESH\s0\fR" 4
.IX Item "BTS_FORCE_REFRESH"
Falls dies auf \fByes\fR gesetzt ist, dann ist es genauso, als wenn der
Befehlszeilenparameter \fB\-\-force\-refresh\fR benutzt würde. Es hat nur
Auswirkungen auf den Befehl \fBcache\fR. Vorgabe ist \fBno\fR. Weitere
Informationen finden Sie beim Befehl \fBcache\fR.
.IP "\fB\s-1BTS_MAIL_READER\s0\fR" 4
.IX Item "BTS_MAIL_READER"
Falls dies gesetzt ist, gibt es ein E\-Mail-Programm an, der anstelle von
\&\fBmutt\fR benutzt wird. Entspricht der Befehlszeilenoption \fB\-\-mailreader\fR.
.IP "\fB\s-1BTS_SENDMAIL_COMMAND\s0\fR" 4
.IX Item "BTS_SENDMAIL_COMMAND"
Falls dies gesetzt ist, gibt es einen \fBsendmail\fR\-Befehl an, der anstelle
von \fI/usr/sbin/sendmail\fR verwendet wird. Entspricht der Befehlszeilenoption
\&\fB\-\-sendmail\fR.
.IP "\fB\s-1BTS_ONLY_NEW\s0\fR" 4
.IX Item "BTS_ONLY_NEW"
lädt beim Zwischenspeichern nur neue Fehler herunter; prüft nicht auf
Aktualisierungen in Fehlern, die bereits vorliegen. Vorgabe ist
\&\fBno\fR. Entspricht der Befehlszeilenoption \fB\-\-only\-new\fR.
.IP "\fB\s-1BTS_SMTP_HOST\s0\fR" 4
.IX Item "BTS_SMTP_HOST"
Falls dies gesetzt ist, gibt es einen SMTP-Host an, der für den Versand von
E\-Mail gegenüber dem Befehl \fBsendmail\fR den Vorzug bekommt. Entspricht der
Befehlszeilenoption \fB\-\-smtp\-host\fR.
.Sp
Beachten Sie, dass diese Option eine höhere Priorität hat als
\&\fB\s-1BTS_SENDMAIL_COMMAND\s0\fR, falls beide gesetzt sind, außer wenn die Option
\&\fB\-\-sendmail\fR verwendet wird.
.IP "\fB\s-1BTS_SMTP_AUTH_USERNAME\s0\fR, \fB\s-1BTS_SMTP_AUTH_PASSWORD\s0\fR" 4
.IX Item "BTS_SMTP_AUTH_USERNAME, BTS_SMTP_AUTH_PASSWORD"
Falls diese Optionen gesetzt sind, ist es, als ob die Optionen
\&\fB\-\-smtp\-username\fR und \fB\-\-smtp\-password\fR benutzt würden.
.IP "\fB\s-1BTS_SMTP_HELO\s0\fR" 4
.IX Item "BTS_SMTP_HELO"
entspricht der Befehlszeilenoption \fB\-\-smtp\-helo\fR.
.IP "\fB\s-1BTS_INCLUDE_RESOLVED\s0\fR" 4
.IX Item "BTS_INCLUDE_RESOLVED"
Falls dies auf \fBno\fR gesetzt ist, ist es, als ob der Befehlszeilenparameter
\&\fB\-\-no\-include\-resolved\fR benutzt würde. Es hat nur Auswirkungen auf den
Befehl \fBcache\fR. Vorgabe ist \fByes\fR. Weitere Informationen finden Sie beim
Befehl \fBcache\fR.
.IP "\fB\s-1BTS_SUPPRESS_ACKS\s0\fR" 4
.IX Item "BTS_SUPPRESS_ACKS"
Falls dies auf \fByes\fR gesetzt ist, dann ist es, als ob der
Befehlszeilenparameter \fB\-\-no\-ack\fR benutzt würde. Vorgabe ist \fBno\fR.
.IP "\fB\s-1BTS_INTERACTIVE\s0\fR" 4
.IX Item "BTS_INTERACTIVE"
Falls dies auf \fByes\fR oder \fBforce\fR gesetzt ist, dann ist es, als ob die
Befehlszeilenparameter \fB\-\-interactive\fR oder \fB\-\-force\-interactive\fR benutzt
würden. Vorgabe ist \fBno\fR.
.IP "\fB\s-1BTS_DEFAULT_CC\s0\fR" 4
.IX Item "BTS_DEFAULT_CC"
gibt eine Liste von E\-Mail-Adressen an, an die eine Kopie der erzeugten
E\-Mail an den Steuer-Bot automatisch gesandt werden sollte.
.IP "\fB\s-1BTS_SERVER\s0\fR" 4
.IX Item "BTS_SERVER"
gibt den Namen des Debbugs-Servers an, der anstelle von bugs.debian.org
benutzt werden soll.
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
Bitte lesen Sie <http://www.debian.org/Bugs/server\-control>, um weitere
Einzelheiten zu erhalten, wie die Fehlerdatenbank unter Benutzung von
E\-Mails gesteuert wird und <http://www.debian.org/Bugs/>, um weitere
Informationen über die Fehlerdatenbank zu erhalten.
.PP
\&\fIquerybts\fR\|(1), \fIreportbug\fR\|(1)
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Dieses Programm unterliegt dem Copyright (C) 2001\-2003 von Joey Hess
<joeyh@debian.org>. Es wurden viele Änderungen vorgenommen unter dem
Copyright (C) 2002\-2005 von Julian Gilbey <jdg@debian.org> und dem Copyright
(C) 2007 von Josh Triplett <josh@freedesktop.org>.
.PP
Es ist lizensiert unter den Bedingungen der \s-1GPL,\s0 entweder Version 2 der
Lizenz oder (nach Ihrer Wahl) irgendeiner späteren Version.
