chiark - git - mdw - dpkg/blob - man/nl/deb-changes.man

   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).