239 lines
11 KiB
HTML
239 lines
11 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of dpkg-parsechangelog</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>dpkg-parsechangelog</H1>
|
|
Section: dpkg-Programmsammlung (1)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>BEZEICHNUNG</H2>
|
|
|
|
dpkg-parsechangelog - auswerten von Debian changelog-Dateien
|
|
<A NAME="lbAC"> </A>
|
|
<H2>ÜBERSICHT</H2>
|
|
|
|
<B>dpkg-parsechangelog</B> [<I>Option</I> …]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHREIBUNG</H2>
|
|
|
|
<B>dpkg-parsechangelog</B> liest das Änderungsprotokoll (»changelog«) eines
|
|
entpackten Debian-Quellcodebaums ein, wertet diese aus und gibt die
|
|
Informationen in der Standard-Ausgabe in maschinenlesbarer Form aus.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-l</B>, <B>--file</B> <I>Changelog-Datei</I><DD>
|
|
Gibt die Änderungsprotokolldatei an, aus der Informationen gelesen werden
|
|
sollen. Ein bq-' kann zur Angabe des Lesens von der Standardeingabe verwandt
|
|
werden. Standardmäßig <B>debian/changelog</B>.
|
|
<DT id="2"><B>-F</B> <I>Changelog-Format</I><DD>
|
|
Gibt das Format der Änderungsprotokolldatei an. Standardmäßig wird das
|
|
Format aus einer speziellen Zeile in der Nähe des Endes der
|
|
Änderungsprotokolldatei gelesen oder, falls dies fehlschlägt, wird das
|
|
<B>debian</B>-Standardformat angenommen. Siehe auch <B>CHANGELOG-FORMATE</B>.
|
|
<DT id="3"><B>-L</B> <I>libverzeichnis</I><DD>
|
|
Veraltete Option ohne Effekt (seit Dpkg 1.18.8). Setzen der
|
|
Perl-Umgebungsvariablen <B>PERL5LIB</B> oder <B>PERLLIB</B> hat einen ähnlichen
|
|
Effekt, wenn nach Auswerter-Perl-Modulen gesucht wird.
|
|
<DT id="4"><B>-S</B>, <B>--show-field</B> <I>Feld</I><DD>
|
|
Spezifiziert den Namen des anzuzeigenden Feldes (seit Dpkg 1.17.0). Der
|
|
Feldname wird nicht angezeigt, nur sein Wert.
|
|
<DT id="5"><B>-?</B>, <B>--help</B><DD>
|
|
Zeige den Bedienungshinweis und beende.
|
|
<DT id="6"><B>--version</B><DD>
|
|
Gebe die Version aus und beende sich.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H3>Auswerter-Optionen:</H3>
|
|
|
|
Die folgenden Optionen können verwendet werden, um die Ausgabe des
|
|
Changelog-Auswerters zu beinflussen, z.B. den Bereich der Einträge oder das
|
|
Format der Ausgabe.
|
|
<DL COMPACT>
|
|
<DT id="7"><B>--format</B><I> Ausgabeformat</I><DD>
|
|
Setze das Ausgabeformat. Derzeit werden die Werte <B>dpkg</B> und <B>rfc822</B>
|
|
unterstützt. <B>dpkg</B> ist das klassische Ausgabeformat (es existiert länger
|
|
als diese Option), das voreingestellt ist. Es besteht aus einem Absatz im
|
|
Debian-Steuerformat (lesen Sie <B><A HREF="/cgi-bin/man/man2html?5+deb-control">deb-control</A></B>(5)). Falls mehr als ein
|
|
Eintrag angefordert wird, dann werden die meisten Felder aus dem ersten
|
|
Eintrag (normalerweise der neuste Eintrag) verwendet, falls dies nicht
|
|
anders angegeben wird:
|
|
<DL COMPACT><DT id="8"><DD>
|
|
<DL COMPACT>
|
|
<DT id="9"><B>Source:</B><I> Paketname</I><DD>
|
|
<DT id="10"><B>Version:</B><I> Version</I><DD>
|
|
<DT id="11"><B>Distribution:</B><I> Ziel-Distribution</I><DD>
|
|
<DT id="12"><B>Urgency:</B><I> Dringlichkeit</I><DD>
|
|
Die höchste Dringlichkeit aller enthaltenen Einträge wird verwandt, gefolgt
|
|
von den zusammengefügten (durch Leerzeichen getrennten) Kommentaren von
|
|
allen angeforderten Versionen.
|
|
<DT id="13"><B>Maintainer:</B><I> Autor</I><DD>
|
|
<DT id="14"><B>Date:</B><I> Datum</I><DD>
|
|
Das Datum des Eintrags als Zeichenkette, wie es im Changelog auftaucht. Mit
|
|
dem Format <B><A HREF="/cgi-bin/man/man2html?3+strptime">strptime</A></B>(3) »<B>%a, %d %b %Y %T %z</B>«, wobei der Wochentag nicht
|
|
dem echten Tag aus dem Rest der Datumszeichenkette entsprechen kann. Falls
|
|
Sie eine genauere Darstellung des Datums benötigen, verwenden Sie das Feld
|
|
<B>Timestamp</B>, beachten dabei aber, dass es nicht möglich sein könnte, es auf
|
|
den genauen Wert in diesem Feld abzubilden.
|
|
<DT id="15"><B>Timestamp:</B><I> Zeitstempel</I><DD>
|
|
Das Datum des Eintrags als Zeitstempel in Sekunden seit der Epoche (seit
|
|
Dpkg 1.18.8).
|
|
<DT id="16"><B>Closes:</B><I> Fehlernummer</I><DD>
|
|
Die Felder »Closes« aller enthaltenen Einträge werden zusammengefasst.
|
|
<DT id="17"><B>Changes:</B><I> Changelog-Einträge</I><DD>
|
|
Der Text aller Changelog-Einträge wird aneinandergehängt. Um aus diesem Feld
|
|
ein gültiges mehrzeiliges Feld im Debian Steuer-Format zu bekomen, werden
|
|
leere Zeilen mit einem einzelnen Satzpunkt ersetzt und alle Zeilen durch ein
|
|
Leerzeichen eingerückt. Der genaue Inhalt hängt vom Changelog-Format ab.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="18"><DD>
|
|
Die Felder <B>Version</B>, <B>Distribution</B>, <B>Urgency</B>, <B>Maintainer</B> und
|
|
<B>Changes</B> sind verpflichtend.
|
|
<DT id="19"><DD>
|
|
Es können zusätzliche benutzerdefinierte Felder vorhanden sein.
|
|
<DT id="20"><DD>
|
|
Das <B>rfc822</B>-Format verwendet die gleichen Felder, gibt aber einzelne
|
|
Absätze für jeden Changelog-Eintrag aus, so dass alle Metadaten für jeden
|
|
Eintrag erhalten bleiben.
|
|
<DT id="21"><B>--reverse</B><DD>
|
|
füge alle Änderungen in umgekehrter Reihenfolge hinzu (seit Dpkg
|
|
1.19.1). Beachten Sie: Für das <B>dpkg</B>-Format ist der erste Eintrag der
|
|
älteste Eintrag.
|
|
<DT id="22"><B>--all</B><DD>
|
|
alle Änderungen aufnehmen. Hinweis: Andere Optionen haben keine Wirkung,
|
|
wenn diese verwandt wird.
|
|
<DT id="23"><B>-s</B>, <B>--since</B> <I>Version</I><DD>
|
|
|
|
<B>-v</B> <I>Version</I>
|
|
füge alle Änderungen neuer als aus <I>Version</I> hinzu.
|
|
<DT id="24"><B>-u</B>, <B>--until</B> <I>Version</I><DD>
|
|
füge alle Änderungen älter als aus <I>Version</I> hinzu.
|
|
<DT id="25"><B>-f</B>, <B>--from</B> <I>Version</I><DD>
|
|
füge alle Änderungen aus oder neuer als aus <I>Version</I> hinzu.
|
|
<DT id="26"><B>-t</B>, <B>--to</B> <I>Version</I><DD>
|
|
füge alle Änderungen aus oder älter als aus <I>Version</I> hinzu.
|
|
<DT id="27"><B>-c</B>, <B>--count</B> <I>Anzahl</I><DD>
|
|
|
|
<B>-n</B> <I>Anzahl</I>
|
|
füge <I>Anzahl</I> Einträge vom Kopf (oder vom Fuß, falls <I>Anzahl</I> negativ ist)
|
|
hinzu.
|
|
<DT id="28"><B>-o</B>, <B>--offset</B> <I>Zahl</I><DD>
|
|
ändere den Startpunkt für <B>--count</B>, gezählt vom Kopf (oder Fuß, falls
|
|
<I>Zahl</I> negativ ist).
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>CHANGELOG-FORMATE</H2>
|
|
|
|
Es ist möglich, ein anderes als das Standardformat zu verwenden, indem ein
|
|
Auswerter für dieses alternative Format bereitgestellt wird.
|
|
<P>
|
|
Damit <B>dpkg-parsechangelog</B> den neuen Auswerter ausführen kann, muss eine
|
|
Zeile innerhalb der letzten 40 Zeilen der Changelog-Datei enthalten sein,
|
|
die auf den folgenden regulären Perl-Ausdruck passt:
|
|
Bq<B>\schangelog-format:\s+([0-9a-z]+)\W</B>". Der Anteil in Klammern sollte
|
|
der Name des Formats sein, beispielsweise:
|
|
<P>
|
|
<BR> @@@ changelog-format: <I>Anderesformat</I> @@@
|
|
<P>
|
|
Changelog-Formatnamen sind nichtleere kleine alphanumerische Zeichenketten
|
|
(Bqa-z0-9").
|
|
<P>
|
|
Falls eine solche Zeile existiert, wird <B>dpkg-parsechangelog</B> nach dem
|
|
Auswerter als Perl-Modul <B>Dpkg::Changelog::</B><I>Otherformat</I> suchen. Es ist
|
|
ein Fehler, wenn dieser nicht vorhanden ist. Die Großschreibung des
|
|
Perl-Moduls erfolgt automatisch. Das Standard-Änderungsprotokollformat ist
|
|
<B>debian</B>, hierfür wird standardmäßig ein Auswerter bereitgestellt.
|
|
<P>
|
|
Der Auswerter sollte von der Klasse Dpkg::Changelog abgeleitet sein und die
|
|
benötigte dokumentierte Schnittstelle implementieren.
|
|
<P>
|
|
Falls das geparste Changelog-Format immer oder fast immer eine Leerzeile
|
|
zwischen einzelnen Änderungsnotizen lässt, sollten diese Leerzeilen
|
|
herausgefiltert werden, so dass die entstehende Ausgabe kompakt wird.
|
|
<P>
|
|
Falls das Changelog-Format kein Datum oder keine Paketnamensinformationen
|
|
enthält, sollte diese Information in der Ausgabe unterbleiben. Der Auswerter
|
|
soll nicht versuchen, diese Daten künstlich zu ermitteln oder sie in anderen
|
|
Quellen zu finden.
|
|
<P>
|
|
Falls das Änderungsprotokoll nicht das erwartete Format hat, sollte sich der
|
|
Auswerter mit einem Fehler beenden, statt zu versuchen, sich irgendwie
|
|
durchzuwurschteln und möglicherweise eine falsche Ausgabe zu erzeugen.
|
|
<P>
|
|
Ein Changelog-Auswerter darf nicht mit dem Benutzer interagieren.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>BEMERKUNGEN</H2>
|
|
|
|
Alle <B>Auswerter-Optionen</B> außer <B>-v</B> werden seit Dpkg 1.14.16 unterstützt.
|
|
<P>
|
|
|
|
Das Auswerten kurzer Optionen mit nicht gebündelten Werten ist nur seit
|
|
Dpkg-Version 1.18.0 verfügbar.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>UMGEBUNG</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="29"><B>DPKG_COLORS</B><DD>
|
|
Setzt den Farbmodus (seit Dpkg 1.18.5). Die derzeit unterstützten Werte
|
|
sind: <B>auto</B> (Vorgabe), <B>always</B> und <B>never</B>.
|
|
<DT id="30"><B>DPKG_NLS</B><DD>
|
|
Falls dies gesetzt ist, wird es zur Entscheidung, ob Native Language
|
|
Support, auch als Internationalisierung (oder i18n) Unterstützung bekannt,
|
|
aktiviert wird (seit Dpkg 1.19.0). Die akzeptierten Werte sind: <B>0</B> und
|
|
<B>1</B> (Vorgabe).
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>DATEIEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="31"><B>debian/changelog</B><DD>
|
|
Die changelog-Datei wird verwendet, um versionsabhängige Informationen über
|
|
das Quellpaket, wie beispielsweise die Dringlichkeit (»urgency«) und die
|
|
Distribution des Uploads, die Änderungen seit einer bestimmten
|
|
Veröffentlichung und die Quellversionsnummer selbst zu erhalten.
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>SIEHE AUCH</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-changelog">deb-changelog</A></B>(5).
|
|
<A NAME="lbAL"> </A>
|
|
<H2>ÜBERSETZUNG</H2>
|
|
|
|
Die deutsche Übersetzung wurde 2004, 2006-2019 von Helge Kreutzmann
|
|
<<A HREF="mailto:debian@helgefjell.de">debian@helgefjell.de</A>>, 2007 von Florian Rehnisch <<A HREF="mailto:eixman@gmx.de">eixman@gmx.de</A>> und
|
|
2008 von Sven Joachim <<A HREF="mailto:svenjoac@gmx.de">svenjoac@gmx.de</A>>
|
|
angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
|
|
GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
|
|
Es gibt KEINE HAFTUNG.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="32"><A HREF="#lbAB">BEZEICHNUNG</A><DD>
|
|
<DT id="33"><A HREF="#lbAC">ÜBERSICHT</A><DD>
|
|
<DT id="34"><A HREF="#lbAD">BESCHREIBUNG</A><DD>
|
|
<DT id="35"><A HREF="#lbAE">OPTIONEN</A><DD>
|
|
<DL>
|
|
<DT id="36"><A HREF="#lbAF">Auswerter-Optionen:</A><DD>
|
|
</DL>
|
|
<DT id="37"><A HREF="#lbAG">CHANGELOG-FORMATE</A><DD>
|
|
<DT id="38"><A HREF="#lbAH">BEMERKUNGEN</A><DD>
|
|
<DT id="39"><A HREF="#lbAI">UMGEBUNG</A><DD>
|
|
<DT id="40"><A HREF="#lbAJ">DATEIEN</A><DD>
|
|
<DT id="41"><A HREF="#lbAK">SIEHE AUCH</A><DD>
|
|
<DT id="42"><A HREF="#lbAL">ÜBERSETZUNG</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:04:56 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|