1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
*****************************************************
* GENERATED FILE, DO NOT EDIT *
* THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
*****************************************************
This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.
In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.
=encoding UTF-8
=head1 NAMN
deb-changelog - filformat för ändringsloggfiler i Deibankällkodspaket
=head1 SYNOPS
B<debian/changelog>
=head1 BESKRIVNING
Ändringar i den paketerade versionen av ett projekt förklaras i ändringsloggfilen I<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:
Z<>
I<paket> (I<version>) I<distributioner>; I<metadata>
[valfri(a) blankrad(er), tas bort]
* I<ändringsdetalj>
I<fler-ändringsdetaljer>
[blankrad(er), tas med i utdata från L<dpkg-parsechangelog(1)>]
* I<ytterligare-ändringsdetaljer>
[valfri(a) blankrad(er), tas bort]
-- I<ansvarig-namn> <I<epost-adress>> I<datum>
I<paket> och I<version> är källkodspaketets namn och versionsnummer. I<version> avdelas av parentes U+0028 ”B<(>” och U+0029 ”B<)>”.
I<distributioner> anger en eller flera blankstegsavdelade distributioner där den här versionen ska installeras efter insändning; värdet kopieras till fältet B<Distribution> i I<.changes>-filen. I<distributions> måste avslutas av ett semikolon (U+003B ”B<;>”).
I<metadata> anger noll eller flera kommaseparerade poster på formen I<nyckelord>=I<värde>. Varje nyckelord innehåller endast minustecken och skiftlägesokänsliga alfanumeriska tecken, eftersom de måste kunna motsvara L<deb822(5)>-fältnamn. De enda I<nyckelord> som stöds av B<dpkg> för närvarande är:
=over
=item B<urgency> (brådska)
Värdet används för fältet B<Urgency> i I<.changes>-filen vid insändning.
=item B<binary-only> (endast binär)
Med värdet B<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).
=back
Ändringsdetaljerna kan faktiskt vara valfri serie av rader som börjar med minst två blanksteg (U+0020 B<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:
=over
B<Closes: #>I<nnnnn>
=back
i ändringsdetaljerna, där B<#>I<nnnnn> är felrapportsnumret. Exakt Perl-reguljärt uttryck är:
=over
B</closes:\s*(?:bug)?\#?\s?\d+(?:,\s*(?:bug)?\#?\s?\d+)*/i>
=back
Det vill säga, strängen bör bestå av ordet B<closes:> följt av en kommaavdelad lista med felrapportsnummer. Felrapporterna kan föregås av ordet B<bug> och/eller tecknet B<#>, som i C<Closes: 42, bug#43, #44, bug 45>. Ordet B<closes:> och B<bug> är inte skiftlägeskänsliga. Listan med relrapportsnummer kan fortsätta över flera rader.
Informationen vidareförs via fältet B<Closes> i 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 B<inte> nödvändigtvis samma som insändaren eller den vanlige paketansvarige. Informationen kopieras till fältet B<Changed-By> i 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.
I<datum> har följande format (kompatibelt med och med samma betydelse som RFC2822 and RFC5322, eller det ”date -R” skapar):
=over
I<veckodag>B<,> I<dd> I<månad> I<åååå> I<hh>B<:>I<mm>B<:>I<ss> B<+>I<zzzz>
=back
där:
=over
=item I<veckodag>
Är en av: B<Mon>, B<Tue>, B<Wed>, B<Thu>, B<Fri>, B<Sat>, B<Sun>.
=item I<dd>
Är dag i månaden (B<01>-B<31>) med en eller två siffror, där den inledande nollan är valfri, men vanligtvis inte utesluts.
=item I<månad>
Är en av: B<Jan>, B<Feb>, B<Mar>, B<Apr>, B<May>, B<Jun>, B<Jul>, B<Aug>, B<Sep>, B<Oct>, B<Nov>, B<Dec>.
=item I<åååå>
Är det fyrasiffriga året (t.ex 2010).
=item I<hh>
Är den tvåsiffriga timmen (B<00>-B<23>).
=item I<mm>
Är den tvåsiffriga minuten (B<00>-B<59>).
=item I<ss>
Är den tvåsiffriga sekunden (B<00>-B<60>).
=item [B<+->]I<zzzz>
Är skillnaden i tidszon från Koordinerad universell tid (UTC). ”B<+>” anger att tiden är framför (dvs. öster om) UTC och ”B<->” 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 B<00>-B<59>.
=back
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 B<SPACE>). Informationen om ansvarige och datumet måste åtskiljas av exakt två blanksteg (U+0020 B<SPACE>). Varje del av I<datum> kan avdelas av ett eller flera blanksteg (U+0020 B<SPACE>), bortsett från efter komma där det kan avdelas av noll eller flera blanksteg (U+0020 B<SPACE>).
Rader som i sin helhet (dvs., inga inledande blanksteg) består av kommentarer på formen B<#> eller B</* */> 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.
=head1 FILER
=over
=item I<debian/changelog>
=back
=head1 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
=head1 SE ÄVEN
L<deb822(5)>, L<deb-changes(5)>, L<deb-version(7)>, L<dpkg-parsechangelog(1)>.
=head1 ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.
|
