237 lines
10 KiB
HTML
237 lines
10 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-suite (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>NAAM</H2>
|
|
|
|
dpkg-parsechangelog - ontleed Debian changelog-bestanden
|
|
<A NAME="lbAC"> </A>
|
|
<H2>OVERZICHT</H2>
|
|
|
|
<B>dpkg-parsechangelog</B> [<I>optie</I>...]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHRIJVING</H2>
|
|
|
|
<B>dpkg-parsechangelog</B> leest en ontleedt het bestand changelog van een
|
|
uitgepakte Debian broncodeboom en geeft de informatie eruit in een door een
|
|
machine te lezen vorm weer op de standaarduitvoer.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-l</B>, <B>--file</B> <I>changelog-bestand</I><DD>
|
|
Geeft het changelog-bestand op waaruit gelezen moet worden. Een '-' kan
|
|
gebruikt worden om aan te geven dat van de standaardinvoer gelezen moet
|
|
worden. De standaard is <B>debian/changelog</B>.
|
|
<DT id="2"><B>-F</B> <I>changelog-indeling</I><DD>
|
|
Geeft de indeling van het changelog-bestand aan. Standaard wordt die
|
|
indeling gelezen van een bijzondere regel dicht bij het einde van het
|
|
changelog-bestand en als dat mislukt, wordt er teruggevallen op de
|
|
standaardindeling van <B>debian</B>. Zie ook <B>CHANGELOG FORMATS</B>.
|
|
<DT id="3"><B>-L</B> <I>bibliotheekmap</I><DD>
|
|
Een uitgefaseerde optie zonder effect (sinds dpkg 1.18.8). Het instellen van
|
|
de perl omgevingsvariabelen <B>PERL5LIB</B> of <B>PERLLIB</B> heeft een gelijkaardig
|
|
effect bij het zoeken naar de perl-modules van de ontleder (parser).
|
|
<DT id="4"><B>-S</B>, <B>--show-field</B> <I>veld</I><DD>
|
|
Geeft de naam op van het te tonen veld (sinds dpkg 1.17.0). De naam van het
|
|
veld wordt niet weergegeven, enkel de inhoud ervan.
|
|
<DT id="5"><B>-?</B>, <B>--help</B><DD>
|
|
Toon info over het gebruik en sluit af.
|
|
<DT id="6"><B>--version</B><DD>
|
|
Toon de versie en sluit af.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H3>Ontleedopties</H3>
|
|
|
|
De volgende opties kunnen gebruikt worden om de uitvoer van de
|
|
changelog-ontleder te beïnvloeden, zoals bijvoorbeeld het assortiment items
|
|
of de indeling van de uitvoer.
|
|
<DL COMPACT>
|
|
<DT id="7"><B>--format</B><I> uitvoerindeling</I><DD>
|
|
Stel de indeling van de uitvoer in. Momenteel ondersteunde waarden zijn
|
|
<B>dpkg</B> en <B>rfc822</B>. <B>dpkg</B> is de klassieke indeling van de uitvoer (van
|
|
voor het bestaan van deze optie) en ook de standaard. Het bestaat uit één
|
|
paragraaf volgens het indelingssysteem van Debian control (zie
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-control">deb-control</A></B>(5)). Indien meer dan één item opgevraagd wordt, dan worden de
|
|
meeste velden genomen uit het eerste item (gewoonlijk het meest recente
|
|
item), tenzij anders vermeld:
|
|
<DL COMPACT><DT id="8"><DD>
|
|
<DL COMPACT>
|
|
<DT id="9"><B>Source:</B><I> pakketnaam</I><DD>
|
|
<DT id="10"><B>Version:</B><I> versie</I><DD>
|
|
<DT id="11"><B>Distribution:</B><I> doeldistributie</I><DD>
|
|
<DT id="12"><B>Urgency:</B><I> urgentie</I><DD>
|
|
Van alle opgenomen items wordt de hoogste urgentie gebruikt, gevolgd door de
|
|
samengevoegde (onderling door spaties gescheiden) commentaar van alle
|
|
opgevraagde versies.
|
|
<DT id="13"><B>Maintainer:</B><I> auteur</I><DD>
|
|
<DT id="14"><B>Date:</B><I> datum</I><DD>
|
|
De datum van het item als een tekenreeks, zoals die voorkomt in het
|
|
changelog-bestand. Met een <B><A HREF="/cgi-bin/man/man2html?3+strptime">strptime</A></B>(3)-indeling "<B>%a, %d %b %Y %T %z</B>",
|
|
maar waarbij het kan zijn dat de dag van de week niet echt overeenkomt met
|
|
de werkelijke dag die bekomen wordt uit de rest van de
|
|
datumtekenreeks. Indien u een meer accurate representatie van de datum nodig
|
|
heeft, moet u gebruik maken van het <B>Timestamp</B>-veld, maar u moet er
|
|
rekening mee houden dat het mogelijk is dat het niet meer exact terug
|
|
omgezet kan worden naar de waarde van dat veld.
|
|
<DT id="15"><B>Timestamp:</B><I> tijdsaanduiding</I><DD>
|
|
De datum van het item, uitgedrukt als een tijdstempel in aantal seconden
|
|
sinds de epoch (sinds dpkg 1.18.8).
|
|
<DT id="16"><B>Closes:</B><I> bug-nummer</I><DD>
|
|
De velden Closes van alle opgenomen items worden samengevoegd.
|
|
<DT id="17"><B>Changes:</B><I> changelog-items</I><DD>
|
|
De tekst van alle changelog-items wordt samengevoegd. Om van dit veld een
|
|
geldig veld te maken volgens de indeling van een Debian control-veld dat uit
|
|
meerdere regels bestaat, worden lege regels vervangen door één enkel punt en
|
|
springen alle regels in met één spatie. De exacte inhoud hangt af van de
|
|
changelog-indeling.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="18"><DD>
|
|
De velden <B>Version</B>, <B>Distribution</B>, <B>Urgency</B>, <B>Maintainer</B> en
|
|
<B>Changes</B> zijn verplicht.
|
|
<DT id="19"><DD>
|
|
Er kunnen nog bijkomende door de gebruiker aangemaakte velden gebruikt
|
|
worden.
|
|
<DT id="20"><DD>
|
|
De indeling volgens <B>rfc822</B> maakt gebruik van dezelfde velden, maar
|
|
gebruikt in de uitvoer een aparte paragraaf voor elk changelog-item, zodat
|
|
alle metadata van elk item behouden blijven.
|
|
<DT id="21"><B>--reverse</B><DD>
|
|
Voeg alle wijzigingen in omgekeerde volgorde in (sinds dpkg
|
|
1.19.1). Opmerking: voor de indeling <B>dpkg</B> zal het eerste item het oudste
|
|
item zijn.
|
|
<DT id="22"><B>--all</B><DD>
|
|
Neem alle wijzigingen op. Merk op dat andere opties geen effect hebben als
|
|
deze optie gebruikt wordt.
|
|
<DT id="23"><B>-s</B>, <B>--since</B> <I>versie</I><DD>
|
|
|
|
<B>-v</B> <I>versie</I>
|
|
Neem alle wijzigingen op die recenter zijn dan <I>versie</I>.
|
|
<DT id="24"><B>-u</B>, <B>--until</B> <I>versie</I><DD>
|
|
Neem alle wijzigingen op die gemaakt zijn voor <I>versie</I>.
|
|
<DT id="25"><B>-f</B>, <B>--from</B> <I>versie</I><DD>
|
|
Neem alle wijzigingen uit <I>versie</I> of later op.
|
|
<DT id="26"><B>-t</B>, <B>--to</B> <I>versie</I><DD>
|
|
Neem alle wijzigingen uit <I>versie</I> of vroeger op.
|
|
<DT id="27"><B>-c</B>, <B>--count</B> <I>aantal</I><DD>
|
|
|
|
<B>-n</B> <I>aantal</I>
|
|
Neem <I>aantal</I> items op te beginnen bij het begin (of bij het einde als
|
|
<I>aantal</I> kleiner is dan 0).
|
|
<DT id="28"><B>-o</B>, <B>--offset</B> <I>getal</I><DD>
|
|
Pas het beginpunt voor <B>--count</B> aan, te rekenen vanaf het begin (of het
|
|
einde als <I>getal</I> lager is dan 0).
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>CHANGELOG-INDELINGEN</H2>
|
|
|
|
Het is mogelijk om een andere indeling te gebruiken dan de standaardindeling
|
|
door te voorzien in een ontleedprogramma voor die alternatieve indeling.
|
|
<P>
|
|
Om er voor te zorgen dat <B>dpkg-parsechangelog</B> dat nieuw ontleedprogramma
|
|
uitvoert, moet binnen de laatste 40 regels van het changelog-bestand een
|
|
regel toegevoegd worden die voldoet aan de Perl reguliere expressie:
|
|
"<B>\schangelog-format:\s+([0-9a-z]+)\W</B>". Het deel tussen haakjes moet de
|
|
naam van de indeling zijn. Bijvoorbeeld:
|
|
<P>
|
|
<BR> @@@ changelog-format: <I>andere-indeling</I> @@@
|
|
<P>
|
|
Een naam voor een changelog-indelingen moet een niet-lege alfanumerieke
|
|
tekenreeks ("a-z0-9") zijn.
|
|
<P>
|
|
Indien een dergelijke regel bestaat, zal <B>dpkg-parsechangelog</B> naar het
|
|
ontleedprogramma zoeken als een <B>Dpkg::Changelog::</B><I>andere-indeling</I> perl
|
|
module. Het is een fout als die niet voorhanden is. De parsernaam in de
|
|
perlmodule zal automatisch in hoofdletters gezet worden. De standaard
|
|
changelog-indeling is <B>debian</B> en standaard is er voorzien in een programma
|
|
om ze te ontleden.
|
|
<P>
|
|
Het ontleedprogramma moet ontleend worden aan de Dpkg::Changelog-klasse en
|
|
moet de vereiste vastgelegde interface implementeren.
|
|
<P>
|
|
Indien de changelog-indeling die ontleed wordt altijd of bijna altijd een
|
|
witregel heeft tussen aparte notities in verband met wijzigingen, moeten die
|
|
lege regels weggenomen worden om als resultaat een compacte uitvoer te
|
|
bekomen.
|
|
<P>
|
|
Indien de changlog-indeling geen informatie bevat over data of pakketnaam,
|
|
dan moet die informatie in de uitvoer weggelaten worden. Het
|
|
ontleedprogramma moet niet proberen die informatie samen te stellen of ze in
|
|
andere bronnen gaan zoeken.
|
|
<P>
|
|
Indien het changelog-bestand niet de verwachte indeling gebruikt, moet het
|
|
ontleedprogramma afsluiten met een foutmelding, eerder dan te proberen er
|
|
zich doorheen te slaan en misschien foute uitvoer te genereren.
|
|
<P>
|
|
Een ontleedprogramma voor een changelog-bestand mag helemaal niet met de
|
|
gebruiker interageren.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>OPMERKINGEN</H2>
|
|
|
|
Alle <B>Parser Options</B> (ontleedopties) met uitzondering van <B>-v</B> worden
|
|
slechts sinds dpkg 1.14.16 ondersteund.
|
|
<P>
|
|
|
|
Het voor ontleeddoeleinden gebruiken van opties in verkorte notatie met
|
|
niet-samengebundelde waarden is slechts sinds dpkg 1.18.0 mogelijk.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>OMGEVING</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="29"><B>DPKG_COLORS</B><DD>
|
|
Stelt de kleurmodus in (sinds dpkg 1.18.5). Waarden die momenteel gebruikt
|
|
mogen worden zijn: <B>auto</B> (standaard), <B>always</B> en <B>never</B>.
|
|
<DT id="30"><B>DPKG_NLS</B><DD>
|
|
Indien dit ingesteld is, zal het gebruikt worden om te beslissen over het
|
|
activeren van moedertaalondersteuning, ook gekend als
|
|
internationaliseringsondersteuning (of i18n) (sinds dpkg 1.19.0). Geldige
|
|
waarden zijn: <B>0</B> and <B>1</B> (standaard).
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BESTANDEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="31"><B>debian/changelog</B><DD>
|
|
Het changelog-bestand dat gebruikt wordt om versieafhankelijke informatie
|
|
over het broncodepakket te verkrijgen, zoals de urgentie en de distributie
|
|
van een upload, de doorgevoerde aanpassingen sinds een bepaalde release en
|
|
het versienummer van de broncode zelf.
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>ZIE OOK</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-changelog">deb-changelog</A></B>(5).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="32"><A HREF="#lbAB">NAAM</A><DD>
|
|
<DT id="33"><A HREF="#lbAC">OVERZICHT</A><DD>
|
|
<DT id="34"><A HREF="#lbAD">BESCHRIJVING</A><DD>
|
|
<DT id="35"><A HREF="#lbAE">OPTIES</A><DD>
|
|
<DL>
|
|
<DT id="36"><A HREF="#lbAF">Ontleedopties</A><DD>
|
|
</DL>
|
|
<DT id="37"><A HREF="#lbAG">CHANGELOG-INDELINGEN</A><DD>
|
|
<DT id="38"><A HREF="#lbAH">OPMERKINGEN</A><DD>
|
|
<DT id="39"><A HREF="#lbAI">OMGEVING</A><DD>
|
|
<DT id="40"><A HREF="#lbAJ">BESTANDEN</A><DD>
|
|
<DT id="41"><A HREF="#lbAK">ZIE OOK</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:19 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|