.\" -*- 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-changelog 5" .TH deb-changelog 5 2024-01-24 1.22.4 "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-changelog \- indeling van het dpkg changelog-bestand van broncodepakketten .SH OVERZICHT .IX Header "OVERZICHT" \&\fBdebian/changelog\fR .SH BESCHRIJVING .IX Header "BESCHRIJVING" Wijzigingen aan de ingepakte versie van een project worden in het changelog-bestand \fIdebian/changelog\fR toegelicht. Daar vallen in de broncode aangebrachte veranderingen ten opzichte van die van de toeleveraar onder, evenals andere wijzigingen en updates aan het pakket. .PP De indeling van het bestand \fIdebian/changelog\fR laat het gereedschap voor het bouwen van pakketten toe om uit te zoeken welke versie van het pakket gebouwd wordt en om andere release-specifieke informatie te weten te komen. .PP Deze indeling bestaat uit een reeks vermeldingen zoals deze: .PP \fIpakket\fR (\fIversie\fR) \fIdistributies\fR; \fImetadata\fR [optioneel (een) blanco regel(s), die gestript worden] * \fIinformatie-over-de-veranderingen\fR \fInog-informatie-over-de-aanpassingen\fR [blanco regel(s), zichtbaar in de uitvoer van \fBdpkg\-parsechangelog\fR\|(1)] * \fIen-eventueel-nog-meer-wijzigingsinformatie\fR [optioneel (een) blanco regel(s), die gestript worden] \-\- \fInaam-van-de-beheerder\fR <\fIe\-mailadres\fR> \fIdatum\fR .PP \&\fIpakket\fR en \fIversie\fR zijn de naam van het broncodepakket en zijn versienummer. \fIversie\fR wordt begrensd door de haakjes U+00028 \(oq\fB(\fR\(cq en U+0029 \(oq\fB)\fR\(cq. .PP \&\fIdistributies\fR somt \('e\('en of meer door een spatie van elkaar gescheiden distributies op waarin deze versie ondergebracht moet worden als ze ge\(:upload wordt; dit wordt gekopieerd naar het veld \fBDistribution\fR in het bestand \fI.changes\fR. \fIdistributies\fR moet afgesloten worden door een puntkomma (U+003B \(oq\fB;\fR\(cq). .PP \&\fImetadata\fR is een lijst items van het type \fItrefwoord\fR=\fIwaarde\fR die onderling door een komma gescheiden worden. Elk trefwoord mag alleen mintekens en hoofdletterongevoelige alfanumerieke tekens bevatten, omdat ze moeten worden toegewezen aan \fBdeb822\fR\|(5)\-veldnamen. De enige \fItrefwoord\fRen die momenteel ondersteund worden door \fBdpkg\fR zijn: .IP \fBurgency\fR 4 .IX Item "urgency" Zijn waarde wordt gebruikt voor het \fBUrgency\fR\-veld in het \fI.changes\fR\-bestand voor de upload. .IP \fBbinary-only\fR 4 .IX Item "binary-only" Met als waarde \fByes\fR wordt het gebruikt om aan te geven dat dit changelog-item betrekking heeft op een niet door de pakketbeheerder gedane upload van enkel het(de) binaire pakket(ten) (een automatisch opnieuw bouwen van het(de) binaire pakket(ten) met het changelog-item als enige aangebrachte wijziging). .PP De informatie over de wijzigingen kan in feite om het even welk aantal regels beslaan die beginnen met minstens twee spaties (U+0020 \fBSPACE\fR). Gewoonlijk begint men bij het beschrijven van een wijziging steeds met een asterisk, gevolgd door een spatie. Eventuele vervolgregels springen zo in dat ze uitgelijnd zijn met de tekst van de regel erboven. Als men dat wenst kunnen blanco regels gebruikt worden om groepen van veranderingen onderling te scheiden. .PP Indien deze upload bugs oplost die vermeld staan in het bugvolgsysteem van de distributie, kunnen die automatisch gesloten worden op het ogenblik dat het pakket opgenomen wordt in het archief van de distributie, indien de tekenreeks: .Sp .RS 4 \&\fBCloses: #\fR\fInnnnn\fR .RE .PP in de informatie over de wijziging, waarbij \fB#\fR\fInnnnn\fR het bugnummer is. De exacte Perl reguliere expressie is: .Sp .RS 4 \&\fB/closes:\es*(?:bug)?\e#?\es?\ed+(?:,\es*(?:bug)?\e#?\es?\ed+)*/i\fR .RE .PP Dat wil zeggen dat de tekenreks moet bestaan uit het woord \fBcloses:\fR gevolgd door een door komma's gescheiden lijst met bugnummers. Bugnummers kunnen worden voorafgegaan door het woord \fBbug\fR en/of een \fB#\fR\-teken, zoals in \f(CW\*(C`Closes: 42, bug#43, #44, bug 45\*(C'\fR. De woorden \fBcloses:\fR en \fBbug\fR zijn niet hoofdlettergevoelig. De lijst met bugnummers kan meerdere regels beslaan. .PP Deze informatie wordt overgebracht via het veld \fBCloses\fR in het bestand \fI.changes\fR, waarbij, afhankelijk van de software voor archiefonderhoud, alle vermelde bugnummers automatisch gesloten kunnen worden. .PP De naam van de beheerder en het e\-mailadres die in het changelog-bestand vermeld worden moeten betrekking hebben op de persoon die deze release van het pakket voorbereidde. Deze gegevens betreffen \fBniet\fR noodzakelijk de persoon die het pakket uploadt of de persoon die het pakket gewoonlijk onderhoudt. De hier vermelde informatie wordt gekopieerd naar het veld \fBChanged-By\fR in het bestand \fI.changes\fR en zal later, wanneer de upload in het distributiearchief ondergebracht wordt, gebruikt worden voor het zenden van een kennisgeving. .PP De \fIdatum\fR heeft de volgende indeling (compatibel met en met dezelfde betekenis als in RFC2822 en RFC5322, of hetgeen het commando \(Fodate \-R\(Fc genereert): .Sp .RS 4 \&\fIdag-van-de-week\fR\fB,\fR \fIdd\fR \fImaand\fR \fIjjjj\fR \fIuu\fR\fB:\fR\fImm\fR\fB:\fR\fIss\fR \fB+\fR\fIzzzz\fR .RE .PP waarbij: .IP \fIdag-van-de-week\fR 4 .IX Item "dag-van-de-week" Een van volgende mogelijkheden is: \fBMon\fR, \fBTue\fR, \fBWed\fR, \fBThu\fR, \fBFri\fR, \fBSat\fR, \fBSun\fR. .IP \fIdd\fR 4 .IX Item "dd" Een uit een of twee cijfers bestaande dag van de maand (\fB01\fR\-\fB31\fR is, waarbij de voorop staande nul facultatief is, maar gewoonlijk niet wordt weggelaten. .IP \fImaand\fR 4 .IX Item "maand" Een van volgende mogelijkheden is: \fBJan\fR, \fBFeb\fR, \fBMar\fR, \fBApr\fR, \fBMay\fR, \fBJun\fR, \fBJul\fR, \fBAug\fR, \fBSep\fR, \fBOct\fR, \fBNov\fR, \fBDec\fR. .IP \fIjjjj\fR 4 .IX Item "jjjj" Een uit vier cijfers bestaande aanduiding van het jaar (bijv. 2010) is. .IP \fIuu\fR 4 .IX Item "uu" Een uit twee cijfers bestaande aanduiding van het uur (\fB00\fR\-\fB23\fR) is. .IP \fImm\fR 4 .IX Item "mm" Een uit twee cijfers bestaande aanduiding van de minuten (\fB00\fR\-\fB59\fR) is. .IP \fIss\fR 4 .IX Item "ss" Een uit twee cijfers bestaande aanduiding van de seconden (\fB00\fR\-\fB60\fR) is. .IP [\fB+\-\fR]\fIzzzz\fR 4 .IX Item "[+-]zzzz" De afwijking is van de tijdzone ten opzichte van de geco\(:ordineerde wereldtijd (UTC). \(oq\fB+\fR\(cq geeft aan dat de tijd voorloopt op UTC (d.w.z. dat de tijdzone zich ten oosten van de nulmeridiaan bevindt) en \(oq\fB\-\fR\(cq geeft aan dat de tijd achterloopt op UTC (d.w.z. dat de tijdzone zich ten oosten van de nulmeridiaan bevindt). De eerste twee cijfers geven aan hoeveel uur het verschil bedraagt ten opzichte van UTC en de laatste twee hoeveel extra minuten het verschil is ten opzichte van UTC. De laatste twee cijfers moeten vallen binnen het bereik \fB00\fR\-\fB59\fR. .PP De eerste \(lqtitel\(rq\-regel met de naam van het pakket moet beginnen aan de linkermarge. De \(lqvolgende\(rq regel met de gegevens over de beheerder en de datum moet door exact \('e\('en spatie voorafgegaan worden (U+0020 \fBSPACE\fR). Tussen de informatie over de beheerder en de datum moeten exact twee spaties staan (U+0020 \fBSPACE\fR). Elk onderdeel van de \fIdatum\fR kan gescheiden worden door \('e\('en of meer spaties (U+0020 \fBSPACE\fR), behalve na de komma waar het gescheiden kan worden door nul of meer spaties (U+0020 \fBSPACE\fR). .PP Elke regel die volledig (d.w.z. zonder voorafgaande witruimte) bestaat uit commentaar in de vorm van \fB#\fR\- of \fB/* */\fR of RCS-trefwoorden. .PP Modusregels van Vim of lokale variabelen van Emacs en oudere changelog-elementen met een andere indeling aan het einde van het bestand, moeten aanvaard worden en in de uitvoer behouden blijven, maar de inhoud ervan kan verder genegeerd worden en het ontleden kan op dat punt gestopt worden. .PP Het volledige changelog-bestand moet in UTF\-8 opgemaakt zijn. .SH BESTANDEN .IX Header "BESTANDEN" .IP \fIdebian/changelog\fR 4 .IX Item "debian/changelog" .SH VOORBEELDEN .IX Header "VOORBEELDEN" .Vb 1 \& dpkg (1.17.18) unstable; urgency=low \& \& [ Guillem Jover ] \& * Handle empty minimum versions when initializing dependency versions, \& as the code is mapping the minimum version 0 to \*(Aq\*(Aq to avoid outputting \& useless versions. Regression introduced in dpkg 1.17.17. Closes: #764929 \& \& [ Updated programs translations ] \& * Catalan (Guillem Jover). \& \& [ Updated dselect translations ] \& * Catalan (Guillem Jover). \& * German (Sven Joachim). \& \& \-\- Guillem Jover Sun, 12 Oct 2014 15:47:44 +0200 .Ve .SH "ZIE OOK" .IX Header "ZIE OOK" \&\fBdeb822\fR\|(5), \fBdeb\-changes\fR\|(5), \fBdeb\-version\fR\|(7), \fBdpkg\-parsechangelog\fR\|(1).