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
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
|
*****************************************************
* 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
dsc - styrfilformat för Debians källkodspaket
=head1 SYNOPS
I<filnamn>B<.dsc>
=head1 BESKRIVNING
Alla Debian-källkodspaket består av en .dsc-styrfil, vilken består av 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<Package-List>, B<Files>,
B<Checksums-Sha1> and 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 på det här fältet deklarerar formatversionen för
källkodspaketet. Fältvärdet används av program som arbetar på källkodspaket
för att tolka listan över filer i källkodspaketet och bestämma hur det ska
pakcas upp. Syntaxen för fältet är ett huvudversionsnummer (”0-9”), en punkt
(”.”), ett numeriskt underversionsnummer (”0-9”), och därefter en valfri
undertyp efter ett blanksteg (” \t”), vilket, om det anges, är ett ord med
små alfanumeriska (”a-z0-9”) tecken i paranteser (”()”). Undetypen är valfri
i syntaxen men kan krävas för specifika källkodsformatversioner.
De källkodsformat som för närvarande stöds av B<dpkg> är B<1.0>, B<2.0>,
B<3.0 (native)>, B<3.0 (quilt)>, B<3.0 (git)>, B<3.0 (bzr)> och B<3.0
(custom)>. Se B<dpkg-source>(1) för beskrivningar.
=item B<Source:> I<källkodsnamn> (krävs)
Värdet på fältet bestämmer paketets namn, och används av de flesta
installationsverktygen för att generera filnamnen.
=item B<Binary:> I<binärpaketlista>
Det här flerdelade fältet listar binärpaket som detta källkodspaket kan
producera, avdelade med kommatecken.
Fältet har nu ersatts av fältet B<Package-List>, som ger tillräcklig
information om vilka binärpaket som skapas på vilka arkitekturer,
byggprofiler och andra inverkande begränsningar.
=item B<Architecture:> I<arkitekturlista> (rekommenderas)
En lista över arkitekturer och arkitekturmönster avdelade med blanksteg som
anger vilken typ av maskinvara paketet kan kompileras för. Vanliga
arkitekturnamn och arkitekturmönster är B<amd64>, B<armel>, B<i386>,
B<linux-any>, B<any-amd64>, osv.
Observar att värdet B<all> är tänkt för paket som är plattformsoberoende,
och B<any> för paket som är arkitekturberoende. Listan kan innehålla (eller
enbart bestå av) specialvärdet B<all>. När listan innehåller
arkitekturmönstret B<any> är det enda andra tillåtna värdet i listan B<all>.
Fältvärdet genereras normalt från fälten B<Architecture> i filen
I<debian/control> i källkodspaketet.
=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 B<deb-version>(7).
=item B<Origin:> I<namn>
Namnet på den distribution paketet härstammar från.
=item B<Maintainer:> I<fullt-namn-epost> (rekommenderas)
Ska vara på formatet ”Joe Bloggs E<lt>jbloggs@foo.comE<gt>” och är normalt
sett den person som skapat paketet, till skillnad från författaren av den
programvara som paketerades.
=item B<Uploaders:> I<fullt-namn-epost-lista>
Räknar upp namn och e-postadresser till med-underhållare av paketet, i samma
format som fältet B<Maintainer>. Flera med-underhållare bör avdelas med
kommatecken.
=item B<Description:> I<kort-beskrivning>)
=item B<> I<lång-beskrivning>
Formatet för källkodspaketbeskrivningen är en kortfattad sammanfattning på
den första raden (efter fältet B<Description>). Följande rader bör användas
för en längre, mer detaljerad beskrivning. Varje rad i den lägre
beskrivningen måste inledas med ett blanksteg, och blanka rader i den långa
beskrivningen måste innehålla en ensam ”B<.>” efter det inledande
blanksteget.
=item B<Homepage:> I<url>
URL till uppströmsprojektets hemside-I<url>.
=item B<Standards-Version:> I<versionssträng> (rekommenderas)
Dokumenterar den senaste versionen av distributionens policystandard som
paketet uppfyller.
=item B<Vcs-Browser:> I<url>
I<Url>:en till ett webbgränssnitt för att bläddra i
versionshanteringsarkivet.
=item B<Vcs-Arch:> I<url>
=item B<Vcs-Bzr:> I<url>
=item B<Vcs-Cvs:> I<url>
=item B<Vcs-Darcs:> I<url>
=item B<Vcs-Git:> I<url>
=item B<Vcs-Hg:> I<url>
=item B<Vcs-Mtn:> I<url>
=item B<Vcs-Svn:> I<url>
Dessa fält anger I<url> till det versionshanteringssystemakriv som används
för att underhålla paketet. Se B<deb-src-control>(5) för ytterligare
detaljer.
=item B<Testsuite:> I<namnlist>
Fältet anger att källkodspaketet innehåller de angivna testsviterna. Värdet
är en kommaavdelad lista med testsviter. Om värder B<autopkttest> finns,
förväntas det att I<debian/test/control> finns, om filen finns men inte
värdet kommer B<dpkg-source> automatiskt lägga till på det och bibehålla
tidigare värden.
=item B<Testsuite-Triggers:> I<paketlista>
Fältet anger den kommaavdelade unionen av alla testberoenden (fältet
B<Depends> i filen I<debian/tests/control>), med alla begränsningar
borttagna, och ELLER-beroenden tillplattade (det vill säga, konverterade
till separata OCH-relationer), med undantag för binärar som skapas av detta
källkodspaket och dess metaberoende-motsvarighet B<@>.
Grund: fältet behövs eftersom man annars för att kunna hämta testbeorenden
måste packa upp alla källkodspaketen.
=item B<Build-Depends:> I<paketlista>
=item B<Build-Depends-Arch:> I<paketlista>
=item B<Build-Depends-Indep:> I<paketlista>
=item B<Build-Conflicts:> I<paketlista>
=item B<Build-Conflicts-Arch:> I<paketlista>
=item B<Build-Conflicts-Indep:> I<paketlista>
Dessa fält anger relationer mellan källkodspaket och de paket som används
för att bygga det. De diskuteras i manualsidan B<deb-src-control>(5).
=item B<Package-List:>
=item S< >I<paket> I<pakettyp> I<sektion> I<prioritet> I<nyckel-värde-lista>
Det här flerradiga fältet innehåller en lista över binärpaket som skapas av
detta källkodspaket.
I<paket> är namnet på binärpaketet.
I<pakettyp> är typen på det binära paketet, vanligtvis B<deb>, ett annat
vanligt värde är B<udeb>.
I<sektion> och I<prioritet> motsvarar fälten med samma namn i binärpaketet.
I<nyckel-värde-lista> är en blankstegsavdelad lista på formen
I<nyckel>B<=>I<värde>, och de för närvarande kända valfria nycklarna är:
=over
=item B<arch>
Arkitekturbegränsning från binärpaketets fält B<Architecture>, med blanksteg
ersatta med ”,”.
=item B<profile>
Den normaliserade byggprofil-begränsningsformeln från binärpaketets fält
B<Build-Profile>, med OR (eller) ersatt med ”+” och AND (och) med ”,”.
=item B<protected>
Om binärpaketet är skyddat kommer den här nyckeln innehålla värdet på fältet
B<Protected>, det vill säga värdet B<yes>.
=item B<essential>
Om binärpaketet är systemkritiskt kommer den här nyckeln innehålla värdet på
fältet B<Essential>, det vill säga värdet B<yes>.
=back
=item B<Files:> (krävs)
=item B<Checksums-Sha1:> (krävs)
=item B<Checksums-Sha256:> (krävs)
=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: MD5 för B<Files>, 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 kontrollsumman, ett blanksteg,
filstorleken, ett blanksteg och filnamnet.
De här fälten visar alla filer källkodspaketet består av. Listan över filer
i dessa fält måste motsvara listan över filer i de andra relaterade fälten.
=back
=head1 PROGRAMFEL
Fältet B<Format> blandar formatet på själva B<.dsc>-filen och formatet på
det extraherade källkodspaketet.
=head1 SE ÄVEN
L<deb822(5)>, B<deb-src-control>(5), B<deb-version>(7), B<dpkg-source>(1).
=head1 ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.
|
