Commit | Line | Data |
---|---|---|
1479465f GJ |
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). |