perlthanks – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

perlbug - So senden Sie Fehlerberichte zu Perl

ZUSAMMENFASSUNG

Perlbug

Perlbug [ -v ] [ -a Adresse ] [ -s Fach ] [ -b Körper | -f Eingabedatei ] [ -F Ausgabedatei ]
[ -r Absender ] [ -e Herausgeber ] [ -c Adminadresse | -C ] [ -S ] [ -t ] [ -d ] [ -A ]
[ -h ] [ -T ]

Perlbug [ -v ] [ -r Absender ]
[ -A ] [ -okay | -in Ordnung | -nein | -naja ]

perldanke

BESCHREIBUNG

Dieses Programm wurde entwickelt, um Ihnen beim Erstellen und Versenden von Fehlerberichten (und Dankesnotizen) zu helfen.
über perl5 und die mitgelieferten Module.

In den meisten Fällen können Sie es einfach interaktiv von einer Befehlszeile aus ausführen, ohne dass es speziell darauf ankommt
Argumente und folgen Sie den Anweisungen.

Wenn Sie einen Fehler mit einem nicht standardmäßigen Port gefunden haben (einer, der nicht Teil der Standard
Verteilung), eine Binärdistribution oder ein Nicht-Kernmodul (wie Tk, DBI usw.), dann
Bitte sehen Sie in der Dokumentation nach, die mit dieser Distribution geliefert wurde, um die richtige zu bestimmen
Ort, um Fehler zu melden.

Wenn Sie Ihren Bericht nicht über senden können Perlbug (höchstwahrscheinlich, weil Ihr System
keine Möglichkeit hat, E-Mails zu senden, die Perlbug erkennt), können Sie dieses Tool verwenden
um Ihren Bericht zu verfassen und in einer Datei zu speichern, die Sie dann an senden können [E-Mail geschützt]
mit Ihrem normalen Mail-Client.

In Extremfällen, Perlbug funktioniert auf Ihrem System möglicherweise nicht gut genug, um Sie durch den Vorgang zu führen
Verfassen eines Fehlerberichts. In diesen Fällen können Sie möglicherweise Perlbug -d System bekommen
Konfigurationsinformationen zur Aufnahme in einen manuell erstellten Fehlerbericht an
[E-Mail geschützt] .

Wenn Sie einen Fehler melden, gehen Sie bitte diese Checkliste durch:

Welche Perl-Version verwenden Sie?
Geben Sie "perl -v" in die Befehlszeile ein, um dies herauszufinden.

Führen Sie die neueste veröffentlichte Version von Perl aus?
Ansehen http://www.perl.org/ herausfinden. Wenn Sie nicht die neueste Version verwenden
Version, versuchen Sie bitte, Ihren Fehler in der neuesten stabilen Version zu replizieren.

Beachten Sie, dass Berichte über Fehler in alten Perl-Versionen, insbesondere solche, die auf
Sie haben die aktuelle stabile Version von Perl noch nicht getestet, erhalten wahrscheinlich weniger
Aufmerksamkeit von den Freiwilligen, die Perl entwickeln und warten, als Berichte über Fehler in
die aktuelle Ausgabe.

Dieses Tool ist nicht geeignet, um Fehler in einer Version vor Perl 5.0 zu melden.

Bist du dir sicher, dass es ein Bug ist?
Eine beträchtliche Anzahl der Fehlerberichte, die wir erhalten, entpuppt sich als dokumentierte Funktionen in
Perl. Stellen Sie sicher, dass das Problem, auf das Sie gestoßen sind, nicht beabsichtigt ist, indem Sie einen Blick in die
Dokumentation, die mit der Perl-Distribution geliefert wird.

Angesichts der schieren Menge der Perl-Dokumentation ist dies kein triviales Unterfangen, aber wenn
Sie können auf eine Dokumentation verweisen, die darauf hindeutet, dass das Verhalten, das Sie sehen, ist Wrongs,
Ihr Problem wird wahrscheinlich mehr Aufmerksamkeit erhalten. Vielleicht möchten Sie mit beginnen perldoc
perltrap für Zeiger auf allgemeine Fallen, die neue (und erfahrene) Perl-Programmierer ausführen
in.

Wenn Sie sich über die Bedeutung einer Fehlermeldung nicht sicher sind, perldoc
perldiag für eine Erklärung. Wenn die Nachricht nicht in perldiag ist, ist sie es wahrscheinlich nicht
von Perl generiert. Vielleicht haben Sie Glück, die Dokumentation Ihres Betriebssystems zu konsultieren
stattdessen.

Wenn Sie sich auf einer Nicht-UNIX-Plattform befinden perldoc perlport, wie einige Funktionen sein können
nicht implementiert oder funktionieren anders.

Möglicherweise können Sie mit dem Perl-Debugger herausfinden, was schief läuft. Zum
Informationen zur Verwendung des Debuggers perldoc perldbug.

Hast du einen passenden Testfall?
Je einfacher es ist, Ihren Fehler zu reproduzieren, desto wahrscheinlicher wird er behoben – wenn niemand
Ihr Problem duplizieren kann, wird es wahrscheinlich nicht behoben.

Ein guter Testfall hat die meisten dieser Attribute: kurzer, einfacher Code; wenige Abhängigkeiten von
externe Befehle, Module oder Bibliotheken; kein plattformabhängiger Code (es sei denn, es ist ein
plattformspezifischer Fehler); übersichtliche und einfache Dokumentation.

Ein guter Testfall ist fast immer ein guter Kandidat für den Perl-Test
Suite. Wenn Sie die Zeit haben, sollten Sie Ihren Testfall so schreiben, dass er leicht zu handhaben ist
in die Standard-Testsuite aufgenommen.

Haben Sie alle relevanten Informationen angegeben?
Achten Sie darauf, die genau Fehlermeldungen, falls vorhanden. "Perl hat einen Fehler gemacht" ist kein
genaue Fehlermeldung.

Wenn Sie einen Core-Dump (oder gleichwertig) erhalten, können Sie einen Debugger (dbx, gdb, usw.) zu
einen Stack-Trace erstellen, um ihn in den Fehlerbericht aufzunehmen.

HINWEIS: Sofern Ihr Perl nicht mit Debug-Informationen kompiliert wurde (oft -g), der Stack-Trace
ist wahrscheinlich etwas schwierig zu verwenden, da es höchstwahrscheinlich nur die
Funktionsnamen und nicht deren Argumente. Wenn möglich, kompilieren Sie Ihr Perl mit debug neu
info und reproduzieren Sie den Absturz und den Stacktrace.

Können Sie den Fehler im Klartext beschreiben?
Je einfacher ein reproduzierbarer Fehler zu verstehen ist, desto wahrscheinlicher wird er behoben.
Jeder Einblick, den Sie in das Problem geben können, wird viel helfen. Mit anderen Worten,
Versuchen Sie, das Problem zu analysieren (soweit Sie können) und melden Sie Ihre Entdeckungen.

Kannst du den Fehler selbst beheben?
Wenn ja, sind das großartige Neuigkeiten; Fehlerberichte mit Patches werden wahrscheinlich erheblich erhalten
mehr Aufmerksamkeit und Interesse als diejenigen ohne Patches. Bitte befestigen Sie Ihren Patch an
den Bericht mit der Option "-p". Wenn Sie einen Patch senden, erstellen Sie ihn mit "git
format-patch" wenn möglich, obwohl ein mit "diff -pu" erstelltes vereinheitlichtes Diff ausreicht
fast genauso gut.

Ihr Patch kann mit Änderungswünschen oder detaillierteren Anfragen zurückgesendet werden
Erklärungen zu deinem Fix.

Hier ein paar Hinweise zum Erstellen hochwertiger Patches:

Stellen Sie sicher, dass der Patch nicht umgekehrt wird (das erste Argument zum diff ist normalerweise das
Originaldatei, das zweite Argument Ihre geänderte Datei). Stellen Sie sicher, dass Sie Ihren Patch testen
indem Sie es mit "git am" oder dem Programm "patch" anwenden, bevor Sie es auf den Weg schicken.
Versuchen Sie, den gleichen Stil wie der Code zu verwenden, den Sie patchen möchten. Stellen Sie sicher, dass Ihre
patch funktioniert wirklich ("make test", wenn das, was Sie patchen, von Perls
Testsuite).

Können Sie "perlbug" verwenden, um den Bericht einzureichen?
Perlbug wird unter anderem sicherstellen, dass Ihr Bericht wichtige Informationen enthält
über Ihre Version von Perl. Wenn "perlbug" Ihren Bericht nicht versenden kann, nachdem Sie
eingegeben haben, müssen Sie die Nachricht möglicherweise selbst verfassen und die Ausgabe hinzufügen, die von . erstellt wurde
"perlbug -d" und mailen Sie es an [E-Mail geschützt] . Wenn Sie aus irgendeinem Grund nicht laufen können
"perlbug" auf Ihrem System, stellen Sie sicher, dass die gesamte Ausgabe von
Ausführen von "perl -V" (beachten Sie das V in Großbuchstaben).

Unabhängig davon, ob Sie "perlbug" verwenden oder die E-Mail manuell senden, geben Sie bitte Ihre Betreffzeile ein
informativ. "ein Fehler" ist nicht informativ. Weder ist "perl crashes" noch "HELP!!!".
Diese helfen nicht. Eine kompakte Beschreibung dessen, was falsch ist, ist in Ordnung.

Können Sie mit "perlbug" ein Dankeschön verschicken?
Ja, Sie können dies tun, indem Sie entweder die Option "-T" verwenden oder das Programm als . aufrufen
"perldanke". Dankeschöns sind gut. Es bringt die Leute zum Lächeln.

Nachdem Sie Ihren Beitrag geleistet haben, seien Sie bitte bereit zu warten, um zu erfahren, dass der Fehler in Ihrem Code steckt, oder
möglicherweise gar keine Antwort zu bekommen. Die Freiwilligen, die Perl pflegen, sind vielbeschäftigte Leute, also wenn
Ihr Problem ist ein offensichtlicher Fehler in Ihrem eigenen Code, ist schwer zu verstehen oder ist ein
Duplikat eines bestehenden Berichts erhalten Sie möglicherweise keine persönliche Antwort.

Wenn es Ihnen wichtig ist, dass Ihr Fehler behoben wird, überwachen Sie die [E-Mail geschützt]
Mailingliste (Mailinglisten werden moderiert, es kann eine Weile dauern, bis Ihre Nachricht angezeigt wird) und
die Commit-Logs zu den Entwicklungsversionen von Perl und ermutigen die Betreuer mit freundlichen Grüßen
Worte oder Angebote von frostigen Getränken. (Bitte seien Sie freundlich zu den Betreuern. Belästigung oder
Wenn Sie sie entflammen, hat dies wahrscheinlich den gegenteiligen Effekt des gewünschten.)

Fühlen Sie sich frei, das Ticket zu Ihrem Fehler zu aktualisieren auf http://rt.perl.org wenn eine neue Version von
Perl ist freigegeben und Ihr Fehler ist immer noch vorhanden.

OPTIONAL

-a Adresse, an die der Bericht gesendet werden soll. Standardmäßig auf [E-Mail geschützt] .

-A Senden Sie keine Empfangsbestätigung für Fehler an die Antwortadresse. Im Allgemeinen ist es
Diese Option ist nur sinnvoll, wenn Sie ein aktiver Perl-Betreuer sind
perl porters, damit Ihre Nachricht ankommt.

-b Hauptteil des Berichts. Wenn nicht in der Befehlszeile enthalten oder in einer Datei mit -f,
Sie haben die Möglichkeit, die Nachricht zu bearbeiten.

-C Senden Sie keine Kopie an den Administrator.

-c Adresse, an die eine Kopie des Berichts gesendet werden soll. Standardmäßig wird die Adresse der lokalen Perle verwendet
Administrator (aufgezeichnet, als Perl erstellt wurde).

-d Datenmodus (Standardeinstellung, wenn Sie die Ausgabe umleiten oder weiterleiten). Dies druckt Ihre
Konfigurationsdaten, ohne etwas zu mailen. Sie können dies mit verwenden -v bekommen
vollständigere Daten.

-e Editor zu verwenden.

-f Datei, die den Hauptteil des Berichts enthält. Verwenden Sie dies, um schnell eine vorbereitete
Nachricht.

-F Datei, in die die Ergebnisse ausgegeben werden sollen, anstatt sie als E-Mail zu senden. Besonders nützlich
beim Ausführen von Perlbug auf einem Computer ohne direkte Internetverbindung.

-h Druckt eine kurze Zusammenfassung der Optionen.

-okay Berichten Sie den Perl-Portern über den erfolgreichen Aufbau dieses Systems. Kräfte -S und -C. Kräfte
und liefert Werte für -s und -b. Fragt nur nach einer Rücksendeadresse, wenn dies nicht möglich ist
errate es (zur Verwendung mit um). Ehrt die Rücksendeadresse, die mit . angegeben ist -r. Sie können
benutze das mit -v um vollständigere Daten zu erhalten. Macht nur einen Bericht, wenn dieses System
weniger als 60 Tage alt ist.

-in Ordnung As -okay außer es wird über ältere Systeme berichten.

-nein Melden Sie einen fehlgeschlagenen Build auf diesem System. Kräfte -C. Erzwingt und liefert einen Wert
für -s, dann müssen Sie den Bericht bearbeiten und sagen, was schief gelaufen ist.
Alternativ kann ein vorbereiteter Bericht unter Verwendung von . geliefert werden -f. Nur Aufforderungen für a
Rücksendeadresse, wenn sie sie nicht erraten kann (zur Verwendung mit um). Ehrt die Rücksendeadresse
angegeben mit -r. Sie können dies mit verwenden -v um vollständigere Daten zu erhalten. Nur
meldet, wenn dieses System weniger als 60 Tage alt ist.

-naja As -nein außer es wird über ältere Systeme berichten.

-p Die Namen einer oder mehrerer Patch-Dateien oder anderer Textanhänge, die beigefügt werden sollen
der Bericht. Mehrere Dateien müssen durch Kommas getrennt werden.

-r Ihre Rücksendeadresse. Das Programm fordert Sie auf, die Standardeinstellung zu bestätigen, wenn Sie dies nicht tun
verwenden Sie diese Option.

-S Senden Sie, ohne um Bestätigung zu bitten.

-s Betreff der Nachricht. Sie werden aufgefordert, wenn Sie keine angeben
in der Kommandozeile.

-t Testmodus. Die Zieladresse ist standardmäßig [E-Mail geschützt] .

-T Senden Sie ein Dankeschön anstelle eines Fehlerberichts.

-v Nehmen Sie ausführliche Konfigurationsdaten in den Bericht auf.

AUTOREN

Kenneth Albanowski ([E-Mail geschützt] >), anschließend Dockzerrissen von Gurusamy Sarathy
(<[E-Mail geschützt] >), Tom Christiansen ([E-Mail geschützt] >), Nathan Torkington
(<[E-Mail geschützt] >), Charles F. Randall ([E-Mail geschützt] >), Mike Guy ([E-Mail geschützt] >),
Dominic Dunlop ([E-Mail geschützt] >), Hugo van der Sanden ([E-Mail geschützt] >), Jarkko
Hietaniemi ([E-Mail geschützt] >), Chris Nandor ([E-Mail geschützt] >), Jon Orwant
(<[E-Mail geschützt] >, Richard Foley ([E-Mail geschützt] >), Jesse Vincent
(<[E-Mail geschützt] >) und Craig A. Berry ([E-Mail geschützt] >).

Nutzen Sie Perlthanks online über die Dienste von onworks.net