NAAM

       dpkg-parsechangelog - ontleed Debian changelog-bestanden

OVERZICHT

       dpkg-parsechangelog [optie...]

BESCHRIJVING

       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.

OPTIES

       -l, --file 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 debian/changelog.

       -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 debian. Zie ook
              CHANGELOG FORMATS.

       -L bibliotheekmap
              Een uitgefaseerde optie zonder effect (sinds dpkg 1.18.8).  Het  instellen  van  de
              perl  omgevingsvariabelen PERL5LIB of PERLLIB heeft een gelijkaardig effect bij het
              zoeken naar de perl-modules van de ontleder (parser).

       -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.

       -?, --help
              Toon info over het gebruik en sluit af.

       --version
              Toon de versie en sluit af.

   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.

       --format uitvoerindeling
              Stel de indeling van de uitvoer in. Momenteel ondersteunde  waarden  zijn  dpkg  en
              rfc822. 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  systeem  van
              Debian control (zie deb-control(5)). Indien meer dan één item opgevraagd wordt, dan
              worden de meeste velden genomen uit het meest recente item, tenzij anders vermeld:

              Source: pakketnaam

              Version: versie

              Distribution: doeldistributie

              Urgency: urgentie
                     Van alle opgenomen items wordt de hoogste urgentie gebruikt, gevolgd door de
                     samengevoegde  (onderling  door  spaties  gescheiden)  commentaar  van  alle
                     opgevraagde versies.

              Maintainer: auteur

              Date: datum
                     De datum van het  item  als  een  tekenreeks,  zoals  die  voorkomt  in  het
                     changelog-bestand.  Met  een strptime(3)-indeling "%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  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.

              Timestamp: tijdsaanduiding
                     De  datum  van  het  item, uitgedrukt als een tijdstempel in aantal seconden
                     sinds de epoch (sinds dpkg 1.18.8).

              Closes: bug-nummer
                     De velden Closes van alle opgenomen items worden samengevoegd.

              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 één enkel punt en
                     springen  alle  regels  in  met één spatie. De exacte inhoud hangt af van de
                     changelog-indeling.

              De velden Version, Distribution, Urgency, Maintainer en Changes zijn verplicht.

              Er kunnen nog bijkomende door de gebruiker aangemaakte velden gebruikt worden.

              De indeling volgens 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.

       --all  Neem alle wijzigingen op. Merk op dat andere opties geen  effect  hebben  als  deze
              optie gebruikt wordt.

       -s, --since versie
       -v versie
              Neem alle wijzigingen op die recenter zijn dan versie.

       -u, --until versie
              Neem alle wijzigingen op die gemaakt zijn voor versie.

       -f, --from versie
              Neem alle wijzigingen uit versie of later op.

       -t, --to versie
              Neem alle wijzigingen uit versie of vroeger op.

       -c, --count aantal
       -n aantal
              Neem aantal items op te beginnen bij het begin (of bij het einde als aantal kleiner
              is dan 0).

       -o, --offset getal
              Pas het beginpunt voor --count aan, te rekenen vanaf het begin (of  het  einde  als
              getal lager is dan 0).

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 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: “\schangelog-format:\s+([0-9a-z]+)\W”.  Het  deel
       tussen haakjes moet de naam van de indeling zijn. Bijvoorbeeld:

              @@@ changelog-format: andere-indeling @@@

       Namen voor changelog-indelingen moeten niet-lege alfanumerieke tekenreeksen zijn.

       Indien  een  dergelijke  regel  bestaat, zal dpkg-parsechangelog naar het ontleedprogramma
       zoeken als een Dpkg::Changelog::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 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.

OPMERKINGEN

       Alle  Parser  Options  (ontleedopties)  met  uitzondering van -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.

BESTANDEN

       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.

ZIE OOK

       deb-changelog(5).