NAMN¶

dpkg-parsechangelog - tolka Debians ändringsloggar

SYNOPS¶

dpkg-parsechangelog [flagga...]

BESKRIVNING¶

dpkg-parsechangelog läser och tolkar ändringsloggen i ett uppackat Debiankällkodsträd och visar informationen i den på standard ut i en maskinläsbar form.

FLAGGOR¶

-ländringsloggfil

Anger ändringsloggfilen som information skall läsas från. Standardvärdet är debian/changelog.

-Fändringsloggformat

Anger format på ändringsloggen. Som standard läses formatet från en speciell rad nära slutet av ändringsloggen, om det misslyckas används formatet debian som standard. Se även FORMAT PÅ ÄNDRINGSLOGGEN.

-Lbibliotekskatalog

Ange en ytterligare katalog att söka i efter parserskript. Katalogen söks genom innan standardkatalogerna, vilka för närvarande är /usr/local/lib/dpkg/parsechangelog och /usr/lib/dpkg/parsechangelog.

-?, --help

Visar hjälpskärm och avslutar.

--version

Visar version och avslutar.

Parserflaggor¶

Följande flaggor kan användas för att styra utdata från ändringsloggparsern, t.ex. omfånget av poster eller formatet på utdata. De måste stödas av parserskriptet i fråga. Se även VARNINGAR.

--format utdataformat

Välj utdataformat. Stödda format är för närvarande dpkg och rfc822. dpkg är det klassiska utdataformatet (från innan denna flagga var tillgänglig) och förvalet. Det består av ett stycke i Debians control-format (se deb-control(5)). Om mer än en post önskas tas de flesta fält från den nyaste posten, förutom om annat anges:

Fälten Version, Distribution, Urgency, Maintainer och Changes krävs.

Ytterligare användardefinierade fält kan finnas.

rfc822-formatet använder samma fält, men ger ett separat stycke för varje ändringsloggspost så att all metadata för varje post behålls.

--since version, -sversion, -v version

ta med alla poster efter version.

--until version, -uversion

ta med alla ändringar före version.

--from version, -fversion

ta med alla ändringar från och med version.

--to version, -tversion

ta med alla ändringar till och med version.

--count antal, -cantal, -n antal

ta med antal ändringar från början (eller slutet om antal är lägre än 0).

--offset antal, -oantal

ändra startpunkt för --count, räknat från början (eller slutet om antal är lägre än 0).

--all

ta med alla ändringar. Observera: övriga flaggor har ingen effekt när denna används.

FORMAT PÅ ÄNDRINGSLOGGEN¶

Det är möjligt att använda ett annat format än standard, genom att tillhandahålla en tolk för det alternativa formatet. För att låta dpkg-parsechangelog köra den nya tolken måste en rad som motsvarar det reguljära uttrycket (Perl-format) “ \schangelog-format:\s+([0-9a-z]+)\W” läggas in bland de 40 sista raderna i ändringsloggfilen. Delen i parentes är namnet på formatet. Till exempel:
@@@ changelog-format: annatformat @@@ Namn på ändringsloggformat är icke-tomma strängar av alfanumeriska tecken. Om en sådan rad finns kommer dpkg-parsechangelog att leta efter tolken i /usr/lib/dpkg/parsechangelog/annatformat eller /usr/local/lib/dpkg/parsechangelog/ annatformat; det är ett fel om det inte finns eller inte är ett exekverbart program. Standardformatet för ändringsloggar är debian och en tolk för detta format inkluderas som standard. Tolken kommer att anropas med ändringsloggen öppen på standard in i början av filen. Den bör läsa filen (den kan söka om den så önskar) för att bestämma den information som krävs och returnera den tolkade information på standard ut i det format som anges av flaggan --format. Den bör acceptera alla Tolkflaggor. Om ändringsloggformatet som tolkas alltid eller nästan alltid innehåller en blank rad mellan individuella ändringsposter bör dessa blanka rader tas bort, så att utdataformatet blir mer kompakt. Om ändringsloggformatet inte innehåller information om datum eller paketnamn bör denna information utelämnas från utdata. Tolken bör inte försöka skapa den eller hitta den i andra källor. Om ändringsloggen inte har det förväntade formatet bör tolken avsluta med en felstatus skild från noll, istället för att försöka virra sig genom och möjligen generera felaktiga utdata. En ändringsloggtolk kan inte på något sätt interagera med användaren.

VARNINGAR¶

De olika parserflaggorna, bortsett -v, stöds enbart i dpkg version 1.14.16 och senare. Tredjepartsparsrar för andra ändringsloggformat än debian kanske inte stöder alla flaggor.

FILER¶

debian/changelog

Ändringsloggsfilen, används för att hämta versionsberoende information om källkodspaketet, till exempel brådska och utgåva för en insändning, ändringarna som utförts sedan en specifik version och själva versionsnumret på källkoden.

ÖVERSÄTTNING¶

Peter Krefting och Daniel Nylander.