summaryrefslogtreecommitdiffstats
path: root/man/sv/deb-changes.pod
blob: edd48fefb4e83ba978c9c9f8e6821d1c4d6331b9 (plain)
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
        *****************************************************
        *           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

dpkg-changes - filformat för Debians ändringsfiler vid insändning

=head1 SYNOPS

I<filnamn>B<.changes>

=head1 BESKRIVNING

Varje Debianinsändning består av en styrfil .changes, som innehåller ett antal fält i L<deb822(5)>-format.

Varje fält börjar med en etikett, såsom B<Source> eller B<Binary> (skiftlägesoberoende), följt av ett kolontecken och fältets kropp (skiftlägesberoende såvida inte annat anges). Fält avdelas endast av fältetiketter. Med andra ord kan texten i fälten spänna över flera rader, men installationsverktygen kommer oftast att slå samman rader när kroppen tolkas (förutom när det gäller flerradsfälten B<Description>, B<Changes>, B<Files>, B<Checksums-Sha1> och B<Checksums-Sha256>, se nedan).

Styrinformationen kan omges av en OpenPGP-signatur i ASCII-skal, såsom beskrivs i RFC4880.

=head1 FÄLT

=over 

=item B<Format:> I<formatversion> (krävs)

Värdet för fältet anger filens formatversion. Fältets syntax är ett versionsnummer med en huvud- och en underdel. Ändringar som inte är bakåtkompatibla ökar huvudversionen medan ändringar som är bakåtkompatibla (till exempel nya fält) ökar underversionen. Aktuell formatversion är B<1.8>.

=item B<Date:> I<utgivningsdatum> (krävs)

Det datum då paketet sist byggdes eller redigerades. Det måste vara på samma format som datumet i L<deb-changelog(5)>-posten.

Värdet på fältet hämtas vanligtvis ut från filen I<debian/changelog>.

=item B<Source:> I<källkodsnamn> [B<(>I<källkodsversion>B<)>] (krävs)

Namnet på källkodspaketet. Om versionen på källkoden inte är samma som versionen på binären kommer I<källkodsnamn> åtföljas av en I<källkodsversion> i parentes. Detta kan uppstå när bygget ä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”).

=item B<Binary:> I<binärpaketlista> (krävs i sammanhang)

Det här flerdelade fältet är en blankstegsavdelad lista över binärpaket som ska sändas in. Om insändningen endast består av källkod kan fältet utelämnas (sedan dpkg 1.19.3).

=item B<Architecture:> I<arklista>>

Listar arkitekturer för de filer som sänds in just nu. Vanliga arkitekturer är B<amd64>, B<armel>, B<i386>, osv. Observera att värdet B<all> är avsett för paket som är oberoende av arkitektur. Om källkoden för paketet också sänds in måste specialvädet B<source> också tas med. Arkitekturer med jokertecken är inte tillåtna i listan.

=item B<Version:> I<versionssträng> (krävs)

Vanligtvis är detta det ursprungliga paketets versionsnummer på den form programmets författare använder. Den kan även innehålla ett Debianuppdateringsnummer (för paket vars källa är utanför Debian). Exakt format och sorteringsalgoritm beskrivs i L<deb-version(7)>.

=item B<Distribution:> I<distribution>er (krävs)

Listar en eller flera blankstegsavdelade distributioner där denna version ska installeras när den har sänts in till arkivet.

=item B<Urgency:> I<brådska> (rekommenderas)

Hur brådskande insändningen är. De för närvarande kända värdena, sorterande från minst till mest brådskande, är: B<low>, B<medium>, B<high>, B<critical> and B<emergency>.

=item B<Maintainer:> I<fullt-namn-epost> (krävs)

Ska vara på formatet ”Joe Bloggs E<lt>jbloggs@example.orgE<gt>” och är normalt sett den person som skapat paketet, till skillnad från författaren av den programvara som paketerades.

=item B<Changed-By:> I<fullt-namn-epost>

Ska vara på formatet ”Joe Bloggs E<lt>jbloggs@example.orgE<gt>” och är normalt sett den person som förberett paketändringarna för denna utgåva.

=item B<Description:> (rekommenderas)

=item S< >I<binärpaketnamn> B<-> I<binärpaketsammanfattning>

Detta flerradiga fält innehåller en lista över binärpaketnamn följt av ett blanksteg, ett bindestreck (”B<->”) och deras möjligen avkortade korta beskrivningar. Om insändningen endast består av källkod kan fältet utelämnas (sedan dpkg 1.19.3).

=item B<Closes:> I<felnummer-lista>

En blankstegsavdelad lista över felrapportnummer för felrapporter som lösts med denna insändning. Distributionsarkivprogramvaran kan använda detta fält för att automatiskt stänga de angivna felrapporterna i distributionens felrapporteringssystem.

=item B<Binary-Only: yes>

Det här fältet anger att insändningen är bestående av enbart binärer från någon annan än den paketansvarige (”binary-only non-maintainer build”). Den kommer från nyckeln och värdet B<binary-only=yes> i ändringsloggens metadatafält.

=item B<Built-For-Profiles:> I<profillista>

Det här fältet anger en blankstegsavdelad lista över byggprofiler som insändningen byggdes med.

=item B<Changes:> (krävs)

=item S< >I<ändringsloggposter>

Det här flerradiga fältet innehåller den sammanslagna texten från alla ändringsloggposter som är en del av insändningen. För att göra fältet till ett giltigt flerradsfält ersätts tomma rader med en ensam punkt (”.”) och alla rader får ett teckens indrag. Exakt innehåll beror på formatet på ändringsloggen.

=item B<Files:> (krävs)

=item S< >I<md5summa> I<storlek> I<sektion> I<prioritet> I<filnamn>

Det här flerradiga fältet innehåller en lista över filer tillsammans med md5-summa, storlek, sektion och prioritet för var och en av dem.

Första raden i fältvärdet (delen av på samma rad som fältnamnet följt av kolon) är alltid tom. Innehållet i fältet anges som fortsättningsrader, en rad per fil. Varje rad består av blankstegsavdelade fält som beskriver filen: md5-summan, filstorleken, filsektionen, filprioriteten och filnamnet.

Det här fälten visar alla filer insändningen består av. Listan över filer i fältet måste motsvara listan över filer i de andra relaterade B<Checksums>-fälten.

B<Note>: The MD5 checksum is considered weak, and should never be assumed to be sufficient for secure verification, but this field cannot be omitted as it provides metadata not available anywhere else.

=item B<Checksums-Sha1:> (required, weak)

=item B<Checksums-Sha256:> (required, strong)

=item S< >I<kontrollsumma> I<storlek> I<filnamn>

De här flerradsfälteten innehåller en lista med filer med en kontrollsumma och storlek för var och en. Fälten har samma syntax och skiljer sig bara vad gäller vilken kontrollsummealgoritm som används: SHA-1 för B<Checksums-Sha1> och SHA-256 för B<Checksums-Sha256>.

Första raden i fältvärdet (delen av på samma rad som fältnamnet följt av kolon) är alltid tom. Innehållet i fältet anges som fortsättningsrader, en rad per fil. Varje rad består av blankstegsavdelade fält som beskriver filen: kontrollsumman, filstorleken och filnamnet.

De här fälten visar alla filer insändningen består av. Listan över filer i fälten måste motsvara listan över filer i fältet B<Files> och de andra relaterade B<Checksums>-fälten.

B<Note>: The SHA-1 checksum is considered weak, and should never be assumed to be sufficient for secure verification.

=back

=head1 PROGRAMFEL

Fältet B<Files> är inte konsistent med de andra B<Checksums>-fälten. Fälten B<Changed-By> ocha B<Maintainer> har förvirrande namn. Fältet B<Distribution> innehåller information om vad som vanligtvis kallas en svit (”suite”).

=head1 SE ÄVEN

L<deb822(5)>, L<deb-src-control(5)>, L<deb-version(7)>.


=head1 ÖVERSÄTTNING

Peter Krefting och Daniel Nylander.