summaryrefslogtreecommitdiffstats
path: root/man/nl/deb-changes.pod
blob: 4e7766d552cef127bac56867d4873f30b654133b (plain)
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
        *****************************************************
        *           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

deb-changes - Indeling van het Debian changes-bestand

=head1 OVERZICHT

I<bestandsnaam>B<.changes>

=head1 BESCHRIJVING

Elke Debian-upload bestaat uit een controlebestand .changes, dat een aantal
velden bevat in L<deb822(5)>-indeling.

Ieder veld begint met een markering, zoals B<Source> of B<Binary> (niet
hoofdlettergevoelig), gevolgd door een dubbele punt en de tekstinhoud van
het veld (hoofdlettergevoelig tenzij anders vermeld. Velden worden enkel
door veldmarkeringen begrensd. De tekstinhoud van het veld kan met andere
woorden verschillende regels lang zijn, maar de installatiegereedschappen
zullen bij het verwerken van de tekstinhoud de regels gewoonlijk samenvoegen
(behalve voor de multiregel-velden B<Description>, B<Changes>, B<Files>,
B<Checksums-Sha1> en B<Checksums-Sha256>; zie hierna)

De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met
ASCII-harnas volgens de specificatie RFC4880.

=head1 VELDEN

=over 

=item B<Format:> I<indelingsversie> (verplicht)

De waarde van dit veld bepaalt de indelingsversie van het bestand. De
syntaxis van de veldwaarde is een versienummer met een hoofdversie- en een
onderversiecomponent. Wijzigingen aan de indeling die niet neerwaarts
compatibel zijn, hebben een verhoging van het hoofdversienummer tot gevolg
en neerwaarts compatibele veranderingen (zoals het toevoegen van extra
velden) verhogen het onderversienummer. De huidige indelingsversie is
B<1.8>.

=item B<Date:> I<datum-van-uitgave> (verplicht)

De datum waarop het pakket gebouwd werd of het laatst bewerkt. Hij moet in
dezelfde indeling opgemaakt zijn als de datum in een
B<deb-changelog>(5)-item.

De waarde van dit veld wordt meestal gehaald uit het bestand
I<debian/changelog>.

=item B<Source:> I<broncode-naam> [B<(>I<broncode-versie>B<)>] (verplicht)

De naam van het broncodepakket. Indien de versie van het broncodepakket
verschilt van de versie van het binaire pakket, dan zal de I<broncode-naam>
gevolgd worden door een I<broncode-versie> tussen haakjes. Dit kan het geval
zijn als de upload een uitsluitend binaire upload is die niet door de
onderhouder uitgevoerd wordt.

=item B<Binary:> I<lijst-binaire-pakketten> (vereist in de context)

Dit gevouwen veld is een lijst, met spatie als scheidingsteken, van binaire
pakketten die geüpload moeten worden. Indien het een upload is van enkel
broncode, dan wordt het veld weggelaten (sinds dpkg 1.19.3).

=item B<Architecture:> I<arch-lijst>

Somt de architecturen op van de bestanden die momenteel geüpload
worden. Gebruikelijke architecturen zijn B<amd64>, B<armel>, B<i386>,
enz. Merk op dat de waarde B<all> bedoeld is voor pakketten die
architectuuronafhankelijk zijn. Indien ook de broncode voor het pakket
geüpload wordt, wordt tevens de bijzondere vermelding B<source>
toegevoegd. Jokertekens voor architecturen mogen nooit voorkomen in de
lijst.

=item B<Version:> I<versie-tekenreeks> (verplicht)

Gewoonlijk is dit het originele versienummer van het pakket, welke vorm de
auteur van het programma er ook voor gebruikt. Het kan ook een
Debian-revisienummer bevatten (voor niet uit Debian stammende pakketten). De
exacte indeling en het sorteringsalgoritme worden beschreven in
B<deb-version>(7).

=item B<Distribution:> I<distributie>s (verplicht)

Somt een of meer met een spatie van elkaar gescheiden distributies op waarin
deze versie ondergebracht moet worden als het geüpload wordt naar het
archief.

=item B<Urgency:> I<urgentie> (aanbevolen)

De dringendheid van de upload. De momenteel toegelaten waarden, in oplopende
volgorde van dringendheid, zijn: B<low>, B<medium>, B<high>, B<critical> en
B<emergency>.

=item B<Maintainer:> I<volledige-naam-en-e-mail> (verplicht)

Moet opgemaakt worden volgens de indeling “Joe Bloggs
E<lt>jbloggs@example.orgE<gt>”, en is gewoonlijk de persoon die het pakket
maakte, in tegenstelling tot de auteur van de verpakte software.

=item B<Changed-By:> I<volledige-naam-en-e-mailadres>

Moet opgemaakt worden volgens de indeling “Joe Bloggs
E<lt>jbloggs@example.orgE<gt>”, en is gewoonlijk de persoon die voor deze
release verantwoordelijk is voor de veranderingen aan het pakket.

=item B<Description:> (aanbevolen)

=item S< >I<naam-binaire-pakket> B<-> I<samenvatting-binaire-pakket>

Dit multiregel-veld bevat een lijst met de naam van de binaire pakketten,
gevolgd door een spatie, een koppelteken (‘B<->’) en hun eventueel afgekapte
korte beschrijving. Indien het een upload is van enkel broncode, dan wordt
het veld weggelaten (sinds dpkg 1.19.3).

=item B<Closes:> I<bug-nummer-lijst>

Een lijst van met komma's van elkaar gescheiden nummers van bugrapporten die
door deze upload opgelost worden. De archiefsoftware van de distributie kan
dit veld gebruiken om automatisch de vermelde bugnummers te sluiten in het
opvolgingssysteem voor bugs van de distributie.

=item B<Binary-Only: yes>

Dit veld geeft aan dat deze upload gebeurt na de niet door de
pakketonderhouder uitgevoerde bouw van uitsluitend het binaire pakket. Het
vindt zijn oorsprong in het item met de sleutel/waarde-combinatie
B<binary-only=yes> uit de metadata van het changelog-bestand.

=item B<Built-For-Profiles:> I<profiel-lijst>

Dit veld somt een lijst van door een spatie van elkaar gescheiden
bouwprofielen op waarmee deze upload gebouwd werd.

=item B<Changes:> (verplicht)

=item S< >I<changelog-items>

Dit multiregel-veld bevat de samengevoegde tekst van alle changelog-items
die deel uitmaken van de upload. Om van dit veld een geldig multiregel-veld
te maken, 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.

=item B<Files:> (verplicht)

=item S< >I<md5som> I<grootte> I<sectie> I<prioriteit> I<bestandsnaam>

Dit multiregel-veld bevat een bestandslijst met voor elk bestand de
vermelding van de md5som, grootte, sectie en prioriteit.

De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als
de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van
het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke
regel bestaat uit elementen die onderling gescheiden zijn door een spatie en
het bestand beschrijven: zijn md5som, zijn bestandsgrootte, zijn sectie,
zijn prioriteit en zijn naam.

Dit veld somt alle bestanden op die deel uitmaken van de upload. De lijst
van bestanden uit dit veld moet overeenkomen met de bestandslijst in de
andere gerelateerde B<Checksums>-velden.

=item B<Checksums-Sha1:> (verplicht)

=item B<Checksums-Sha256:> (verplicht)

=item S< >I<controlesom> I<grootte> I<bestandsnaam>

Deze multiregel-velden bevatten een lijst van bestanden met een controlesom
en een bestandsgrootte voor elk van hen. Deze velden gebruiken dezelfde
syntaxis en verschillen onderling enkel in het gebruikte algoritme voor het
berekenen van de controlesom: SHA-1 voor B<Checksums-Sha1> en SHA-256 voor
B<Checksums-Sha256>.

De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als
de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van
het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke
regel bestaat uit elementen die onderling door een spatie gescheiden zijn en
het bestand beschrijven: zijn controlesom, zijn bestandsgrootte en zijn
naam.

Deze velden sommen alle bestanden op die deel uitmaken van de upload. De
lijst van bestanden uit deze velden moet overeenkomen met de bestandslijst
in het veld B<Files> en in de andere gerelateerde B<Checksums>-velden.

=back

=head1 BUGS

Het veld B<Files> is niet consistent met de andere B<Checksums>-velden. De
velden B<Changed-By> en B<Maintainer> hebben namen die verwarrend zijn. Het
veld B<Distribution> bevat informatie over waar gewoonlijk met de term suite
naar verwezen wordt.

=head1 ZIE OOK

L<deb822(5)>, B<deb-src-control>(5), B<deb-version>(7).