.\" -*- 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 "dpkg-parsechangelog 1"
.TH dpkg-parsechangelog 1 2024-03-10 1.22.6 "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 NAMN
.IX Header "NAMN"
dpkg-parsechangelog \- tolka Debians \(:andringsloggar
.SH SYNOPS
.IX Header "SYNOPS"
\&\fBdpkg-parsechangelog\fR [\fIflagga\fR...]
.SH BESKRIVNING
.IX Header "BESKRIVNING"
\&\fBdpkg-parsechangelog\fR l\(:aser och tolkar \(:andringsloggen i ett uppackat Debiank\(:allkodstr\(:ad och visar informationen i den p\(oa standard ut i en maskinl\(:asbar form.
.SH FLAGGOR
.IX Header "FLAGGOR"
.IP "\fB\-l\fR, \fB\-\-file\fR \fI\(:andringsloggfil\fR" 4
.IX Item "-l, --file \(:andringsloggfil"
Anger \(:andringsloggfilen som information ska l\(:asas fr\(oan. Ett \(rq\-\(rq kan anv\(:andas f\(:or att ange l\(:asning fr\(oan stadnard in. Standardv\(:ardet \(:ar \fBdebian/changelog\fR.
.IP "\fB\-F\fR \fI\(:andringsloggformat\fR" 4
.IX Item "-F \(:andringsloggformat"
Specifies the format of the changelog.  By default the format is read from a special line near the bottom of the changelog or failing that defaults to the \fBdebian\fR standard format.  See also "CHANGELOG FORMATS".
.IP "\fB\-L\fR \fIbibliotekskatalog\fR" 4
.IX Item "-L bibliotekskatalog"
F\(:or\(oaldrad flagga utan effekt (sedan dpkg 1.18.8). En liknande effekt kan uppn\(oas f\(:or att s\(:oka perl-tolkningsmodulerna genom att s\(:atta milj\(:ovariablerna \fBPERL5LIB\fR eller \fBPERLLIB\fR
.IP "\fB\-S\fR, \fB\-\-show\-field\fR \fIf\(:alt\fR" 4
.IX Item "-S, --show-field f\(:alt"
Anger namnet p\(oa ett f\(:alt att visa (sedan dpkg 1.17.0). F\(:altnamnet visas inte, endast dess v\(:arde.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
Visar hj\(:alpsk\(:arm och avslutar.
.IP \fB\-\-version\fR 4
.IX Item "--version"
Visar version och avslutar.
.SS Parserflaggor
.IX Subsection "Parserflaggor"
F\(:oljande flaggor kan anv\(:andas f\(:or att styra utdata fr\(oan \(:andringsloggtolken, till exempel omf\(oanget av poster eller formatet p\(oa utdata.
.IP "\fB\-\-format\fR \fIutdataformat\fR" 4
.IX Item "--format utdataformat"
V\(:alj utdataformat. St\(:odda format \(:ar f\(:or n\(:arvarande \fBdpkg\fR och \fBrfc822\fR. \fBdpkg\fR \(:ar det klassiska utdataformatet (fr\(oan innan denna flagga var tillg\(:anglig) och f\(:orvalet. Det best\(oar av ett stycke i Debians control-format (se \fBdeb\-control\fR\|(5)). Om mer \(:an en post \(:onskas tas de flesta f\(:alt fr\(oan den f\(:orsta posten (vanligtvis den nyaste posten), f\(:orutom om annat anges:
.RS 4
.IP "\fBSource:\fR \fIpaketnamn\fR" 4
.IX Item "Source: paketnamn"
Namnet p\(oa k\(:allkodspaketet.
.IP "\fBVersion:\fR \fIversion\fR" 4
.IX Item "Version: version"
Versionsnummer f\(:or k\(:allkoden. \fBObservera\fR: F\(:or ins\(:andningar av endast bin\(:arer kan det h\(:anda att det inte finns n\(oagon motsvarande k\(:allkodsutg\(oava.
.IP "\fBDistribution:\fR \fIm\(oalutg\(oava\fR" 4
.IX Item "Distribution: m\(oalutg\(oava"
En blankstegsavdelad lista med ett eller flera distributionsnamn d\(:ar denna version ska installeras n\(:ar den har s\(:ants in till arkivet.
.IP "\fBUrgency:\fR \fIbr\(oadska\fR" 4
.IX Item "Urgency: br\(oadska"
H\(:ogsta br\(oadskan av alla de inkluderade posterna anv\(:ands, f\(:oljt av de sammanslagna (avdelade med blanksteg) kommentarerna fr\(oan alla de beg\(:arda versionerna.
.IP "\fBMaintainer:\fR \fIf\(:orfattare\fR" 4
.IX Item "Maintainer: f\(:orfattare"
Namn och e\-postadress till den person som f\(:orberett \(:andringarna, de \(:ar \fBinte\fR n\(:odv\(:andigtvis samma som den som s\(:ant in dem eller den vanlige paketansvarige.
.IP "\fBDate:\fR \fIdatum\fR" 4
.IX Item "Date: datum"
Postens datum, s\(oa som det st\(oar skrivet i \(:andringsloggen. Med ett \fBstrptime\fR\|(3)\-format p\(oa "\fR\f(CB%a\fR\fB, \fR\f(CB%d\fR\fB \fR\f(CB%b\fR\fB \fR\f(CB%Y\fR\fB \fR\f(CB%T\fR\fB \fR\f(CB%z\fR\fB\fR", men d\(:ar veckodagen kanske inte n\(:odv\(:andigtvis motsvarar den faktiska dagen som h\(:amtas fr\(oan resten av datumstr\(:angen. Om du beh\(:over en mer korrekt representation av datumet, anv\(:and f\(:altet \fBTimestamp\fR, men t\(:ank p\(oa att det kanske inte \(:ar m\(:ojligt att koppla det tillbaka till det exakta v\(:ardet p\(oa det h\(:ar f\(:altet.
.IP "\fBTimestamp:\fR \fItidsst\(:ampel\fR" 4
.IX Item "Timestamp: tidsst\(:ampel"
Datumet f\(:or posten som en tidsst\(:ampel i sekundeer sedan epoken (sedan dpkg 1.18.8).
.IP "\fBCloses:\fR \fInummer\-p\(oa\-felrapport\fR" 4
.IX Item "Closes: nummer-p\(oa-felrapport"
Closes\-f\(:altet i alla inkluderade poster sl\(oas samman.
.IP "\fBChanges:\fR \fIposter\-fr\(oan\-\(:andringsloggen\fR" 4
.IX Item "Changes: poster-fr\(oan-\(:andringsloggen"
Texten i alla \(:andringsloggposter sl\(oas samman. F\(:or att g\(:ora f\(:altet till giltigt flerradsf\(:alt i Debian-control-format ers\(:atts tomma rader med en ensam punkt och alla rader f\(oar ett teckens indrag. Exakt inneh\(oall beror p\(oa formatet p\(oa \(:andringsloggen.
.RE
.RS 4
.Sp
F\(:alten \fBVersion\fR, \fBDistribution\fR, \fBUrgency\fR, \fBMaintainer\fR och \fBChanges\fR kr\(:avs.
.Sp
Ytterligare anv\(:andardefinierade f\(:alt kan finnas.
.Sp
\&\fBrfc822\fR\-formatet anv\(:ander samma f\(:alt, men ger ett separat stycke f\(:or varje \(:andringsloggspost s\(oa att all metadata f\(:or varje post beh\(oalls.
.RE
.IP \fB\-\-reverse\fR 4
.IX Item "--reverse"
Inkludera alla \(:andringar i omv\(:and ordning (sedan dpkg 1.19.1).
.Sp
\&\fBObservera\fR: F\(:or \fBdpkg\fR\-formatet kommer den f\(:orsta posten vara den \(:aldsta posten.
.IP \fB\-\-all\fR 4
.IX Item "--all"
Ta med alla \(:andringar. \fBObservera\fR: \(:ovriga flaggor har ingen effekt n\(:ar denna anv\(:ands.
.IP "\fB\-s\fR, \fB\-\-since\fR \fIversion\fR" 4
.IX Item "-s, --since version"
.PD 0
.IP "\fB\-v\fR \fIversion\fR" 4
.IX Item "-v version"
.PD
Ta med alla poster senare \(:an \fIversion\fR.
.IP "\fB\-u\fR, \fB\-\-until\fR \fIversion\fR" 4
.IX Item "-u, --until version"
Ta med alla \(:andringar tidigare \(:an \fIversion\fR.
.IP "\fB\-f\fR, \fB\-\-from\fR \fIversion\fR" 4
.IX Item "-f, --from version"
Ta med alla \(:andringar fr\(oan och med \fIversion\fR.
.IP "\fB\-t\fR, \fB\-\-to\fR \fIversion\fR" 4
.IX Item "-t, --to version"
Ta med alla \(:andringar till och med \fIversion\fR.
.IP "\fB\-c\fR, \fB\-\-count\fR \fIantal\fR" 4
.IX Item "-c, --count antal"
.PD 0
.IP "\fB\-n\fR \fIantal\fR" 4
.IX Item "-n antal"
.PD
Ta med \fIantal\fR \(:andringar fr\(oan b\(:orjan (eller slutet om \fIantal\fR \(:ar l\(:agre \(:an 0).
.IP "\fB\-o\fR, \fB\-\-offset\fR \fIantal\fR" 4
.IX Item "-o, --offset antal"
\(:Andra startpunkt f\(:or \fB\-\-count\fR, r\(:aknat fr\(oan b\(:orjan (eller slutet om \fIantal\fR \(:ar l\(:agre \(:an 0).
.SH "FORMAT P\(oA \(:ANDRINGSLOGGEN"
.IX Header "FORMAT P\(oA \(:ANDRINGSLOGGEN"
Det \(:ar m\(:ojligt att anv\(:anda ett annat format \(:an standard, genom att tillhandah\(oalla en tolk f\(:or det alternativa formatet.
.PP
F\(:or att l\(oata \fBdpkg-parsechangelog\fR k\(:ora den nya tolken m\(oaste en rad som motsvarar det regulj\(:ara uttrycket (Perl-format) \(lq\fB\eschangelog\-format:\es+([0\-9a\-z]+)\eW\fR\(rq l\(:aggas in bland de 40 sista raderna i \(:andringsloggfilen. Delen i parentes \(:ar namnet p\(oa formatet. Till exempel:
.Sp
.RS 4
@@@ changelog-format: \fIannatformat\fR @@@
.RE
.PP
Namn p\(oa \(:andringsloggformat \(:ar icke-tomma str\(:angar med sm\(oa alfanumeriska tecken (\(rqa\-z0\-9\(rq).
.PP
Om en s\(oadan rad finns kommer \fBdpkg-parsechangelog\fR att leta efter tolken som en perlmodul \fBDpkg::Changelog::\fR\fIannatformat\fR; det \(:ar ett fel om det inte finns. Standardformatet f\(:or \(:andringsloggar \(:ar \fBdebian\fR och en tolk f\(:or detta format inkluderas som standard.
.PP
Tolken ska vara ett derivat av klassen Dpkg::Changelog och implementera de kr\(:avda dokumenterade gr\(:anssnitten.
.PP
Om \(:andringsloggformatet som tolkas alltid eller n\(:astan alltid inneh\(oaller en blank rad mellan individuella \(:andringsposter b\(:or dessa blanka rader tas bort, s\(oa att utdataformatet blir mer kompakt.
.PP
Om \(:andringsloggformatet inte inneh\(oaller information om datum eller paketnamn b\(:or denna information utel\(:amnas fr\(oan utdata. Tolken b\(:or inte f\(:ors\(:oka skapa den eller hitta den i andra k\(:allor.
.PP
Om \(:andringsloggen inte har det f\(:orv\(:antade formatet b\(:or tolken avsluta med en felstatus, ist\(:allet f\(:or att f\(:ors\(:oka virra sig genom och m\(:ojligen generera felaktiga utdata.
.PP
En \(:andringsloggtolk kan inte p\(oa n\(oagot s\(:att interagera med anv\(:andaren.
.SH ANTECKNINGAR
.IX Header "ANTECKNINGAR"
De olika \fBparserflaggorna\fR, bortsett \fB\-v\fR, st\(:ods enbart sedan dpkg 1.14.16.
.PP
Hantering av korta flaggor med icke\-meds\(:anda v\(:arden \(:ar endast tillg\(:angligt edan dpkg 1.18.0.
.SH MILJ\(:OVARIABLER
.IX Header "MILJ\(:OVARIABLER"
.IP \fBDPKG_COLORS\fR 4
.IX Item "DPKG_COLORS"
V\(:aljer f\(:argl\(:age (sedan dpkg 1.18.5). F\(:or n\(:arvarande godtas f\(:oljande v\(:arden: \fBauto\fR (f\(:orval), \fBalways\fR och \fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
Om satt, anv\(:ands f\(:or att best\(:amma om lokalt spr\(oakst\(:od ska aktiveras, \(:aven k\(:ant som internationaliseringsst\(:od (eller i18n) (sedan dpkg 1.19.0). Till\(oatna v\(:arden \(:ar: \fB0\fR och \fB1\fR (f\(:orval).
.SH FILER
.IX Header "FILER"
.IP \fBdebian/changelog\fR 4
.IX Item "debian/changelog"
\(:Andringsloggsfilen, anv\(:ands f\(:or att h\(:amta versionsberoende information om k\(:allkodspaketet, till exempel br\(oadska och utg\(oava f\(:or en ins\(:andning, \(:andringarna som utf\(:orts sedan en specifik version och sj\(:alva versionsnumret p\(oa k\(:allkoden.
.SH PROGRAMFEL
.IX Header "PROGRAMFEL"
F\(:altet \fBMaintainer\fR har ett f\(:orvirrande namn som motsvarar f\(:altet i filen \fIdebian/control\fR men inte dess exakta betydelse, d\(:ar dess betydelse b\(:attre kunde beskrivas av \fBChanged-By\fR\-f\(:altnamnet som anv\(:ands i filen \fI.changes\fR.
.SH "SE \(:AVEN"
.IX Header "SE \(:AVEN"
\&\fBdeb\-changelog\fR\|(5).
.SH \(:OVERS\(:ATTNING
.IX Header "\(:OVERS\(:ATTNING"
Peter Krefting och Daniel Nylander.