.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "deb-changes 5" .TH deb-changes 5 2024-03-10 1.22.6 "dpkg suite" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAAM .IX Header "NAAM" deb-changes \- Indeling van het changes-controlebestand van een Debian-upload .SH OVERZICHT .IX Header "OVERZICHT" \&\fIbestandsnaam\fR\fB.changes\fR .SH BESCHRIJVING .IX Header "BESCHRIJVING" Elke Debian-upload bestaat uit een controlebestand .changes, dat een aantal velden bevat in \fBdeb822\fR\|(5)\-indeling. .PP Ieder veld begint met een markering, zoals \fBSource\fR of \fBBinary\fR (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 \fBDescription\fR, \fBChanges\fR, \fBFiles\fR, \fBChecksums\-Sha1\fR en \fBChecksums\-Sha256\fR; zie hierna) .PP De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met ASCII-harnas volgens de specificatie RFC4880. .SH VELDEN .IX Header "VELDEN" .IP "\fBFormat:\fR \fIindelingsversie\fR (verplicht)" 4 .IX Item "Format: 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 \fB1.8\fR. .IP "\fBDate:\fR \fIdatum-van-uitgave\fR (verplicht)" 4 .IX Item "Date: 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 \fBdeb\-changelog\fR\|(5)\-item. .Sp De waarde van dit veld wordt meestal gehaald uit het bestand \fIdebian/changelog\fR. .IP "\fBSource:\fR \fIbroncode-naam\fR [\fB(\fR\fIbroncode-versie\fR\fB)\fR] (verplicht)" 4 .IX Item "Source: broncode-naam [(broncode-versie)] (verplicht)" De naam van het broncodepakket. Indien de versie van het broncodepakket verschilt van de versie van het binaire pakket, dan zal de \fIbroncode-naam\fR gevolgd worden door een \fIbroncode-versie\fR tussen haakjes. Dit kan het geval zijn als de upload een uitsluitend binaire upload is die niet door de beheerder uitgevoerd wordt. .IP "\fBBinary:\fR \fIlijst-binaire-pakketten\fR (vereist in de context)" 4 .IX Item "Binary: lijst-binaire-pakketten (vereist in de context)" Dit gevouwen veld is een lijst, met spatie als scheidingsteken, van binaire pakketten die ge\(:upload moeten worden. Indien het een upload is van enkel broncode, dan wordt het veld weggelaten (sinds dpkg 1.19.3). .IP "\fBArchitecture:\fR \fIarch-lijst\fR" 4 .IX Item "Architecture: arch-lijst" Somt de architecturen op van de bestanden die momenteel ge\(:upload worden. Gebruikelijke architecturen zijn \fBamd64\fR, \fBarmel\fR, \fBi386\fR, enz. Merk op dat de waarde \fBall\fR bedoeld is voor pakketten die architectuuronafhankelijk zijn. Indien ook de broncode voor het pakket ge\(:upload wordt, wordt tevens de bijzondere vermelding \fBsource\fR toegevoegd. Jokertekens voor architecturen mogen nooit voorkomen in de lijst. .IP "\fBVersion:\fR \fIversie-tekenreeks\fR (verplicht)" 4 .IX Item "Version: 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 \fBdeb\-version\fR\|(7). .IP "\fBDistribution:\fR \fIdistributie\fRs (verplicht)" 4 .IX Item "Distribution: distributies (verplicht)" Somt een of meer met een spatie van elkaar gescheiden distributies op waarin deze versie ondergebracht moet worden als het ge\(:upload wordt naar het archief. .IP "\fBUrgency:\fR \fIurgentie\fR (aanbevolen)" 4 .IX Item "Urgency: urgentie (aanbevolen)" De dringendheid van de upload. De momenteel toegelaten waarden, in oplopende volgorde van dringendheid, zijn: \fBlow\fR, \fBmedium\fR, \fBhigh\fR, \fBcritical\fR en \fBemergency\fR. .IP "\fBMaintainer:\fR \fIvolledige-naam-en-e-mail\fR (verplicht)" 4 .IX Item "Maintainer: volledige-naam-en-e-mail (verplicht)" Moet opgemaakt worden volgens de indeling \(lqJoe Bloggs \(rq, en is gewoonlijk de persoon die het pakket maakte, in tegenstelling tot de auteur van de verpakte software. .IP "\fBChanged-By:\fR \fIvolledige-naam-en-e-mailadres\fR" 4 .IX Item "Changed-By: volledige-naam-en-e-mailadres" Moet opgemaakt worden volgens de indeling \(lqJoe Bloggs \(rq, en is gewoonlijk de persoon die voor deze release verantwoordelijk is voor de veranderingen aan het pakket. .IP "\fBDescription:\fR (aanbevolen)" 4 .IX Item "Description: (aanbevolen)" .PD 0 .IP "\ \fInaam-binaire-pakket\fR \fB\-\fR \fIsamenvatting-binaire-pakket\fR" 4 .IX Item " naam-binaire-pakket - samenvatting-binaire-pakket" .PD Dit multiregel-veld bevat een lijst met de naam van de binaire pakketten, gevolgd door een spatie, een koppelteken (\(oq\fB\-\fR\(cq) en hun eventueel afgekapte korte beschrijving. Indien het een upload is van enkel broncode, dan wordt het veld weggelaten (sinds dpkg 1.19.3). .IP "\fBCloses:\fR \fIbug-nummer-lijst\fR" 4 .IX Item "Closes: 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. .IP "\fBBinary-Only: yes\fR" 4 .IX Item "Binary-Only: yes" Dit veld geeft aan dat deze upload gebeurt na de niet door de pakketbeheerder uitgevoerde bouw van uitsluitend het binaire pakket. Het vindt zijn oorsprong in het item met de sleutel/waarde\-combinatie \fBbinary\-only=yes\fR uit de metadata van het changelog-bestand. .IP "\fBBuilt-For-Profiles:\fR \fIprofiel-lijst\fR" 4 .IX Item "Built-For-Profiles: profiel-lijst" Dit veld somt een lijst van door een spatie van elkaar gescheiden bouwprofielen op waarmee deze upload gebouwd werd. .IP "\fBChanges:\fR (verplicht)" 4 .IX Item "Changes: (verplicht)" .PD 0 .IP "\ \fIchangelog-items\fR" 4 .IX Item " changelog-items" .PD 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 \('e\('en enkel punt (\(oq.\(cq) en springen alle regels in met \('e\('en spatie. De exacte inhoud hangt af van de changelog-indeling. .IP "\fBFiles:\fR (verplicht)" 4 .IX Item "Files: (verplicht)" .PD 0 .IP "\ \fImd5som\fR \fIgrootte\fR \fIsectie\fR \fIprioriteit\fR \fIbestandsnaam\fR" 4 .IX Item " md5som grootte sectie prioriteit bestandsnaam" .PD Dit multiregel-veld bevat een bestandslijst met voor elk bestand de vermelding van de md5som, grootte, sectie en prioriteit. .Sp 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, \('e\('en 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. .Sp 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 \fBChecksums\fR\-velden. .IP "\fBChecksums\-Sha1:\fR (verplicht)" 4 .IX Item "Checksums-Sha1: (verplicht)" .PD 0 .IP "\fBChecksums\-Sha256:\fR (verplicht)" 4 .IX Item "Checksums-Sha256: (verplicht)" .IP "\ \fIcontrolesom\fR \fIgrootte\fR \fIbestandsnaam\fR" 4 .IX Item " controlesom grootte bestandsnaam" .PD 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 \fBChecksums\-Sha1\fR en SHA\-256 voor \fBChecksums\-Sha256\fR. .Sp 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, \('e\('en 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. .Sp 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 \fBFiles\fR en in de andere gerelateerde \fBChecksums\fR\-velden. .SH BUGS .IX Header "BUGS" Het veld \fBFiles\fR is niet consistent met de andere \fBChecksums\fR\-velden. De velden \fBChanged-By\fR en \fBMaintainer\fR hebben namen die verwarrend zijn. Het veld \fBDistribution\fR bevat informatie over waar gewoonlijk met de term suite naar verwezen wordt. .SH "ZIE OOK" .IX Header "ZIE OOK" \&\fBdeb822\fR\|(5), \fBdeb\-src\-control\fR\|(5), \fBdeb\-version\fR\|(7).