diff options
Diffstat (limited to '')
-rw-r--r-- | man/nl/dpkg-parsechangelog.pod | 274 |
1 files changed, 274 insertions, 0 deletions
diff --git a/man/nl/dpkg-parsechangelog.pod b/man/nl/dpkg-parsechangelog.pod new file mode 100644 index 0000000..227a026 --- /dev/null +++ b/man/nl/dpkg-parsechangelog.pod @@ -0,0 +1,274 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NAAM + +dpkg-parsechangelog - ontleed Debian changelog-bestanden + +=head1 OVERZICHT + +B<dpkg-parsechangelog> [I<optie>...] + +=head1 BESCHRIJVING + +B<dpkg-parsechangelog> 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. + +=head1 OPTIES + +=over + +=item B<-l>, B<--file> I<changelog-bestand> + +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>. + +=item B<-F> I<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 B<debian>. Zie ook B<CHANGELOG FORMATS>. + +=item B<-L> I<bibliotheekmap> + +Een uitgefaseerde optie zonder effect (sinds dpkg 1.18.8). Het instellen van +de perl omgevingsvariabelen B<PERL5LIB> of B<PERLLIB> heeft een gelijkaardig +effect bij het zoeken naar de perl-modules van de ontleder (parser). + +=item B<-S>, B<--show-field> I<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. + +=item B<-?>, B<--help> + +Info tonen over het gebruik en afsluiten. + +=item B<--version> + +De versie tonen en afsluiten. + +=back + +=head2 Ontleedopties + +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. + +=over + +=item B<--format> I<uitvoerindeling> + +Stel de indeling van de uitvoer in. Momenteel ondersteunde waarden zijn +B<dpkg> en B<rfc822>. B<dpkg> 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<deb-control>(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: + +=over + +=item B<Source:> I<pakketnaam> + +=item B<Version:> I<versie> + +=item B<Distribution:> I<doeldistributie> + +=item B<Urgency:> I<urgentie> + +Van alle opgenomen items wordt de hoogste urgentie gebruikt, gevolgd door de +samengevoegde (onderling door spaties gescheiden) commentaar van alle +opgevraagde versies. + +=item B<Maintainer:> I<auteur> + +=item B<Date:> I<datum> + +De datum van het item als een tekenreeks, zoals die voorkomt in het +changelog-bestand. Met een B<strptime>(3)-indeling "B<%a, %d %b %Y %T %z>", +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>-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. + +=item B<Timestamp:> I<tijdsaanduiding> + +De datum van het item, uitgedrukt als een tijdstempel in aantal seconden +sinds de epoch (sinds dpkg 1.18.8). + +=item B<Closes:> I<bug-nummer> + +De velden Closes van alle opgenomen items worden samengevoegd. + +=item B<Changes:> I<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 één enkel punt en +springen alle regels in met één spatie. De exacte inhoud hangt af van de +changelog-indeling. + +=back + +De velden B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> en +B<Changes> zijn verplicht. + +Er kunnen nog bijkomende door de gebruiker aangemaakte velden gebruikt +worden. + +De indeling volgens B<rfc822> 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. + +=item B<--reverse> + +Alle wijzigingen in omgekeerde volgorde opnemen (sinds dpkg 1.19.1). + +B<Opmerking:> voor de indeling B<dpkg> zal het eerste item het oudste item +zijn. + +=item B<--all> + +Alle wijzigingen opnemen. B<Opmerking:> andere opties hebben geen effect als +deze optie gebruikt wordt. + +=item B<-s>, B<--since> I<versie> + +=item B<-v> I<versie> + +Alle wijzigingen opnemen die recenter zijn dan I<versie>. + +=item B<-u>, B<--until> I<versie> + +Alle wijzigingen opnemen die aangebracht zijn voor I<versie>. + +=item B<-f>, B<--from> I<versie> + +Alle wijzigingen uit I<versie> of later opnemen. + +=item B<-t>, B<--to> I<versie> + +Alle wijzigingen uit I<versie> of vroeger opnemen. + +=item B<-c>, B<--count> I<aantal> + +=item B<-n> I<aantal> + +I<aantal> items opnemen, te beginnen bij het begin (of bij het einde als +I<aantal> kleiner is dan 0). + +=item B<-o>, B<--offset> I<getal> + +Het beginpunt voor B<--count> aanpassen, te rekenen vanaf het begin (of het +einde als I<getal> lager is dan 0). + +=back + +=head1 CHANGELOG-INDELINGEN + +Het is mogelijk om een andere indeling te gebruiken dan de standaardindeling +door te voorzien in een ontleedprogramma voor die alternatieve indeling. + +Om er voor te zorgen dat B<dpkg-parsechangelog> 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>”. Het deel tussen haakjes moet de +naam van de indeling zijn. Bijvoorbeeld: + +=over + +@@@ changelog-format: I<andere-indeling> @@@ + +=back + +Een naam voor een changelog-indelingen moet een niet-lege alfanumerieke +tekenreeks (“a-z0-9”) zijn. + +Indien een dergelijke regel bestaat, zal B<dpkg-parsechangelog> naar het +ontleedprogramma zoeken als een B<Dpkg::Changelog::>I<andere-indeling> 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> en standaard is er voorzien in een programma +om ze te ontleden. + +Het ontleedprogramma moet ontleend worden aan de Dpkg::Changelog-klasse en +moet de vereiste vastgelegde interface implementeren. + +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. + +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. + +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. + +Een ontleedprogramma voor een changelog-bestand mag helemaal niet met de +gebruiker interageren. + +=head1 OPMERKINGEN + +Alle B<Parser Options> (ontleedopties) met uitzondering van B<-v> worden +slechts sinds dpkg 1.14.16 ondersteund. + +Het voor ontleeddoeleinden gebruiken van opties in verkorte notatie met +niet-samengebundelde waarden is slechts sinds dpkg 1.18.0 mogelijk. + +=head1 OMGEVING + +=over + +=item B<DPKG_COLORS> + +Stelt de kleurmodus in (sinds dpkg 1.18.5). Waarden die momenteel gebruikt +mogen worden zijn: B<auto> (standaard), B<always> en B<never>. + +=item B<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: B<0> and B<1> (standaard). + +=back + +=head1 BESTANDEN + +=over + +=item B<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. + +=back + +=head1 ZIE OOK + +B<deb-changelog>(5). + |