summaryrefslogtreecommitdiffstats
path: root/man/sv/deb-src-control.pod
blob: db73ff21fb526cdc1110d1485cbf516a1f1d163a (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
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
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
        *****************************************************
        *           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-src-control - Debians filformat för källkodspakets huvudstyrfil

=head1 SYNOPS

B<debian/control>

=head1 BESKRIVNING

Varje Debiankällkodspaket innehåller huvudstyrfilen ”B<debian/control>”, och
dess L<deb822(5)>-format är en övermängd av B<control>-filen som medföljer
Debianbinärpaket, se B<deb-control>(5).

Filen innehåller åtminstone två stycken, avdelade med en tomrad. Det första
stycket innehåller all generell information om källkodspaketet, medan de
följande styckena beskriver exakt ett binärpaket. Varje stycke består av
åtminstone ett fält. Ett fält inleds med ett fältnamn, till exempel
B<Package> eller B<Section> (skiftlägesokänsligt), följt av ett kolon,
fältinnehållet (skiftlägekänsligt om inte annat anges) och ett
nyradstecken. Flerradiga fält är också tillåtna, men varje ytterligare rad
som inte innehåller ett fältnamn, bör starta med minst ett
blanksteg. Innehållet i flerradsfält slås normalt samman till en enda rad av
verktygen (förutom i fallet fältet B<Description>, se nedan). För att sätta
in tomma rader i ett flerradsfält, skriver du en punkt efter
blanksteget. Rader som börjar med ett ”B<#>” tolkas som kommentarer.

=head1 KÄLLKODSFÄLT

=over 

=item B<Source:> I<källkodspaketnamn> (krävs)

Värdet på det här fältet är namnet på källkodspaketet, och måste motsvara
namnet på källkodspaketet i filen debian/changelog. Paketnamnet måste bestå
endast av små bokstäver (a-z), siffror (0-9), plus- (+) och minustecken (-)
och punkt (.). Paketnamn måste vara minst två tecken långa och måste börja
med ett liten bokstav eller siffra (a-z0-9).

=item B<Maintainer:> I<fullt-namn-epost> (rekommenderas)

Ska vara på formatet ”Joe Bloggs E<lt>jbloggs@foo.comE<gt>” och refererar
till den person som för närvarande underhåller paketet, till skillnad från
programmets författare eller den ursprunglige paketeraren.

=item B<Uploaders:> I<fullt-namn-epost>

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<Standards-Version:> I<versionssträng>

Dokumenterar den senaste versionen av distributionens policystandard som
paketet uppfyller.

=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 hemsida.

=item B<Bugs:> I<url>

I<Url>:en till felrapporteringssystemet för detta paket. Det nuvarande
formatet är I<systemtyp>://I<address>, till exempel
B<debbugs://bugs.debian.org>. Det här fältet är normalt sett inte
nödvändigt.

=item B<Rules-Requires-Root:> B<no>|B<binary-targets>|I<impl-nyckelord>

Det här fältet används för att ange om filen B<debian/rules> kräver
(fake)root-privilegier för att köra några av sina mål, och i så fall när.

=over 

=item B<no> (nej)

Binärmålen kommer inte kräva (fake)root överhuvudtaget.

=item B<binary-targets>

Binärmålen måste alltid köras under (fake)root. Detta är förvalet om fältet
inte anges; även om det inte är strikt nödvändigt att lägga till fältet med
värdet B<binary-targets> så anger det att paketet har analyserats för det
här kravet.

=item I<impl-nyckelord>

Det här är en blankstegsavdelad lista med nyckelord som kan ange när
(fake)root krävs.

Nyckelord består av I<namnrymd>/I<fall>. Delen I<namnrymd> kan inte
innehålla "/" eller blanksteg. Delen I<fall> kan inte innehålla
blanksteg. Dessutom måste bägge delarna i sin helhet bestå av skrivbara
ASCII-tecken.

Varje verktyg/paket definierar en namnrymd med samma namn som sig själv och
anger ett antal fall där (fake)root krävs. (Se "Implementation provided
keywords" i I<rootless-builds.txt>).

När fältet är satt till ett av I<impl-nyckelord> kommer byggaren att
exponera ett gränssnitt som används för att köra ett kommando under
(fake)root. (Se "Gain Root API" i I<rootless-builds.txt>.)

=back

=item B<Testsuite:> I<namnlist>

=item B<Testsuite-Triggers:> I<paketlista>

Dessa fält beskrivs i manualsidan B<dsc>(5), eftersom de genereras från
information hämtad från B<debian/tests/control> eller kopieras ordagrant
till källkodsstyrfilen.

=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>

I<Url>:en till versionshanteringsarkivet som används för att underhålla det
här paketet. För närvarande stöds B<Arch>, B<Bzr> (Bazaar), B<Cvs>,
B<Darcs>, B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) och B<Svn>
(Subversion). Fältet pekar normalt till den senaste versionen av paketet,
såsom huvudgrenen (main eller trunk).

=item B<Vcs-Browser:> I<url>

I<Url>:en till ett webbgränssnitt för att bläddra i
versionshanteringsarkivet.

=item B<Origin:> I<namn>

Namnet på den distribution paketet härstammar från. Det här fältet är
normalt sett inte nödvändigt.

=item B<Section:> I<sektion>

Detta är ett generellt fält som ger paketet en kategori baserat på
programvara som det installerar. Några vanliga sektioner är B<utils>,
B<net>, B<mail>, B<text>, B<x11>, osv.

=item B<Priority:> I<prioritet>

Ställer in hur viktigt paketet är jämfört med systemet som helhet. Vanliga
prioriteter är B<required> (nödvändig), B<standard> (normal), B<optional>
(valfritt), B<extra> (extra), osv.

Gälten B<Section> och B<Priority> har vanligtvis en definierad uppsättning
accepterade värden baserade på den specifika distributionens policy.

=item B<Build-Depends:> I<paketlista>

En lista över paket som måste installeras och konfigureras för att kunna
bygga källkodspaketet. Dessa beroenden måste tillfredsställas när
binärarkitekturberoende eller -oberoende paket och källkodspaket byggs. Ett
beroende som beskrivs i den här listan har inte exakt samma effekt som att
inkludera det i både B<Build-Depends-Arch> och B<Build-Depends-Indep>,
eftersom beroendet också måste tilfredsställas när källkodspaketet byggs.

=item B<Build-Depends-Arch:> I<paketlista>

Motsvarar B<Build-Depends>, men de behövs endast för att bygga de
arkitekturoberoende paketen. B<Build-Depends> installeras också i detta
fall. Det här fältet stöds sedan dpkg 1.16.4; för att bygga med äldre
dpkg-versioner bör B<Build-Depends> användas istället.

=item B<Build-Depends-Indep:> I<paketlista>

Motsvarar B<Build-Depends>, men de behövs endast för att bygga de
arkitekturoberoende paketen. B<Build-Depends> installeras också i detta
fall.

=item B<Build-Conflicts:> I<paketlista>

En lista över paket som inte bör vara installerade när paketet byggs, till
exempel på grund av att de stör byggsystemet som används. Ett beroende som
beskrivs i den här listan har samma effekt som att inkludera det i både
B<Build-Conflicts-Arch> och B<Build-Conflicts-Indep>, med den ytterligare
effekten att den används för byggen av endast källkod.

=item B<Build-Conflicts-Arch:> I<paketlista>

Motsvarar B<Build-Conflicts>, men endast när arkitekturoberoende paket
byggs. Fältet stöds sedan dpkg 1.16.4; för att bygga med äldre versioner av
dpkg bör B<Build-Conflicts> användas istället.

=item B<Build-Conflicts-Indep:> I<paketlista>

Motsvarar B<Build-Conflicts>, men endast när de arkitekturoberoende paketen
byggs.

=back

Syntaxen för fälten B<Build-Depends>, B<Build-Depends-Arch> och
B<Build-Depends-Indep>-fälten är en lista med grupper av alternativa
paket. Varje grupp innehåller en lista med paket avdelade med ett
vertikalstreck (rör), ”B<|>”. Grupperna avdelas med kommatecken ”B<,>”, och
kan avslutas med ett släpande komma som tas bort när fälten genereras till
B<deb-control>(5) (sedan dpkg 1.10.14). Komma utläses som ”OCH”, och
vertikalstrecken som ”ELLER”, där vertikalstrecken binder hårdare. Varje
paketnamn kan eventuellt följas av en versionsnummerangivelse inom
parenteser ”B<(>” och ”B<)>”, en arkitekturangivelse inom hakparenteser
”B<[>” och ”B<]>” samt en begränsningsformel som består av en eller flera
listor med profilnamn inom vinkelparenteser ”B<E<lt>>” och ”B<E<gt>>”.

Syntaxen för fälten B<Build-Conflicts>, B<Build-Conflicts-Arch> och
B<Build-Conflicts-Indep>-fälten är en kommaseparerad lista med paketnamn,
där komma utläses som ”OCH”, och där listan kan avslutas med ett släpande
komma som tas bort när fälten genereras till B<deb-control>(5) (sedan dpkg
1.10.14). Det är inte möjligt att ange alternativa paket med ”rör”. Varje
paketnamn kan eventuellt följas av en versionsnummerangivelse inom
parenteser, en arkitekturangivelse inom hakparenteser samt en
begränsningsformel bestående av en eller flera listor med profilnamn inom
vinkelparenteser.

Ett arkitekturkvalificeringsnamn kan vara ett existerande
Debianarkitekturnamn (sedan dpkg 1.16.5), B<any> (sedan dpkg 1.16.2) eller
B<native> (sedan dpkg 1.16.5). Om det utesluts är förvalet för fältet
B<Build-Depends> den aktuella värdarkitekturen, förvalet för
B<Build-Conflicts> är B<any>. Ett existerande Debianarkitekturnamn motsvarar
exakt den arkitekturen för det paketnamnet, B<any> motsvarar valfri
arkitektur för paketnamnet om paketet har markerats som B<Multi-Arch:
allowed> och B<native> motsvarar nuvarande byggarkitektur om paketet inte
har markerats som B<Multi-Arch: foreign>.

Ett versionsnummer kan börja med ”B<E<gt>E<gt>>”, vilket betyder att vilken
som helst senare version matchar, där det är valfritt att ange
Debianuppdateringen (avdelad med bindestreck).  Tillåtna versionrelationer
är ”B<E<gt>E<gt>>” för större än, ”B<E<lt>E<lt>>” för mindre än, ”B<E<gt>=>”
för större än eller lika med, ”B<E<lt>=>” för mindre än eller lika med, och
”B<=>” för lika med.

En arkitekturangivelse består av ett eller flera arkitekturnamn, avdelade
med blanktecken. Varje namn kan föregås av ett utropstecken, vilket betyder
”ICKE”.

En begränsningsformel består av en eller flera begränsningslistor, avdelade
med blanksteg. Varje begränsningslista skrivs inom vinkelparenteser. Poster
i begränsningslistan är namn på byggprofiler, avdelade av blanksteg och kan
föregås av ett utropstecken, vilket betyder ”ICKE”. En begränsningsformel
representerar ett uttryck i disjunktiv normalform.

Observera att beroenden på paket i B<build-essential>-uppsättningen kan
utelämnas och att det är omöjligt att deklarera byggkonflikter mot dem. En
lista över dessa paket finns i paketet build-essential.

=head1 BINÄRFÄLT

Observera att fälten B<Priority>, B<Section> och B<Homepage> även kan
användas i de stycken som beskriver binärpaket för att överstyra de globala
värdena för källkodspaketet.

=over 

=item B<Package:> I<binärpaketnamn> (krävs)

Detta fält används för att namnge det binära paketet. Samma begränsningar
gäller som för källkodspaketets namn.

=item B<Package-Type:> B<deb>|B<udeb>|I<typ>

Detta fält anger paketets typ. B<udeb> används för storleksbegränsade paket
som används av debians installationsprogram. B<deb> är standardvärdet, och
antas om fältet saknas. Fler typer kan komma att läggas till i framtiden.

=item B<Architecture:> I<ark>|B<all>|B<any> (krävs)

Arkitekturen anger på vilken typ av maskinvara paketet körs. För paket som
körs på alla arkitekturer används värdet B<any> (någon). För paket som är
arkitekturoberoende, som skal- och Perlskript eller dokumentation, används
värdet B<all> (alla). För att begränsa paket till en specifik uppsättning
arkitekturer, anger du namnen på arkitekturerna avdelade med blanksteg. Det
är även möjligt att ange arkitekturer med jokertecken i listan (se
B<dpkg-architecture>(1) för mer information om dessa).

=item B<Build-Profiles:> I<begränsningsformel>

Det här fältet anger villkor för när binärpaketet ska eller inte ska
byggas. För att uttrycka villkoret används samma syntax för
begränsningsformeln som för fältet B<Build-Depends>.

Om ett stycke för ett binärpaket inte innehåller det här fältet betyder det
implicit att det bygger i alla byggprofiler (inklusive ingen alls).

Med andra ord, om ett stycke för ett binärpaket är försett med ett icke-tomt
B<Build-Profiles>-fält kommer det binärpaketet byggas om, och endast om,
villkoret, uttryckt i konjunktiv normalform, utvärderas till sant.

=item B<Protected:> B<yes>|B<no>

=item B<Essential:> B<yes>|B<no>

=item B<Build-Essential:> B<yes>|B<no>

=item B<Multi-Arch:> B<same>|B<foreign>|B<allowed>|B<no>

=item B<Tag:> I<lista-med-märken>

=item B<Description:> I<kort-beskrivning> (rekommenderas)

Dessa fält beskrivs i manualsidan B<deb-control>(5), eftersom de kopieras
ordagrant till binärpaketets styrfil.

=item B<Depends:> I<paketlista>

=item B<Pre-Depends:> I<paketlista>

=item B<Recommends:> I<paketlista>

=item B<Suggests:> I<paketlista>

=item B<Breaks:> I<paketlista>

=item B<Enhances:> I<paketlista>

=item B<Replaces:> I<paketlista>

=item B<Conflicts:> I<paketlista>

=item B<Provides:> I<paketlista>

=item B<Built-Using:> I<paketlista>

Det här fältet anger beroenden mellan paket. De diskuteras i manualsidan
B<deb-control>(5). När fälten förekommer i I<debian/control> kan de också
avslutas med ett släpande kommatecken (sedan dpkg 1.10.14), ha
arkitekturangivelser och begränsningsformler som alla reduceras när fälten
för B<deb-control>(5) genereras.

=item B<Subarchitecture:> I<värde>

=item B<Kernel-Version:> I<värde>

=item B<Installer-Menu-Item:> I<värde>

Dessa fält används av debian-installer i B<udeb>-formatet och behövs normalt
inte. Se /usr/share/doc/debian-installer/devel/modules.txt från paketet
B<debian-installer> för mer information om dem.

=back

=head1 ANVÄNDARDEFINIERADE FÄLT

Det är tillåtet att lägga till ytterligare användardefinierade fält till
styrfilen. Verktygen kommer ignorera dessa fält. Om du vill att fältet ska
kopieras över till utdatafilerna, så som binärpaketen, måste du använda ett
skräddarsytt namngivningsformat: fälten ska börja på B<X>, följt av noll
eller flera av tecknen S<SBC> och ett bindestreck.

=over 

=item B<S>

Fältet kommer tas med i styrfilen för källkodspaket, se B<dsc>(5).

=item B<B>

Fältet kommer tas med i styrfilen för binärpaketet, se B<deb-control>(5).

=item B<C>

Fältet kommer tas med i styrfilen för insändningen (.changes), se
B<deb-changes>(5).

=back

Observera att prefix på formen B<X>[B<SBC>]B<-> tas bort när fälten kopieras
över till utdatafilerna. Fältet B<XC-Approved-By> kommer tas med som
B<Approved-By> i ”changes”-filen och inte tas med i styrfilerna för binär-
och källkodspaketen.

Tänk på att dess användardefinierade fält använder den globala namnrymden,
vilket en gång i framtiden kan komma att kollidera med officiellt erkända
fält. För att undvika sådana potentiella situationer kan du använda prefixet
B<Private-> för dessa fält, som B<XB-Private-New-Field>.

=head1 EXEMPEL

 # Kommentar
 Source: dpkg
 Section: admin
 Priority: required
 Maintainer: Dpkg Developers <debian-dpkg@lists.debian.org>
 # det här fältet kopieras till binär- och källkodspaketen
 XBS-Upstream-Release-Status: stable
 Homepage: https://wiki.debian.org/Teams/Dpkg
 Vcs-Browser: https://git.dpkg.org/cgit/dpkg/dpkg.git
 Vcs-Git: https://git.dpkg.org/git/dpkg/dpkg.git
 Standards-Version: 3.7.3
 Build-Depends: pkg-config, debhelper (>= 4.1.81),
  libselinux1-dev (>= 1.28-4) [!linux-any]

 Package: dpkg-dev
 Section: utils
 Priority: optional
 Architecture: all
 # det här är ett skräddarsytt fält i binärpaketet
 XB-Mentoring-Contact: Raphael Hertzog <hertzog@debian.org>
 Depends: dpkg (>= 1.14.6), perl5, perl-modules, cpio (>= 2.4.2-2),
  bzip2, lzma, patch (>= 2.2-1), make, binutils, libtimedate-perl
 Recommends: gcc | c-compiler, build-essential
 Suggests: gnupg, debian-keyring
 Conflicts: dpkg-cross (<< 2.0.0), devscripts (<< 2.10.26)
 Replaces: manpages-pl (<= 20051117-1)
 Description: Debian package development tools
  This package provides the development tools (including dpkg-source)
  required to unpack, build and upload Debian source packages.
  .
  Most Debian source packages will require additional tools to build;
  for example, most packages need make and the C compiler gcc.

=head1 SE ÄVEN

L<deb822(5)>, B<deb-control>(5), B<deb-version>(7), B<dpkg-source>(1)


=head1 ÖVERSÄTTNING

Peter Krefting och Daniel Nylander.