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 lists zero or more comma-separated keyword=value items. Each keyword can contain
       only minus and case insensitive alphanumeric characters, as they need to be mapped to
       deb822(5) field names. The only keywords currently supported by dpkg are:

       urgency
           Its value is used for the Urgency field in the .changes file for the upload.

       binary-only
           With a yes value, it is used to denote that this changelog entry is for a binary-only
           non-maintainer upload (an automatic binary rebuild with the only change being the
           changelog entry).

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

       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.

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

ÖVERSÄTTNING

       Peter Krefting och Daniel Nylander.