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

The change details may be any series of lines starting with at least two spaces (U+0020 SPACE), but conventionally each change starts with an asterisk and a separating space and continuation lines are indented so as to bring them in line with the start of the text above. Blank lines may be used here to separate groups of changes, if desired.

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:

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

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.

The maintainer name and email address used in the changelog should be the details of the person who prepared this release of the package. They are not necessarily those of the uploader or usual package maintainer. The format for the name and email address is described in deb-email(7). The information here will be copied to the Changed-By field in the .changes file, and then later might be used to send an acknowledgment when the upload has been installed in the distribution archive.

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

där:

veckodag

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

dd

Ä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 kommer att ignoreras.

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-email(7), deb-version(7), dpkg-parsechangelog(1).

ÖVERSÄTTNING¶

Peter Krefting och Daniel Nylander.