Man page - deb-changelog(5)

Packages contains this manual

Package: dpkg-dev
apt-get install dpkg-dev

Manuals in package:

Documentations in package:

Available languages:

en fr pt nl sv de

Manual

deb-changelog

NAMN
SYNOPS
BESKRIVNING
FILER
EXEMPEL
SE ÄVEN
ÖVERSÄTTNING

NAMN

deb-changelog - filformat för ändringsloggfiler i Deibankällkodspaket

SYNOPS

debian/changelog

BESKRIVNING

Ändringar i den paketerade versionen av ett projekt förklaras i ändringsloggfilen debian/changelog . Däribland anges ändringar i källkodspaket jämfört med uppströmsversionen, såväl som andra ändringar och uppdateringar av paketet.

Formatet på <debian/changelog> gör det möjligt för paketbyggverktyg att upptäcka vilken version av paketet som byggs och finna ytterligare utgivningsspecifik information.

Formatet är ett antal poster såsom denna:

paket ( version ) distributioner ; metadata
[valfri(a) blankrad(er), tas bort]
* ändringsdetalj
fler-ändringsdetaljer
[blankrad(er), tas med i utdata från dpkg-parsechangelog (1)]
* ytterligare-ändringsdetaljer
[valfri(a) blankrad(er), tas bort]
-- ansvarig-namn < epost-adress > datum

paket och version är källkodspaketets namn och versionsnummer. version avdelas av parentes U+0028 ” ( ” och U+0029 ” ) ”.

distributioner anger en eller flera blankstegsavdelade distributioner där den här versionen ska installeras efter insändning; värdet kopieras till fältet Distribution i .changes -filen. distributions måste avslutas av ett semikolon (U+003B ” ; ”).

metadata anger noll eller flera kommaseparerade poster på formen nyckelord = värde . Varje nyckelord innehåller endast minustecken och skiftlägesokänsliga alfanumeriska tecken, eftersom de måste kunna motsvara deb822 (5)-fältnamn. De enda nyckelord som stöds av dpkg för närvarande är:
urgency (brådska)

Värdet används för fältet Urgency i .changes -filen vid insändning.

binary-only (endast binär)

Med värdet yes används fältet för att ange att ändringsposten är för en insändning bestående av enbart binärer från någon annan än den paketansvarige (”binary-only non-maintainer upload”, en automatisk ombyggd binär där den enda ändringen är ändringsloggposten).

Ändringsdetaljerna kan faktiskt vara valfri serie av rader som börjar med minst två blanksteg (U+0020 SPACE ), men sedvanligen inleds varje ändring med en asterisk och ett avdelande blanksteg och fortsättningsrader har ett indrag så att de står i linje med början på texten över. Tomrader kan användas för att avdela grupper av ändringar här, om så önskas.

Om insändningen rättar fel beskrivna i distributionens felhanteringssystem, kan de stängas automatiskt när paketet tas in i distributionensarkivet genom att ta med strängen:

Closes: # nnnnn

i ändringsdetaljerna, där # nnnnn är felrapportsnumret. Exakt Perl-reguljärt uttryck är:

/closes:\s*(?:bug)?\#?\s?\d+(?:,\s*(?:bug)?\#?\s?\d+)*/i

Det vill säga, strängen bör bestå av ordet closes: följt av en kommaavdelad lista med felrapportsnummer. Felrapporterna kan föregås av ordet bug och/eller tecknet # , som i "Closes: 42, bug#43, #44, bug 45". Ordet closes: och bug är inte skiftlägeskänsliga. Listan med relrapportsnummer kan fortsätta över flera rader.

Informationen vidareförs via fältet Closes i .changes -filen. Där, beroende på vilken arkivhanteringsprogramvra som används, alla listade felrapporter kan stängas automatiskt.

Det namn och e-postadress för den ansvarige som används i ändringsloggen bör vara information om den person som förberedde denna utgåva av paketet. Det är inte nödvändigtvis samma som insändaren eller den vanlige paketansvarige. Informationen kopieras till fältet Changed-By i .changes -filen, och kan senare användas för att sända en bekräftelse när det insända paketet har installerats i distributionsarkivet.

datum har följande format (kompatibelt med och med samma betydelse som RFC2822 and RFC5322, eller det ”date -R” skapar):

veckodag , dd månad åååå hh : mm : ss + zzzz

där:
veckodag

Är en av: Mon , Tue , Wed , Thu , Fri , Sat , Sun .

Är dag i månaden ( 01 - 31 ) med en eller två siffror, där den inledande nollan är valfri, men vanligtvis inte utesluts.

månad

Är en av: Jan , Feb , Mar , Apr , May , Jun , Jul , Aug , Sep , Oct , Nov , Dec .

åååå

Är det fyrasiffriga året (t.ex 2010).

	hh		Är den tvåsiffriga timmen ( 00 - 23 ).
	mm		Är den tvåsiffriga minuten ( 00 - 59 ).
	ss		Är den tvåsiffriga sekunden ( 00 - 60 ).

[ +- ] zzzz

Är skillnaden i tidszon från Koordinerad universell tid (UTC). ” + ” anger att tiden är framför (dvs. öster om) UTC och ” - ” anger att tiden er bakom (dvs. väster om) UTC. De första två siffrorna anger skillnaden mot UTC i timmar och de två sista siffrorna anger antalet ytterligare minuter som skiljer mot UTC. De två sista siffrorna måste vara i intervallet 00 - 59 .

Den första ”titel”-raden med paketnamnet måste börja i vänstermarginalen. ”Släpraden” med ansvarige och datum måste inledas med exakt ett blanktecken (U+0020 SPACE ). Informationen om ansvarige och datumet måste åtskiljas av exakt två blanksteg (U+0020 SPACE ). Varje del av datum kan avdelas av ett eller flera blanksteg (U+0020 SPACE ), bortsett från efter komma där det kan avdelas av noll eller flera blanksteg (U+0020 SPACE ).

Rader som i sin helhet (dvs., inga inledande blanksteg) består av kommentarer på formen # eller /* */ eller RCS-nyckelord.

Vim-lägesrader eller Emacs-lokala variabler, och antika ändringsloggar med andra format på slutet av filen bör godtas och behållas i utdata, men deras innehåll kan annars ignoreras och tolkningen kan avbrytas när de upptäcks.

Hela ändringsloggen måste vara kodad i UTF-8.

FILER

debian/changelog

EXEMPEL

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 '' 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 <guillem@debian.org> Sun, 12 Oct 2014 15:47:44 +0200

SE ÄVEN

deb822 (5), deb-changes (5), deb-version (7), dpkg-parsechangelog (1).

ÖVERSÄTTNING

Peter Krefting och Daniel Nylander.