.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "dpkg-parsechangelog 1" .TH dpkg-parsechangelog 1 2024-01-19 1.22.3 "dpkg suite" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAAM .IX Header "NAAM" dpkg-parsechangelog \- ontleed Debian changelog-bestanden .SH OVERZICHT .IX Header "OVERZICHT" \&\fBdpkg-parsechangelog\fR [\fIoptie\fR...] .SH BESCHRIJVING .IX Header "BESCHRIJVING" \&\fBdpkg-parsechangelog\fR 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. .SH OPTIES .IX Header "OPTIES" .IP "\fB\-l\fR, \fB\-\-file\fR \fIchangelog-bestand\fR" 4 .IX Item "-l, --file changelog-bestand" Geeft het changelog-bestand op waaruit gelezen moet worden. Een \(oq\-\(cq kan gebruikt worden om aan te geven dat van de standaardinvoer gelezen moet worden. De standaard is \fBdebian/changelog\fR. .IP "\fB\-F\fR \fIchangelog-indeling\fR" 4 .IX Item "-F changelog-indeling" 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 \fBdebian\fR. Zie ook \fBCHANGELOG FORMATS\fR. .IP "\fB\-L\fR \fIbibliotheekmap\fR" 4 .IX Item "-L bibliotheekmap" Een uitgefaseerde optie zonder effect (sinds dpkg 1.18.8). Het instellen van de perl omgevingsvariabelen \fBPERL5LIB\fR of \fBPERLLIB\fR heeft een gelijkaardig effect bij het zoeken naar de perl-modules van de ontleder (parser). .IP "\fB\-S\fR, \fB\-\-show\-field\fR \fIveld\fR" 4 .IX Item "-S, --show-field veld" 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. .IP "\fB\-?\fR, \fB\-\-help\fR" 4 .IX Item "-?, --help" Info tonen over het gebruik en afsluiten. .IP \fB\-\-version\fR 4 .IX Item "--version" De versie tonen en afsluiten. .SS Ontleedopties .IX Subsection "Ontleedopties" De volgende opties kunnen gebruikt worden om de uitvoer van de changelog-ontleder te be\(:invloeden, zoals bijvoorbeeld het assortiment items of de indeling van de uitvoer. .IP "\fB\-\-format\fR \fIuitvoerindeling\fR" 4 .IX Item "--format uitvoerindeling" De indeling van de uitvoer instellen. Momenteel ondersteunde waarden zijn \fBdpkg\fR en \fBrfc822\fR. \fBdpkg\fR is de klassieke indeling van de uitvoer (van voor het bestaan van deze optie) en ook de standaard. Het bestaat uit \('e\('en onderdeel volgens het indelingssysteem van Debian control (zie \fBdeb\-control\fR\|(5)). Indien meer dan \('e\('en item opgevraagd wordt, dan worden de meeste velden genomen uit het eerste item (gewoonlijk het meest recente item), tenzij anders vermeld: .RS 4 .IP "\fBSource:\fR \fIpakketnaam\fR" 4 .IX Item "Source: pakketnaam" De naam van het broncodepakket. .IP "\fBVersion:\fR \fIversie\fR" 4 .IX Item "Version: versie" Het versienummer van de broncode. \fBOpmerking\fR: Voor releases die uitsluitend binair zijn, is er mogelijk geen overeenkomstige broncoderelease. .IP "\fBDistribution:\fR \fIdoeldistributie\fR" 4 .IX Item "Distribution: doeldistributie" Een door spaties gescheiden lijst van een of meer namen van distributies waarin deze versie ondergebracht moet worden als ze ge\(:upload wordt. .IP "\fBUrgency:\fR \fIurgentie\fR" 4 .IX Item "Urgency: urgentie" Van alle opgenomen items wordt de hoogste urgentie gebruikt, gevolgd door de samengevoegde (onderling door spaties gescheiden) commentaar van alle opgevraagde versies. .IP "\fBMaintainer:\fR \fIauteur\fR" 4 .IX Item "Maintainer: auteur" De naam en het e\-mailadres van de persoon die deze wijzigingen heeft voorbereid, dit zijn \fBniet\fR noodzakelijkerwijs die van de uploader of de gebruikelijke pakketbeheerder. .IP "\fBDate:\fR \fIdatum\fR" 4 .IX Item "Date: datum" De datum van het item als een tekenreeks, zoals die voorkomt in het changelog-bestand. Met een \fBstrptime\fR\|(3)\-opmaak "\fR\f(CB%a\fR\fB, \fR\f(CB%d\fR\fB \fR\f(CB%b\fR\fB \fR\f(CB%Y\fR\fB \fR\f(CB%T\fR\fB \fR\f(CB%z\fR\fB\fR", 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 \fBTimestamp\fR\-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. .IP "\fBTimestamp:\fR \fItijdsaanduiding\fR" 4 .IX Item "Timestamp: tijdsaanduiding" De datum van het item, uitgedrukt als een tijdstempel in aantal seconden sinds de epoch (sinds dpkg 1.18.8). .IP "\fBCloses:\fR \fIbug-nummer\fR" 4 .IX Item "Closes: bug-nummer" De velden Closes van alle opgenomen items worden samengevoegd. .IP "\fBChanges:\fR \fIchangelog-items\fR" 4 .IX Item "Changes: changelog-items" 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 \('e\('en enkel punt en springen alle regels in met \('e\('en spatie. De exacte inhoud hangt af van de changelog-indeling. .RE .RS 4 .Sp De velden \fBVersion\fR, \fBDistribution\fR, \fBUrgency\fR, \fBMaintainer\fR en \fBChanges\fR zijn verplicht. .Sp Er kunnen nog bijkomende door de gebruiker aangemaakte velden gebruikt worden. .Sp De indeling volgens \fBrfc822\fR maakt gebruik van dezelfde velden, maar gebruikt in de uitvoer een apart onderdeel voor elk changelog-item, zodat alle metadata van elk item behouden blijven. .RE .IP \fB\-\-reverse\fR 4 .IX Item "--reverse" Alle wijzigingen in omgekeerde volgorde opnemen (sinds dpkg 1.19.1). .Sp \&\fBOpmerking\fR: voor de indeling \fBdpkg\fR zal het eerste item het oudste item zijn. .IP \fB\-\-all\fR 4 .IX Item "--all" Alle wijzigingen opnemen. \fBOpmerking\fR: andere opties hebben geen effect als deze optie gebruikt wordt. .IP "\fB\-s\fR, \fB\-\-since\fR \fIversie\fR" 4 .IX Item "-s, --since versie" .PD 0 .IP "\fB\-v\fR \fIversie\fR" 4 .IX Item "-v versie" .PD Alle wijzigingen opnemen die recenter zijn dan \fIversie\fR. .IP "\fB\-u\fR, \fB\-\-until\fR \fIversie\fR" 4 .IX Item "-u, --until versie" Alle wijzigingen opnemen die aangebracht zijn voor \fIversie\fR. .IP "\fB\-f\fR, \fB\-\-from\fR \fIversie\fR" 4 .IX Item "-f, --from versie" Alle wijzigingen uit \fIversie\fR of later opnemen. .IP "\fB\-t\fR, \fB\-\-to\fR \fIversie\fR" 4 .IX Item "-t, --to versie" Alle wijzigingen uit \fIversie\fR of vroeger opnemen. .IP "\fB\-c\fR, \fB\-\-count\fR \fIaantal\fR" 4 .IX Item "-c, --count aantal" .PD 0 .IP "\fB\-n\fR \fIaantal\fR" 4 .IX Item "-n aantal" .PD \&\fIaantal\fR items opnemen, te beginnen bij het begin (of bij het einde als \fIaantal\fR kleiner is dan 0). .IP "\fB\-o\fR, \fB\-\-offset\fR \fIgetal\fR" 4 .IX Item "-o, --offset getal" Het beginpunt voor \fB\-\-count\fR aanpassen, te rekenen vanaf het begin (of het einde als \fIgetal\fR lager is dan 0). .SH CHANGELOG-INDELINGEN .IX Header "CHANGELOG-INDELINGEN" Het is mogelijk om een andere indeling te gebruiken dan de standaardindeling door te voorzien in een ontleedprogramma voor die alternatieve indeling. .PP Om er voor te zorgen dat \fBdpkg-parsechangelog\fR 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: \(lq\fB\eschangelog\-format:\es+([0\-9a\-z]+)\eW\fR\(rq. Het deel tussen haakjes moet de naam van de indeling zijn. Bijvoorbeeld: .Sp .RS 4 @@@ changelog-format: \fIandere-indeling\fR @@@ .RE .PP Een naam voor een changelog-indelingen moet een niet-lege alfanumerieke tekenreeks (\(lqa\-z0\-9\(rq) zijn. .PP Indien een dergelijke regel bestaat, zal \fBdpkg-parsechangelog\fR naar het ontleedprogramma zoeken als een \fBDpkg::Changelog::\fR\fIandere-indeling\fR 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 \fBdebian\fR en standaard is er voorzien in een programma om ze te ontleden. .PP Het ontleedprogramma moet ontleend worden aan de Dpkg::Changelog\-klasse en moet de vereiste vastgelegde interface implementeren. .PP 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. .PP 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. .PP 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. .PP Een ontleedprogramma voor een changelog-bestand mag helemaal niet met de gebruiker interageren. .SH OPMERKINGEN .IX Header "OPMERKINGEN" Alle \fBParser Options\fR (ontleedopties) met uitzondering van \fB\-v\fR worden slechts sinds dpkg 1.14.16 ondersteund. .PP Het voor ontleeddoeleinden gebruiken van opties in verkorte notatie met niet-samengebundelde waarden is slechts sinds dpkg 1.18.0 mogelijk. .SH OMGEVING .IX Header "OMGEVING" .IP \fBDPKG_COLORS\fR 4 .IX Item "DPKG_COLORS" Stelt de kleurmodus in (sinds dpkg 1.18.5). Waarden die momenteel gebruikt mogen worden zijn: \fBauto\fR (standaard), \fBalways\fR en \fBnever\fR. .IP \fBDPKG_NLS\fR 4 .IX Item "DPKG_NLS" 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: \fB0\fR and \fB1\fR (standaard). .SH BESTANDEN .IX Header "BESTANDEN" .IP \fBdebian/changelog\fR 4 .IX Item "debian/changelog" 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. .SH BUGS .IX Header "BUGS" Het veld \fBMaintainer\fR heeft een verwarrende naam die overeenkomt met het veld in het bestand \fIdebian/control\fR, maar niet met zijn exacte semantiek, waarbij de betekenis beter zou worden weergegeven door de veldnaam \fBChanged-By\fR die wordt gebruikt in het bestand \fI.changes\fR. .SH "ZIE OOK" .IX Header "ZIE OOK" \&\fBdeb\-changelog\fR\|(5).