1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
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).
|
