Commit | Line | Data |
---|---|---|
1479465f GJ |
1 | .\" dpkg manual page - deb-changes(5) |
2 | .\" | |
3 | .\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> | |
4 | .\" Copyright © 2010 Russ Allbery <rra@debian.org> | |
5 | .\" Copyright © 2015 Guillem Jover <guillem@debian.org> | |
6 | .\" | |
7 | .\" This is free software; you can redistribute it and/or modify | |
8 | .\" it under the terms of the GNU General Public License as published by | |
9 | .\" the Free Software Foundation; either version 2 of the License, or | |
10 | .\" (at your option) any later version. | |
11 | .\" | |
12 | .\" This is distributed in the hope that it will be useful, | |
13 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | .\" GNU General Public License for more details. | |
16 | .\" | |
17 | .\" You should have received a copy of the GNU General Public License | |
18 | .\" along with this program. If not, see <https://www.gnu.org/licenses/>. | |
19 | . | |
20 | .\"******************************************************************* | |
21 | .\" | |
22 | .\" This file was generated with po4a. Translate the source file. | |
23 | .\" | |
24 | .\"******************************************************************* | |
25 | .TH deb\-changes 5 %RELEASE_DATE% %VERSION% dpkg\-suite | |
26 | .nh | |
27 | .SH NAAM | |
28 | deb\-changes \- Indeling van het Debian changes\-bestand | |
29 | . | |
30 | .SH OVERZICHT | |
31 | \fIbestandsnaam\fP\fB.changes\fP | |
32 | . | |
33 | .SH BESCHRIJVING | |
34 | Elke upload in Debian bevat een .changes\-controlebestand \fIcontrol\fP met een | |
35 | aantal velden. Ieder veld begint met een markering, zoals \fBSource\fP of | |
36 | \fBBinary\fP (niet hoofdlettergevoelig), gevolgd door een dubbele punt en de | |
37 | tekstinhoud van het veld. Velden worden enkel door veldmarkeringen | |
38 | begrensd. De tekstinhoud van het veld kan met andere woorden verschillende | |
39 | regels lang zijn, maar de installatiegereedschappen zullen bij het verwerken | |
40 | van de tekstinhoud de regels gewoonlijk samenvoegen (behalve voor de | |
41 | multiregel\-velden \fBDescription\fP, \fBChanges\fP, \fBFiles\fP, \fBChecksums\-Sha1\fP en | |
42 | \fBChecksums\-Sha256\fP; zie hierna) | |
43 | .PP | |
44 | De controle\-data mogen ingesloten liggen in een OpenPGP\-handtekening met | |
45 | ASCII\-harnas volgens de specificatie RFC4880. | |
46 | . | |
47 | .SH VELDEN | |
48 | .TP | |
49 | \fBFormat:\fP \fIindelingsversie\fP (verplicht) | |
50 | De waarde van dit veld bepaalt de indelingsversie van het bestand. De | |
51 | syntaxis van de veldwaarde is een versienummer met een hoofdversie\- en een | |
52 | onderversiecomponent. Wijzigingen aan de indeling die niet neerwaarts | |
53 | compatibel zijn, hebben een verhoging van het hoofdversienummer tot gevolg | |
54 | en neerwaarts compatibele veranderingen (zoals het toevoegen van extra | |
55 | velden) verhogen het onderversienummer. De huidige indelingsversie is | |
56 | \fB1.8\fP. | |
57 | .TP | |
58 | \fBDate:\fP \fIdatum\-van\-uitgave\fP (verplicht) | |
59 | De datum waarop het pakket gebouwd werd of het laatst bewerkt. Hij moet in | |
60 | dezelfde indeling opgemaakt zijn als de datum in een | |
61 | \fBdeb\-changelog\fP(5)\-item. | |
62 | ||
63 | De waarde van dit veld wordt meestal gehaald uit het bestand | |
64 | \fIdebian/changelog\fP. | |
65 | .TP | |
66 | \fBSource:\fP \fIbroncode\-naam\fP [\fB(\fP\fIbroncode\-versie\fP\fB)\fP] (verplicht) | |
67 | De naam van het broncodepakket. Indien de versie van het broncodepakket | |
68 | verschilt van de versie van het binaire pakket, dan zal de \fIbroncode\-naam\fP | |
69 | gevolgd worden door een \fIbroncode\-versie\fP tussen haakjes. Dit kan het geval | |
70 | zijn als de upload een uitsluitend binaire upload is die niet door de | |
71 | onderhouder uitgevoerd wordt. | |
72 | .TP | |
73 | \fBBinary:\fP \fIlijst\-binaire\-pakketten\fP (verplicht) | |
74 | Dit gevouwen veld is een lijst, met spatie als scheidingsteken, van binaire | |
75 | pakketten die geüpload moeten worden. | |
76 | .TP | |
77 | \fBArchitecture:\fP \fIarch\-lijst\fP | |
78 | Somt de architecturen op van de bestanden die momenteel geüpload | |
79 | worden. Gebruikelijke architecturen zijn \fBamd64\fP, \fBarmel\fP, \fBi386\fP, | |
80 | enz. Merk op dat de waarde \fBall\fP bedoeld is voor pakketten die | |
81 | architectuuronafhankelijk zijn. Indien ook de broncode voor het pakket | |
82 | geüpload wordt, wordt tevens de bijzondere vermelding \fBsource\fP | |
83 | toegevoegd. Jokertekens voor architecturen mogen nooit voorkomen in de | |
84 | lijst. | |
85 | .TP | |
86 | \fBVersion:\fP \fIversie\-tekenreeks\fP (verplicht) | |
87 | Gewoonlijk is dit het originele versienummer van het pakket, welke vorm de | |
88 | auteur van het programma er ook voor gebruikt. Het kan ook een | |
89 | Debian\-revisienummer bevatten (voor niet uit Debian stammende pakketten). De | |
90 | exacte indeling en het sorteringsalgoritme worden beschreven in | |
91 | \fBdeb\-version\fP(5). | |
92 | .TP | |
93 | \fBDistribution:\fP \fIdistributie\fPs (verplicht) | |
94 | Somt een of meer met een spatie van elkaar gescheiden distributies op waarin | |
95 | deze versie ondergebracht moet worden als het geüpload wordt naar het | |
96 | archief. | |
97 | .TP | |
98 | \fBUrgency:\fP\fI urgentie\fP (aanbevolen) | |
99 | De dringendheid van de upload. De momenteel toegelaten waarden, in oplopende | |
100 | volgorde van dringendheid, zijn: \fBlow\fP, \fBmedium\fP, \fBhigh\fP, \fBcritical\fP en | |
101 | \fBemergency\fP. | |
102 | .TP | |
103 | \fBMaintainer:\fP \fIvolledige\-naam\-en\-e\-mail\fP (verplicht) | |
104 | Moet opgemaakt worden volgens de indeling “Joe Bloggs | |
105 | <jbloggs@example.org>”, en is gewoonlijk de persoon die het pakket | |
106 | maakte, in tegenstelling tot de auteur van de verpakte software. | |
107 | .TP | |
108 | \fBChanged\-By:\fP\fI volledige\-naam\-en\-e\-mailadres\fP | |
109 | Moet opgemaakt worden volgens de indeling “Joe Bloggs | |
110 | <jbloggs@example.org>”, en is gewoonlijk de persoon die voor deze | |
111 | release verantwoordelijk is voor de veranderingen aan het pakket. | |
112 | .TP | |
113 | \fBDescription:\fP (aanbevolen) | |
114 | .TQ | |
115 | \fInaam\-binaire\-pakket\fP \fB\-\fP \fIsamenvatting\-binaire\-pakket\fP | |
116 | Dit multiregel\-veld bevat een lijst met de namen van de binaire pakketten, | |
117 | gevolgd door een spatie, een koppelteken (‘\fB\-\fP’) en hun eventueel afgekapte | |
118 | korte beschrijving. | |
119 | .TP | |
120 | \fBCloses:\fP\fI bug\-nummer\-lijst\fP | |
121 | Een lijst van met komma's van elkaar gescheiden nummers van bugrapporten die | |
122 | door deze upload opgelost worden. De archiefsoftware van de distributie kan | |
123 | dit veld gebruiken om automatisch de vermelde bugnummers te sluiten in het | |
124 | opvolgingssysteem voor bugs van de distributie. | |
125 | .TP | |
126 | \fBBinary\-Only: yes\fP | |
127 | Dit veld geeft aan dat deze upload gebeurt na de niet door de | |
128 | pakketonderhouder uitgevoerde bouw van uitsluitend het binaire pakket. Het | |
129 | vindt zijn oorsprong in het item met de sleutel/waarde\-combinatie | |
130 | \fBbinary\-only=yes\fP uit de metadata van het changelog\-bestand. | |
131 | .TP | |
132 | \fBBuilt\-For\-Profiles:\fP\fI profiel\-lijst\fP | |
133 | Dit veld somt een lijst van door een spatie van elkaar gescheiden | |
134 | bouwprofielen op waarmee deze upload gebouwd werd. | |
135 | .TP | |
136 | \fBChanges:\fP (verplicht) | |
137 | .TQ | |
138 | \fI changelog\-items\fP | |
139 | Dit multiregel\-veld bevat de samengevoegde tekst van alle changelog\-items | |
140 | die deel uitmaken van de upload. Om van dit veld een geldig multiregel\-veld | |
141 | te maken, worden lege regels vervangen door één enkel punt (‘.’) en springen | |
142 | alle regels in met één spatie. De exacte inhoud hangt af van de | |
143 | changelog\-indeling. | |
144 | .TP | |
145 | \fBFiles:\fP (verplicht) | |
146 | .TQ | |
147 | \fImd5som\fP \fIgrootte\fP \fIsectie\fP \fIprioriteit\fP \fIbestandsnaam\fP | |
148 | Dit multiregel\-veld bevat een bestandslijst met voor elk bestand de | |
149 | vermelding van de md5som, grootte, sectie en prioriteit. | |
150 | ||
151 | De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als | |
152 | de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van | |
153 | het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke | |
154 | regel bestaat uit elementen die onderling gescheiden zijn door een spatie en | |
155 | het bestand beschrijven: zijn md5som, zijn bestandsgrootte, zijn sectie, | |
156 | zijn prioriteit en zijn naam. | |
157 | ||
158 | Dit veld somt alle bestanden op die deel uitmaken van de upload. De lijst | |
159 | van bestanden uit dit veld moet overeenkomen met de bestandslijst in de | |
160 | andere gerelateerde \fBChecksums\fP\-velden. | |
161 | .TP | |
162 | \fBChecksums\-Sha1:\fP (verplicht) | |
163 | .TQ | |
164 | \fBChecksums\-Sha256:\fP (verplicht) | |
165 | .TQ | |
166 | \fIcontrolesom\fP \fIgrootte\fP \fIbestandsnaam\fP | |
167 | Deze multiregel\-velden bevatten een lijst van bestanden met een controlesom | |
168 | en een bestandsgrootte voor elk van hen. Deze velden gebruiken dezelfde | |
169 | syntaxis en verschillen onderling enkel in het gebruikte algoritme voor het | |
170 | berekenen van de controlesom: SHA\-1 voor \fBChecksums\-Sha1\fP en SHA\-256 voor | |
171 | \fBChecksums\-Sha256\fP. | |
172 | ||
173 | De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als | |
174 | de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van | |
175 | het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke | |
176 | regel bestaat uit elementen die onderling door een spatie gescheiden zijn en | |
177 | het bestand beschrijven: zijn controlesom, zijn bestandsgrootte en zijn | |
178 | naam. | |
179 | ||
180 | Deze velden sommen alle bestanden op die deel uitmaken van de upload. De | |
181 | lijst van bestanden uit deze velden moet overeenkomen met de bestandslijst | |
182 | in het veld \fBFiles\fP en in de andere gerelateerde \fBChecksums\fP\-velden. | |
183 | . | |
184 | .\" .SH EXAMPLE | |
185 | .\" .RS | |
186 | .\" .nf | |
187 | .\" | |
188 | .\" .fi | |
189 | .\" .RE | |
190 | . | |
191 | .SH BUGS | |
192 | Het veld \fBFiles\fP is niet consistent met de andere \fBChecksums\fP\-velden. De | |
193 | velden \fBChange\-By\fP en \fBMaintainer\fP hebben namen die verwarrend zijn. Het | |
194 | veld \fBDistribution\fP bevat informatie over waar gewoonlijk met de term suite | |
195 | naar verwezen wordt. | |
196 | .SH "ZIE OOK" | |
197 | \fBdeb\-src\-control\fP(5), \fBdeb\-version\fP(5). |