man/de/dpkg-parsechangelog.1

   1 .\" dpkg manual page - dpkg-parsechangelog(1)
   2 .\"
   3 .\" Copyright © 1995-1996 Ian Jackson <ian@chiark.chu.cam.ac.uk>
   4 .\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org>
   5 .\" Copyright © 2006, 2012 Guillem Jover <guillem@debian.org>
   6 .\" Copyright © 2007-2008 Frank Lichtenheld <djpig@debian.org>
   7 .\" Copyright © 2009 Raphaël Hertzog <hertzog@debian.org>
   8 .\"
   9 .\" This is free software; you can redistribute it and/or modify
  10 .\" it under the terms of the GNU General Public License as published by
  11 .\" the Free Software Foundation; either version 2 of the License, or
  12 .\" (at your option) any later version.
  13 .\"
  14 .\" This is distributed in the hope that it will be useful,
  15 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  16 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17 .\" GNU General Public License for more details.
  18 .\"
  19 .\" You should have received a copy of the GNU General Public License
  20 .\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
  21 .
  22 .\"*******************************************************************
  23 .\"
  24 .\" This file was generated with po4a. Translate the source file.
  25 .\"
  26 .\"*******************************************************************
  27 .TH dpkg\-parsechangelog 1 2012\-05\-04 Debian\-Projekt dpkg\-Hilfsprogramme
  28 .SH NAME
  29 dpkg\-parsechangelog \- auswerten von Debian changelog\-Dateien
  30 .
  31 .SH ÜBERSICHT
  32 \fBdpkg\-parsechangelog\fP [\fIOption\fP ?]
  33 .
  34 .SH BESCHREIBUNG
  35 \fBdpkg\-parsechangelog\fP liest das Änderungsprotokoll (»changelog«) eines
  36 entpackten Debian\-Quellcodebaums ein, wertet diese aus und gibt die
  37 Informationen in der Standard\-Ausgabe in maschinenlesbarer Form aus.
  38 .
  39 .SH OPTIONEN
  40 .TP
  41 \fB\-l\fP\fIChangelog\-Datei\fP
  42 Gibt die Änderungsprotokolldatei an, aus der Informationen gelesen werden
  43 sollen. Standardmäßig \fBdebian/changelog\fP.
  44 .TP
  45 \fB\-F\fP\fIChangelog\-Format\fP
  46 Gibt das Format der Änderungsprotokolldatei an. Standardmäßig wird das
  47 Format aus einer speziellen Zeile in der Nähe des Endes der
  48 Änderungsprotokolldatei gelesen oder, falls dies fehlschlägt, wird das
  49 Debian\-Standardformat angenommen. Siehe auch \fBCHANGELOG\-FORMATE\fP.
  50 .TP
  51 \fB\-L\fP\fIlibverzeichnis\fP
  52 Spezifiziere ein zusätzliches Verzeichnis, dass nach Parser\-Skripten
  53 durchsucht werden soll. Diese Verzeichnis wird vor den
  54 Standardverzeichnissen (derzeit \fB/usr/local/lib/dpkg/parsechangelog\fP und
  55 \fB/usr/lib/dpkg/parsechangelog\fP) durchsucht.
  56 .TP
  57 \fB\-?\fP, \fB\-\-help\fP
  58 Zeige den Bedienungshinweis und beende.
  59 .TP
  60 \fB\-\-version\fP
  61 Gebe die Version aus und beende sich.
  62 .SS Parser\-Optionen:
  63 Die folgenden Optionen können verwendet werden, um die Ausgabe des
  64 Changelog\-Parsers zu beinflussen, z.B. den Bereich der Einträge oder das
  65 Format der Ausgabe. Sie müssen vom in Frage kommenden Parser\-Skript
  66 unterstützt werden. Lesen Sie auch \fBWARNUNGEN\fP.
  67 .TP
  68 \fB\-\-format\fP\fI Ausgabeformat\fP
  69 Setze das Ausgabeformat. Derzeit werden die Werte \fIdpkg\fP und \fIrfc822\fP
  70 unterstützt. \fIdpkg\fP ist das klassische Ausgabeformat (es existiert länger
  71 als diese Option), das voreingestellt ist. Es besteht aus einem Absatz im
  72 Debian\-Steuerformat (lesen Sie \fBdeb\-control\fP(5)). Falls mehr als ein
  73 Eintrag angefordert wird, dann werden die meisten Felder aus dem neusten
  74 Eintrag verwendet, falls dies nicht anders angegeben wird:
  75 .RS
  76 .TP
  77 \fBSource:\fP\fI Paketname\fP
  78 .TP
  79 \fBVersion:\fP\fI Version\fP
  80 .TP
  81 \fBDistribution:\fP\fI Ziel\-Distribution\fP
  82 .TP
  83 \fBUrgency:\fP\fI Dringlichkeit\fP
  84 Die höchste Dringlichkeit aller enthaltenen Einträge wird verwandt, gefolgt
  85 von den zusammengefügten (durch Leerzeichen getrennten) Kommentaren von
  86 allen angeforderten Versionen.
  87 .TP
  88 \fBMaintainer:\fP\fI Autor\fP
  89 .TP
  90 \fBDate:\fP\fI Datum\fP
  91 .TP
  92 \fBCloses:\fP\fI Fehlernummer\fP
  93 Die Felder »Closes« aller enthaltenen Einträge werden zusammengefasst.
  94 .TP
  95 \fBChanges:\fP\fI Changelog\-Einträge\fP
  96 Der Text aller Changelog\-Einträge wird aneinandergehängt. Um aus diesem Feld
  97 ein gültiges mehrzeiliges Feld im Debian Steuer\-Format zu bekomen, werden
  98 leere Zeilen mit einem einzelnen Satzpunkt ersetzt und alle Zeilen durch ein
  99 Leerzeichen eingerückt. Der genaue Inhalt hängt vom Changelog\-Format ab.
 100 .RE
 101 .IP
 102 Die Felder \fBVersion\fP, \fBDistribution\fP, \fBUrgency\fP, \fBMaintainer\fP und
 103 \fBChanges\fP sind verpflichtend.
 104 .IP
 105 Es können zusätzliche benutzerdefinierte Felder vorhanden sein.
 106 .IP
 107 Das \fBrfc822\fP\-Format verwendet die gleichen Felder, gibt aber einzelne
 108 Absätze für jeden Changelog\-Eintrag aus, so dass alle Metadaten für jeden
 109 Eintrag erhalten bleiben.
 110 .TP
 111 \fB\-\-since\fP \fIVersion\fP, \fB\-s\fP\fIVersion\fP,\fB \-v\fP\fIVersion\fP
 112 füge alle Änderungen neuer als aus \fIVersion\fP hinzu.
 113 .TP
 114 \fB\-\-until\fP \fIVersion\fP, \fB\-u\fP\fIVersion\fP
 115 füge alle Änderungen älter als aus \fIVersion\fP hinzu.
 116 .TP
 117 \fB\-\-from\fP \fIVersion\fP, \fB\-f\fP\fIVersion\fP
 118 füge alle Änderungen aus oder neuer als aus \fIVersion\fP hinzu.
 119 .TP
 120 \fB\-\-to\fP \fIVersion\fP, \fB\-t\fP\fIVersion\fP
 121 füge alle Änderungen aus oder älter als aus \fIVersion\fP hinzu.
 122 .TP
 123 \fB\-\-count\fP \fIAnzahl\fP, \fB\-c\fP\fIAnzahl\fP, \fB\-n\fP\fIAnzahl\fP
 124 füge \fIAnzahl\fP Einträge vom Kopf (oder vom Fuß, falls \fIAnzahl\fP negativ ist)
 125 hinzu.
 126 .TP
 127 \fB\-\-offset\fP \fIZahl\fP, \fB\-o\fP\fIZahl\fP
 128 ändere den Startpunkt für \-\-count, gezählt vom Kopf (oder Fuß falls, falls
 129 \fIZahl\fP negativ ist).
 130 .TP
 131 \fB\-\-all\fP
 132 alle Änderungen aufnehmen. Hinweis: Andere Optionen haben keine Wirkung,
 133 wenn diese verwandt wird.
 134 .
 135 .SH CHANGELOG\-FORMATE
 136 Es ist möglich, ein anderes als das Standardformat zu verwenden, indem ein
 137 Parser für dieses alternative Format bereitgestellt wird.
 138
 139 Damit \fBdpkg\-parsechangelog\fP den neuen Parser ausführen kann, muss eine
 140 Zeile innerhalb der letzten 40 Zeilen der Changelog\-Datei enthalten sein,
 141 die auf den folgenden regulären Perl\-Ausdruck passt:
 142 \(lq\fB\eschangelog\-format:\es+([0\-9a\-z]+)\eW\fP\(rq. Der Anteil in Klammern
 143 sollte der Name des Formats sein, beispielsweise:
 144
 145        @@@ changelog\-format: \fIAnderesformat\fP @@@
 146
 147 Changelog\-Formatnamen sind nichtleere alphanumerische Zeichenketten.
 148
 149 Falls eine solche Zeile existiert, wird \fBdpkg\-parsechangelog\fP nach dem
 150 Parser als \fB/usr/lib/dpkg/parsechangelog/\fP\fIAnderesformat\fP oder
 151 \fB/usr/local/lib/dpkg/parsechangelog/\fP\fIAnderesformat\fP suchen. Es ist ein
 152 Fehler, wenn dieser nicht vorhanden oder kein ausführbares Programm ist. Das
 153 Standard\-Änderungsprotokollformat ist \fBdebian\fP, hierfür wird standardmäßig
 154 ein Parser bereitgestellt.
 155
 156 Der Parser wird mit dem Änderungsprotokoll auf der Standardeingabe am Anfang
 157 der Datei aufgerufen. Er sollte die Datei lesen (er darf dafür suchen, falls
 158 gewünscht), um die benötigten Informationen zu ermitteln und die
 159 ausgewerteten Informationen auf der Standardausgabe in dem durch die Option
 160 \fB\-\-format\fP angegebenen Format auszugeben. Er sollte alle \fBParser\-Optionen\fP
 161 akzeptieren.
 162
 163 Falls das geparste Changelog\-Format immer oder fast immer eine Leerzeile
 164 zwischen einzelnen Änderungsnotizen lässt, sollten diese Leerzeilen
 165 herausgefiltert werden, so dass die entstehende Ausgabe kompakt wird.
 166
 167 Falls das Changelog\-Format kein Datum oder keine Paketnamensinformationen
 168 enthält, sollte diese Information in der Ausgabe unterbleiben. Der Parser
 169 soll nicht versuchen, diese Daten künstlich zu ermitteln oder sie in anderen
 170 Quellen zu finden.
 171
 172 Falls das Änderungsprotokoll nicht das erwartete Format hat, sollte sich der
 173 Parser mit einem von Null verschiedenen Exit\-Status beenden, statt zu
 174 versuchen, sich irgendwie durchzuwurschteln und möglicherweise eine falsche
 175 Ausgabe zu erzeugen.
 176
 177 Ein Changelog\-Parser darf nicht mit dem Nutzer interagieren.
 178 .
 179 .SH WARNUNG
 180 Alle \fBParser\-Optionen\fP außer \-v werden nur von \fBdpkg\fP Version 1.14.16 oder
 181 neuer unterstützt. Parser von Dritten für Changelog\-Formate außer \fIdebian\fP
 182 könnten nicht alle Optionen unterstützen.
 183 .
 184 .SH DATEIEN
 185 .TP
 186 \fBdebian/changelog\fP
 187 Die changelog\-Datei wird verwendet, um versionsabhängige Informationen über
 188 das Quellpaket, wie beispielsweise die Dringlichkeit (»urgency«) und die
 189 Distribution des Uploads, die Änderungen seit einer bestimmten
 190 Veröffentlichung und die Quellversionsnummer selbst zu erhalten.
 191 .SH ÜBERSETZUNG
 192 Die deutsche Übersetzung wurde 2004, 2006-2012 von Helge Kreutzmann
 193 <debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
 194 2008 von Sven Joachim <svenjoac@gmx.de>
 195 angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
 196 GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
 197 Es gibt KEINE HAFTUNG.