.\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH PLOTCHANGELOG 1 Debian\-Hilfswerkzeuge DEBIAN .SH BESCHREIBUNG plotchangelog \- zeichnet Debian\-Changelogs .SH ÜBERSICHT \fBplotchangelog\fP [\fIOptionen\fP]\fI Changelog \fP … .SH BESCHREIBUNG \fBplotchangelog\fP ist ein Werkzeug, das hilft, ein Debian\-\fIChangelog\fP zu veranschaulichen. Die Changelogs werden durch \fBgnuplot\fP(1) gezeichnet, wobei die X\-Achse des Graphs die Zeit der Veröffentlichung des Pakets und die Y\-Achse die Debian\-Versionsnummer des Pakets anzeigt. Jede einzelne Veröffentlichung des Pakets wird durch einen Punkt dargestellt und die Punkte werden farbig kodiert, um anzuzeigen, wer diese Version des Pakets veröffentlichte. Der Graph kann ebenfalls mit der Versionsnummer der Originalautoren des Pakets beschriftet werden. .PP Alternativ kann die Y\-Achse konfiguriert werden, um die Größe der Changelog\-Einträge für jede neue Version anzuzeigen. Oder sie kann konfiguriert werden, um anzuzeigen, wieviele Fehler schätzungsweise für jede neue Version behoben wurden. .PP Beachten Sie, falls das Paket Debian\-spezifisch ist, dass die ganze Paketversion für die Y\-Achse verwendet wird. Dies funktioniert nicht immer perfekt. .PP .SH "DEN GRAPH LESEN" Die allgemeine Kontur eines Paket\-Graphen ist typischerweise eine Serie von Höchstwerten, beginnend bei 1, steigend bis n und dann abrupt zu 1 zurückkehrend. Je höher die Höchstwerte, um so mehr Veröffentlichungen brachte der Paketbetreuer zwischen den neuen Paketversionen der Ursprungsautoren heraus. Falls es sich um ein reines Debian\-Paket handelt, wird sein Graph nur nach oben wachsen ohne irgendwann abzufallen (allerdings kann ihn ein Fehler in diesem Programm manchmal zum Fallen veranlassen, falls sich die Versionsnummer von zum Beispiel 0.9 auf zum Beispiel 0.10 ändert – dies wird falsch interpretiert …) .PP Falls der Graph unter 1 sinkt, jemand ein NMU des Pakets und ein Upgrade auf eine neue Version der Ursprungsautoren durchgeführt hat, wird dadurch die Debian\-Version auf 0 gesetzt. NMUs erscheinen im Allgemeinen als Unterpunkte wie 1.1, 2.1, etc. Ein NMU kann außerdem einfach festgestellt werden, indem die Punkte betrachtet werden, die für den Paketbetreuer stehen, der das Paket hochgeladen hat – ein einzelner Punkt eines anderen Typs, als der Punkte davor und dahinter ist normalerweise ein NMU. .PP Es ist außerdem einfach, durch Ansehen der Punkte zu sagen, wenn sich Betreuer eines Pakets ändern. .SH OPTIONEN .TP \fB\-l\fP, \fB\-\-linecount\fP nimmt statt der Debian\-Versionsnummer als Y\-Achse die Anzahl der Zeilen im Changelog\-Eintrag für jede Version. Dies kann nicht zusammen mit \fB\-\-bugcount\fP verwendet werden. .TP \fB\-b\fP, \fB\-\-bugcount\fP nimmt statt der Debian\-Versionsnummer als Y\-Achse die Anzahl der Fehler, die durch jeden Changelog\-Eintrag geschlossen wurden. Beachten Sie, dass diese Zahl durch eine Suche nach »#dddd« im Changelog abgefragt wurde und daher ungenau sein kann. Dies kann nicht zusammen mit \fB\-\-linecount\fP verwendet werden. .TP \fB\-c\fP, \fB\-\-cumulative\fP zeichnet, wenn es zusammen mit \fB\-\-bugcount\fP oder \fB\-\-linecount\fP benutzt wird, die Gesamtzahl statt der Anzahl in jedem einzelnen Changelog\-Eintrag. .TP \fB\-v\fP, \fB\-\-no\-version\fP zeigt nicht die Versionsbezeichnungen der Ursprungsautoren. Dies ist nützlich, falls der Graph zu voll wird. .TP \fB\-m, \-\-no\-maint\fP unterscheidet nicht zwischen verschiedenen Betreuern des Pakets. .TP \fB\-s Datei\fP, \fB\-\-save=\fP\fIDatei\fP speichert den Graph im PostScript\-Format in \fIDatei\fP, statt sie direkt anzuzeigen. .TP \fB\-u\fP, \fB\-\-urgency\fP benutzt größere Punkte, wenn das angezeigte Hochladen von Paketen eine höhere Dringlichkeit hat. .TP \fB\-\-verbose\fP gibt das Gnuplot\-Skript aus, das (zu Fehlersuchzwecken) in Gnuplot eingespeist wird. .TP \fB\-g\fP\fIBefehle\fP, \fB\-\-gnuplot=\fP\fIBefehle\fP Dies ermöglicht Ihnen, \fBgnuplot\fP(1)\-Befehle in das Gnuplot\-Skript einzufügen, das benutzt wird, um den Graph zu erzeugen. Die Befehle werden nach allen Initialisierungen und vor dem abschließenden Befehl \fBplot\fP platziert. Dies kann verwendet werden, um das durch dieses Programm vorgegebenes Aussehen auf beliebige Weise zu überschreiben. Sie können auch Dinge wie »set terminal png color« verwenden, um den Ausgabedateityp zu ändern, was in Verbindung mit der Option \-s nützlich ist. .TP \fB\-\-help\fP zeigt eine Zusammenfassung wie es benutzt wird. .TP \fB\-\-version\fP zeigt Version, Autor und Copyright\-Informationen. .TP \fB\-\-noconf\fP, \fB\-\-no\-conf\fP liest keine Konfigurationsdateien (siehe unten). .TP \fIChangelog \fP … die Changelog\-Dateien, die gezeichnet werden. Falls mehrere Dateien angegeben wurden, werden sie alle auf dem gleichen Graph angezeigt. Die Dateien können mit Gzip komprimiert werden. Jeglicher darin enthaltene Text, der nicht im Debian\-Changelog\-Format vorliegt, wird ignoriert. .SH KONFIGURATIONSVARIABLEN Die beiden Konfigurationsdateien \fI/etc/devscripts.conf\fP und \fI~/.devscripts\fP werden durch eine Shell in dieser Reihenfolge eingelesen, um Konfigurationsvariablen zu setzen. Die Option \fB\-\-no\-conf\fP kann benutzt werden, um ein Lesen dieser Variablen zu verhindern. Wenn diese Konfigurationsdateien gelesen werden, werden Umgebungsvariablen ignoriert. Die derzeit bekannten Variablen sind: .TP \fBPLOTCHANGELOG_OPTIONS\fP Dies ist eine durch Kommas getrennte Liste von Optionen, die immer benutzt werden kann, zum Beispiel \fB\-l \-b\fP. Fügen Sie in diese Liste nicht \fB\-g\fP oder \fB\-\-gnuplot\fP ein, da dies ignoriert werden könnte; siehe stattdessen die nächste Variable. .TP \fBPLOTCHANGELOG_GNUPLOT\fP Dies sind \fBgnuplot\fP\-Befehle, die allen derartigen auf der Befehlszeile angegebenen Befehlen vorangestellt werden. .SH "SIEHE AUCH" \fBdevscripts.conf\fP(5) .SH AUTOR Joey Hess