chiark - git - mdw - dpkg/blob - man/nl/dpkg-parsechangelog.man

   1 .\" dpkg manual page - dpkg-parsechangelog(1)
   2 .\"
   3 .\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk>
   4 .\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org>
   5 .\" Copyright © 2006, 2011-2015 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 <https://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 %RELEASE_DATE% %VERSION% dpkg\-suite
  28 .nh
  29 .SH NAAM
  30 dpkg\-parsechangelog \- ontleed Debian changelog\-bestanden
  31 .
  32 .SH OVERZICHT
  33 \fBdpkg\-parsechangelog\fP [\fIoptie\fP...]
  34 .
  35 .SH BESCHRIJVING
  36 \fBdpkg\-parsechangelog\fP leest en ontleedt het bestand changelog van een
  37 uitgepakte Debian broncodeboom en geeft de informatie eruit in een door een
  38 machine te lezen vorm weer op de standaarduitvoer.
  39 .
  40 .SH OPTIES
  41 .TP
  42 \fB\-l\fP, \fB\-\-file\fP \fIchangelog\-bestand\fP
  43 Geeft het changelog\-bestand op waaruit gelezen moet worden. Een ‘\-’ kan
  44 gebruikt worden om aan te geven dat van de standaardinvoer gelezen moet
  45 worden. De standaard is \fBdebian/changelog\fP.
  46 .TP
  47 \fB\-F\fP \fIchangelog\-indeling\fP
  48 Geeft de indeling van het changelog\-bestand aan. Standaard wordt die
  49 indeling gelezen van een bijzondere regel dicht bij het einde van het
  50 changelog\-bestand en als dat mislukt, wordt er teruggevallen op de
  51 standaardindeling van \fBdebian\fP. Zie ook \fBCHANGELOG FORMATS\fP.
  52 .TP
  53 \fB\-L\fP \fIbibliotheekmap\fP
  54 Een uitgefaseerde optie zonder effect (sinds dpkg 1.18.8). Het instellen van
  55 de perl omgevingsvariabelen \fBPERL5LIB\fP of \fBPERLLIB\fP heeft een gelijkaardig
  56 effect bij het zoeken naar de perl\-modules van de ontleder (parser).
  57 .TP
  58 \fB\-S\fP, \fB\-\-show\-field\fP \fIveld\fP
  59 Geeft de naam op van het te tonen veld (sinds dpkg 1.17.0). De naam van het
  60 veld wordt niet weergegeven, enkel de inhoud ervan.
  61 .TP
  62 \fB\-?\fP, \fB\-\-help\fP
  63 Toon info over het gebruik en sluit af.
  64 .TP
  65 \fB\-\-version\fP
  66 Toon de versie en sluit af.
  67 .SS Ontleedopties
  68 De volgende opties kunnen gebruikt worden om de uitvoer van de
  69 changelog\-ontleder te beïnvloeden, zoals bijvoorbeeld het assortiment items
  70 of de indeling van de uitvoer.
  71 .TP
  72 \fB\-\-format\fP\fI uitvoerindeling\fP
  73 Stel de indeling van de uitvoer in. Momenteel ondersteunde waarden zijn
  74 \fBdpkg\fP en \fBrfc822\fP. \fBdpkg\fP is de klassieke indeling van de uitvoer (van
  75 voor het bestaan van deze optie) en ook de standaard. Het bestaat uit één
  76 paragraaf volgens het systeem van Debian control (zie
  77 \fBdeb\-control\fP(5)). Indien meer dan één item opgevraagd wordt, dan worden de
  78 meeste velden genomen uit het meest recente item, tenzij anders vermeld:
  79 .RS
  80 .TP
  81 \fBSource:\fP\fI pakketnaam\fP
  82 .TP
  83 \fBVersion:\fP\fI versie\fP
  84 .TP
  85 \fBDistribution:\fP\fI doeldistributie\fP
  86 .TP
  87 \fBUrgency:\fP\fI urgentie\fP
  88 Van alle opgenomen items wordt de hoogste urgentie gebruikt, gevolgd door de
  89 samengevoegde (onderling door spaties gescheiden) commentaar van alle
  90 opgevraagde versies.
  91 .TP
  92 \fBMaintainer:\fP\fI auteur\fP
  93 .TP
  94 \fBDate:\fP\fI datum\fP
  95 De datum van het item als een tekenreeks, zoals die voorkomt in het
  96 changelog\-bestand. Met een \fBstrptime\fP(3)\-indeling "\fB%a, %d %b %Y %T %z\fP",
  97 maar waarbij het kan zijn dat de dag van de week niet echt overeenkomt met
  98 de werkelijke dag die bekomen wordt uit de rest van de
  99 datumtekenreeks. Indien u een meer accurate representatie van de datum nodig
 100 heeft, moet u gebruik maken van het \fBTimestamp\fP\-veld, maar u moet er
 101 rekening mee houden dat het mogelijk is dat het niet meer exact terug
 102 omgezet kan worden naar de waarde van dat veld.
 103 .TP
 104 \fBTimestamp:\fP\fI tijdsaanduiding\fP
 105 De datum van het item, uitgedrukt als een tijdstempel in aantal seconden
 106 sinds de epoch (sinds dpkg 1.18.8).
 107 .TP
 108 \fBCloses:\fP\fI bug\-nummer\fP
 109 De velden Closes van alle opgenomen items worden samengevoegd.
 110 .TP
 111 \fBChanges:\fP\fI changelog\-items\fP
 112 De tekst van alle changelog\-items wordt samengevoegd. Om van dit veld een
 113 geldig veld te maken volgens de indeling van een Debian control\-veld dat uit
 114 meerdere regels bestaat, worden lege regels vervangen door één enkel punt en
 115 springen alle regels in met één spatie. De exacte inhoud hangt af van de
 116 changelog\-indeling.
 117 .RE
 118 .IP
 119 De velden \fBVersion\fP, \fBDistribution\fP, \fBUrgency\fP, \fBMaintainer\fP en
 120 \fBChanges\fP zijn verplicht.
 121 .IP
 122 Er kunnen nog bijkomende door de gebruiker aangemaakte velden gebruikt
 123 worden.
 124 .IP
 125 De indeling volgens \fBrfc822\fP maakt gebruik van dezelfde velden, maar
 126 gebruikt in de uitvoer een aparte paragraaf voor elk changelog\-item, zodat
 127 alle metadata van elk item behouden blijven.
 128 .TP
 129 \fB\-\-all\fP
 130 Neem alle wijzigingen op. Merk op dat andere opties geen effect hebben als
 131 deze optie gebruikt wordt.
 132 .TP
 133 \fB\-s\fP, \fB\-\-since\fP \fIversie\fP
 134 .TQ
 135 \fB\-v\fP \fIversie\fP
 136 Neem alle wijzigingen op die recenter zijn dan \fIversie\fP.
 137 .TP
 138 \fB\-u\fP, \fB\-\-until\fP \fIversie\fP
 139 Neem alle wijzigingen op die gemaakt zijn voor \fIversie\fP.
 140 .TP
 141 \fB\-f\fP, \fB\-\-from\fP \fIversie\fP
 142 Neem alle wijzigingen uit \fIversie\fP of later op.
 143 .TP
 144 \fB\-t\fP, \fB\-\-to\fP \fIversie\fP
 145 Neem alle wijzigingen uit \fIversie\fP of vroeger op.
 146 .TP
 147 \fB\-c\fP, \fB\-\-count\fP \fIaantal\fP
 148 .TQ
 149 \fB\-n\fP \fIaantal\fP
 150 Neem \fIaantal\fP items op te beginnen bij het begin (of bij het einde als
 151 \fIaantal\fP kleiner is dan 0).
 152 .TP
 153 \fB\-o\fP, \fB\-\-offset\fP \fIgetal\fP
 154 Pas het beginpunt voor \fB\-\-count\fP aan, te rekenen vanaf het begin (of het
 155 einde als \fIgetal\fP lager is dan 0).
 156 .
 157 .SH CHANGELOG\-INDELINGEN
 158 Het is mogelijk om een andere indeling te gebruiken dan de standaardindeling
 159 door te voorzien in een ontleedprogramma voor die alternatieve indeling.
 160
 161 Om er voor te zorgen dat \fBdpkg\-parsechangelog\fP dat nieuw ontleedprogramma
 162 uitvoert, moet binnen de laatste 40 regels van het changelog\-bestand een
 163 regel toegevoegd worden die voldoet aan de Perl reguliere expressie:
 164 “\fB\eschangelog\-format:\es+([0\-9a\-z]+)\eW\fP”. Het deel tussen haakjes moet de
 165 naam van de indeling zijn. Bijvoorbeeld:
 166
 167        @@@ changelog\-format: \fIandere\-indeling\fP @@@
 168
 169 Namen voor changelog\-indelingen moeten niet\-lege alfanumerieke tekenreeksen
 170 zijn.
 171
 172 Indien een dergelijke regel bestaat, zal \fBdpkg\-parsechangelog\fP naar het
 173 ontleedprogramma zoeken als een \fBDpkg::Changelog::\fP\fIandere\-indeling\fP perl
 174 module. Het is een fout als die niet voorhanden is. De parsernaam in de
 175 perlmodule zal automatisch in hoofdletters gezet worden. De standaard
 176 changelog\-indeling is \fBdebian\fP en standaard is er voorzien in een programma
 177 om ze te ontleden.
 178
 179 Het ontleedprogramma moet ontleend worden aan de Dpkg::Changelog\-klasse en
 180 moet de vereiste vastgelegde interface implementeren.
 181
 182 Indien de changelog\-indeling die ontleed wordt altijd of bijna altijd een
 183 witregel heeft tussen aparte notities in verband met wijzigingen, moeten die
 184 lege regels weggenomen worden om als resultaat een compacte uitvoer te
 185 bekomen.
 186
 187 Indien de changlog\-indeling geen informatie bevat over data of pakketnaam,
 188 dan moet die informatie in de uitvoer weggelaten worden. Het
 189 ontleedprogramma moet niet proberen die informatie samen te stellen of ze in
 190 andere bronnen gaan zoeken.
 191
 192 Indien het changelog\-bestand niet de verwachte indeling gebruikt, moet het
 193 ontleedprogramma afsluiten met een foutmelding, eerder dan te proberen er
 194 zich doorheen te slaan en misschien foute uitvoer te genereren.
 195
 196 Een ontleedprogramma voor een changelog\-bestand mag helemaal niet met de
 197 gebruiker interageren.
 198 .
 199 .SH OPMERKINGEN
 200 Alle \fBParser Options\fP (ontleedopties) met uitzondering van \fB\-v\fP worden
 201 slechts sinds dpkg 1.14.16 ondersteund.
 202 .PP
 203 Het voor ontleeddoeleinden gebruiken van opties in verkorte notatie met
 204 niet\-samengebundelde waarden is slechts sinds dpkg 1.18.0 mogelijk.
 205 .
 206 .SH BESTANDEN
 207 .TP
 208 \fBdebian/changelog\fP
 209 Het changelog\-bestand dat gebruikt wordt om versieafhankelijke informatie
 210 over het broncodepakket te verkrijgen, zoals de urgentie en de distributie
 211 van een upload, de doorgevoerde aanpassingen sinds een bepaalde release en
 212 het versienummer van de broncode zelf.
 213 .
 214 .SH "ZIE OOK"
 215 \fBdeb\-changelog\fP(5).