~ubuntu-branches/ubuntu/oneiric/dpkg/oneiric

« back to all changes in this revision

Viewing changes to man/de/deb-src-control.5

  • Committer: Steve Langasek
  • Date: 2011-06-15 22:25:32 UTC
  • mfrom: (1.4.19 sid)
  • Revision ID: steve.langasek@linaro.org-20110615222532-r71dhdy4bbkoyl05
Merge 1.16.0.1 from Debian

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Author: Oxan van Leeuwen
 
2
.\" Includes text from the deb-control manual page by Raul Miller
 
3
.\"*******************************************************************
 
4
.\"
 
5
.\" This file was generated with po4a. Translate the source file.
 
6
.\"
 
7
.\"*******************************************************************
 
8
.TH deb\-src\-control 5 2010\-11\-22 Debian\-Projekt Debian
 
9
.SH NAME
 
10
deb\-src\-control \- Dateiformat der Hauptsteuerdatei von Debian\-Quellpaketen
 
11
.
 
12
.SH �BERSICHT
 
13
control
 
14
.
 
15
.SH BESCHREIBUNG
 
16
Jedes Debian\-Quellpaket enh�lt die Hauptsteuerdatei �control�, die
 
17
mindestens zwei Abs�tze enth�lt, die durch eine Leerzeile getrennt
 
18
werden. Der erste Absatz f�hrt alle allgemeinen Informationen �ber das
 
19
Quellpaket auf, w�hrend jeder folgende Absatz genau ein Bin�rpaket
 
20
beschreibt. Jeder Absatz besteht aus mindestens einem Feld. Ein Feld beginnt
 
21
mit einem Feldnamen, wie \fBPackage\fP oder \fBSection\fP (Gro�\-/Kleinschreibung
 
22
egal), gefolgt von einem Doppelpunkt, dem Inhalt des Feldes und einem
 
23
Zeilenumbruch. Mehrzeilige Felder sind auch erlaubt, aber jede erg�nzende
 
24
Zeile ohne Feldnamen sollte mit mindestens einem Leerzeichen beginnen. Der
 
25
Inhalt des mehrzeiligen Feldes wird durch die Werkzeuge im Allgemeinen zu
 
26
einer Zeile zusammengef�hrt (das Feld \fBDescription\fP ist eine Ausnahme,
 
27
siehe unten). Um Leerzeilen in ein mehrzeiliges Feld einzuf�gen, verwenden
 
28
Sie einen Satzpunkt nach dem Leerzeichen. Die Abs�tze werden durch
 
29
Leerzeilen getrennt. Zeilen, die mit \fB�#�\fP beginnen, werden als Kommentare
 
30
betrachtet.
 
31
.
 
32
.SH QUELLPAKET\-FELDER
 
33
.TP 
 
34
\fBSource:\fP <Quellpaket\-Name> (verpflichtend)
 
35
Der Wert dieses Feldes ist der Name des Quellpakets und sollte mit dem Namen
 
36
des Quellpakets in der Datei debian/changelog �bereinstimmen. Ein Paketname
 
37
darf nur aus Kleinbuchstaben (a\-z), Ziffern (0\-9), Plus\- (+) und
 
38
Minuszeichen (\-) und Satzpunkten (.) bestehen. Paketnamen m�ssen mindestens
 
39
zwei Zeichen lang sein und mit einem alphanumerischen Zeichen beginnen.
 
40
 
 
41
.TP 
 
42
\fBMaintainer:\fP <Vollst�ndiger Name E\-Mail> (verpflichtend)
 
43
Sollte in dem Format �Joe Bloggs <jbloggs@foo.com>� sein und
 
44
verweist auf die Person, die derzeit das Paket betreut, im Gegensatz zum
 
45
Autor der Software, die paketiert wurde, oder dem urspr�nglichen Paketierer.
 
46
 
 
47
.TP 
 
48
\fBUploaders:\fP <Vollst�ndiger Name E\-Mail>
 
49
Listet die Namen und E\-Mail\-Adressen der Ko\-Betreuer des Pakets auf, im
 
50
gleichen Format wie das Feld �Maintainer�. Mehrere Ko\-Betreuer sollten durch
 
51
Kommata getrennt werden.
 
52
 
 
53
.TP 
 
54
\fBStandards\-Version:\fP <Versions\-Zeichenkette>
 
55
Dies dokumentiert die neuste Version der Standards (die aus dem
 
56
Debian\-Richtlinienhandbuch und den aus dem Paket \fBdebian\-policy\fP
 
57
referenzierten Texten besteht), an den sich das Paket h�lt.
 
58
 
 
59
.TP 
 
60
\fBDM\-Upload\-Allowed:\fP <yes|no>
 
61
Dieses Feld gibt an, ob das Paket von einem Debian\-Betreuer, der im Feld
 
62
�Maintainer� oder �Uploader� auftaucht, hochgeladen werden kann. Der
 
63
Standardwert ist �no� (nein).
 
64
 
 
65
.TP 
 
66
\fBHomepage:\fP <URL>
 
67
Die URL des Original\- (Upstream\-)Projekts.
 
68
 
 
69
.TP 
 
70
\fBBugs:\fP <URL>
 
71
Die URL der Fehlerdatenbank f�r dieses Paket. Das derzeit verwendete Format
 
72
ist \fB<BTS_Art>://<BTS_Adresse>\fP wie in
 
73
\fBdebbugs://bugs.debian.org\fP. Dieses Feld wird normalerweise nicht ben�tigt.
 
74
 
 
75
.TP 
 
76
\fBVcs\-*:\fP <URL>
 
77
Die URL des Versionskontrollsystem\-Depots, das f�r die Betreuung des Pakets
 
78
verwandt wird. Derzeit werden Arch, Bzr (Bazaar), Cvs, Darcs, Git, Hg
 
79
(Mercurial), Mtn (Monotone) und Svn (Subversion) unterst�tzt. Normalerweise
 
80
zeigt dieses Feld auf die neuste Version des Pakets, wie den Hauptzweig oder
 
81
den Trunk.
 
82
 
 
83
.TP 
 
84
\fBVcs\-Browser:\fP <URL>
 
85
Die URL der Webschnittstelle, um das Versionskontrollsystem\-Depot
 
86
anzuschauen.
 
87
 
 
88
.TP 
 
89
\fBOrigin:\fP <Name>
 
90
Der Name der Distribution, aus der dieses Paket urspr�nglich stammt. Dieses
 
91
Feld wird normalerweise nicht ben�tigt.
 
92
 
 
93
.TP 
 
94
\fBSection:\fP <Bereich>
 
95
Dies ist ein allgemeines Feld, das dem Paket eine Kategorie gibt, basierend
 
96
auf der Software, die es installiert. Einige �bliche Bereiche sind �utils�,
 
97
�net�, �mail�, �text�, �x11� usw.
 
98
 
 
99
.TP 
 
100
\fBPriority:\fP <Priorit�t>
 
101
Setzt die Bedeutung dieses Pakets in Bezug zu dem Gesamtsystem. �bliche
 
102
Priorit�ten sind �required�, �standard�, �optional�, �extra� usw.
 
103
 
 
104
In Debian haben die \fBSection\fP\- und \fBPriority\fP\-Felder einen definierten
 
105
Satz an akzeptierten Werten, basierend auf dem Richtlinien\-Handbuch. Eine
 
106
Liste dieser Werte kann aus der neusten Version des Pakets \fBdebian\-policy\fP
 
107
erhalten werden.
 
108
 
 
109
.TP 
 
110
\fBBuild\-Depends:\fP <Paketliste>
 
111
Eine Liste der Pakete, die installiert und konfiguriert sein m�ssen, um das
 
112
Quellpaket zu bauen.
 
113
 
 
114
.TP 
 
115
\fBBuild\-Depends\-Indep:\fP <Paketliste>
 
116
Identisch zu Build\-Depends, wird aber nur zum Bau der
 
117
architekturunabh�ngigen Pakete ben�tigt. In diesem Fall sind die
 
118
Build\-Depends auch installiert.
 
119
 
 
120
.TP 
 
121
\fBBuild\-Conflicts:\fP <Paketliste>
 
122
Eine Liste von Paketen, die beim Bau des Pakets nicht installiert sein
 
123
sollten, beispielsweise da sie mit dem verwandten Bausystem in Konflikt
 
124
geraten.
 
125
 
 
126
.TP 
 
127
\fBBuild\-Conflicts\-Indep:\fP <Paketliste>
 
128
Identisch zu Build\-Conflicts, wird aber nur zum Bau der
 
129
architekturunabh�ngigen Pakete ben�tigt.
 
130
 
 
131
Die Syntax der Felder \fBBuild\-Depends\fP und \fBBuild\-Depends\-Indep\fP ist eine
 
132
Liste von Gruppen von alternativen Paketen. Jede Gruppe ist eine Liste von
 
133
durch vertikale Striche (oder �Pipe�\-Symbole) �|� getrennte Pakete. Die
 
134
Gruppen werden durch Kommata getrennt. Kommata m�ssen als �UND�, vertikale
 
135
Striche als �ODER� gelesen werden, wobei die vertikalen Striche st�rker
 
136
binden. Jeder Paketname wird optional gefolgt von einer
 
137
Versionsnummer\-Spezifikation in Klammern und einer Architekturspezifikation
 
138
in eckigen Klammern.
 
139
 
 
140
Syntaxtisch werden die Felder \fBBuild\-Conflicts\fP und
 
141
\fBBuild\-Conflicts\-Indep\fP durch eine Komma\-separierte Liste von Paketnamen
 
142
dargestellt, wobei das Komma als �UND� verstanden wird. Die Angabe
 
143
alternativer Pakete mit dem �Pipe�\-Symbol wird nicht unterst�tzt. Jedem
 
144
Paketnamen folgt optional eine Versionnummerangabe in Klammern und eine
 
145
Architekturspezifikation in eckigen Klammern.
 
146
 
 
147
Eine Versionsnummer kann mit �>>� beginnen, in diesem Falle passen
 
148
alle neueren Versionen, und kann die Debian\-Paketrevision (getrennt durch
 
149
einen Bindestrich) enthalten oder auch nicht. Akzeptierte
 
150
Versionsbeziehungen sind �>>� f�r gr��er als, �<<� f�r
 
151
kleiner als, �>=� f�r gr��er als oder identisch zu, �<=� f�r kleiner
 
152
als oder identisch zu und �=� f�r identisch zu.
 
153
 
 
154
Eine Architekturspezifikation besteht aus einer oder mehreren durch
 
155
Leerzeichen getrennten Architekturnamen. Jedem Namen darf ein Ausrufezeichen
 
156
vorangestellt werden, das �NICHT� bedeutet.
 
157
 
 
158
Beachten Sie, dass die Abh�ngigkeiten von Paketen aus der Menge der
 
159
\fBbuild\-essential\fP entfallen kann und die Angabe von Baukonflikten gegen sie
 
160
nicht m�glich ist. Eine Liste dieser Pakete befindet sich im Paket
 
161
build\-essential.
 
162
 
 
163
 
 
164
.SH BIN�RPAKET\-FELDER
 
165
 
 
166
.LP
 
167
Beachten Sie, dass die Felder \fBPriority\fP, \fBSection\fP und \fBHomepage\fP sich
 
168
auch im Bin�rprogrammabsatz befinden k�nnen, um die globalen Werte des
 
169
Quellpakets zu �berschreiben.
 
170
 
 
171
.TP 
 
172
\fBPackage:\fP <Bin�rpaketname> (verpflichtend)
 
173
Dieses Feld wird zur Angabe des Bin�rpaketnamens verwandt. Es gelten die
 
174
gleichen Einschr�nkungen wie beim Quellpaketnamen.
 
175
 
 
176
.TP 
 
177
\fBArchitecture:\fP <arch|allany> (verpflichtend)
 
178
Die Architektur gibt an, auf welcher Art von Hardware dieses Paket
 
179
l�uft. Bei Paketen, die auf allen Architekturen laufen, verwenden Sie den
 
180
Wert \fBany\fP. F�r Pakete, die architekturunabh�ngig sind, wie Shell\- und
 
181
Perl\-Skripte oder Dokumentation, verwenden Sie den Wert \fBall\fP. Um das Paket
 
182
f�r einen bestimmten Satz von Architekturen zu begrenzen, geben Sie die
 
183
durch Leerzeichen getrennten Namen der Architekturen an.
 
184
 
 
185
.TP 
 
186
\fBPackage\-Type:\fP <deb|udeb>
 
187
Dieses Feld definiert die Art des Pakets. �udeb� ist f�r gr��enbegrenzte
 
188
Pakete, wie sie vom Debian\-Installer verwandt werden. �deb� ist der
 
189
Standardwert, er wird angenommen, falls das Feld fehlt. Weitere Typen
 
190
k�nnten in der Zukunft hinzugef�gt werden.
 
191
 
 
192
.TP 
 
193
.PD 0
 
194
\fBSubarchitecture:\fP <Wert>
 
195
.TP 
 
196
.PD 0
 
197
\fBKernel\-Version:\fP <Wert>
 
198
.TP 
 
199
.PD 0
 
200
\fBInstaller\-Menu\-Item:\fP <Wert>
 
201
Diese Felder werden im Debian\-Installer verwandt und werden normalerweise
 
202
nicht ben�tigt. Lesen Sie /usr/share/doc/debian\-installer/devel/modules.txt
 
203
aus dem Paket \fBdebian\-installer\fP f�r weitere Informationen �ber sie.
 
204
 
 
205
.TP 
 
206
.PD 0
 
207
\fBEssential:\fP <yes|no>
 
208
.TP 
 
209
.PD 0
 
210
\fBMulti\-Arch:\fP <same|foreign|allowed> 
 
211
.TP 
 
212
.PD 0
 
213
\fBTag:\fP <Liste von Markierungen>
 
214
.TP 
 
215
.PD 0
 
216
\fBDescription:\fP <Kurzbeschreibung> (verpflichtend)
 
217
Diese Felder sind in der Handbuchseite \fBdeb\-control\fP(5) beschrieben, da sie
 
218
w�rtlich in die Steuerdatei des Bin�rpakets kopiert werden.
 
219
 
 
220
.TP 
 
221
.PD 0
 
222
\fBDepends:\fP <Paketliste>
 
223
.TP 
 
224
.PD 0
 
225
\fBPre\-Depends:\fP <Paketliste>
 
226
.TP 
 
227
.PD 0
 
228
\fBRecommends:\fP <Paketliste>
 
229
.TP 
 
230
.PD 0
 
231
\fBSuggests:\fP <Paketliste>
 
232
.TP 
 
233
.PD 0
 
234
\fBBreaks:\fP <Paketliste>
 
235
.TP 
 
236
.PD 0
 
237
\fBEnhances:\fP <Paketliste>
 
238
.TP 
 
239
.PD 0
 
240
\fBReplaces:\fP <Paketliste>
 
241
.TP 
 
242
.PD 0
 
243
\fBConflicts:\fP <Paketliste>
 
244
.TP 
 
245
.PD 0
 
246
\fBProvides:\fP <Paketliste>
 
247
.TP 
 
248
.PD 0
 
249
\fBBuilt\-Using:\fP <Paketliste>
 
250
.br
 
251
Diese Felder deklarieren die Beziehungen zwischen Paketen. Sie werden in der
 
252
Handbuchseite \fBdeb\-control\fP(5) und im Paket \fBdebian\-policy\fP beschrieben.
 
253
 
 
254
.SH "BENUTZERDEFINIERTE FELDER"
 
255
Es ist erlaubt, zus�tzliche benutzerdefinierte Felder zu der Steuerdatei
 
256
hinzuzuf�gen. Die Werkzeuge werden diese Felder ignorieren. Falls Sie
 
257
m�chten, dass die Felder in die Ausgabedateien, wie z.B. die Bin�rpakete,
 
258
kopiert werden, m�ssen Sie ein angepasstes Namensschema verwenden: Die
 
259
Felder sollten mit einem X, gefolgt von einem oder mehr der Buchstaben BCS
 
260
und einem Gedankenstrich beginnen. Falls der Buchstabe B benutzt wird, wird
 
261
das Feld in der Steuerdatei des Bin�rpakets auftauchen, siehe
 
262
\fBdeb\-control\fP(5), beim Buchstaben S in der Quellpaketsteuerdatei wie sie
 
263
von \fBdpkg\-source\fP(1) erstellt wird und beim Buchstaben C in der
 
264
hochgeladenen Datei control (.changes). Beachten Sie, dass die
 
265
X[BCS]\-Vorsilben beim Kopieren in die Ausgabedateien entfernt werden. Ein
 
266
Feld \fBXC\-Approved\-By\fP wird als \fBApproved\-By\fP in der Datei changes, aber
 
267
nicht in den Steuerdateien des Quell\- und Bin�rpakets auftauchen.
 
268
 
 
269
 
 
270
.SH BEISPIEL
 
271
.\" .RS
 
272
.nf
 
273
# Kommentar
 
274
Source: dpkg
 
275
Section: admin
 
276
Priority: required
 
277
Maintainer: Dpkg Developers <debian\-dpkg@lists.debian.org>
 
278
# dieses Feld wird in das Bin�r\- und Quellpaket kopiert
 
279
XBS\-Upstream\-Release\-Status: stable
 
280
Homepage: http://wiki.debian.org/Teams/Dpkg
 
281
Vcs\-Browser: http://git.debian.org/?p=dpkg/dpkg.git
 
282
Vcs\-Git: git://git.debian.org/git/dpkg/dpkg.git
 
283
Standards\-Version: 3.7.3
 
284
Build\-Depends: pkg\-config, debhelper (>= 4.1.81),
 
285
 libselinux1\-dev (>= 1.28\-4) [!hurd\-i386 !kfreebsd\-i386 !kfreebsd\-amd64]
 
286
 
 
287
Package: dpkg\-dev
 
288
Section: utils
 
289
Priority: optional
 
290
Architecture: all
 
291
# dies ist ein spezielles Feld im Bin�rpaket
 
292
XB\-Mentoring\-Contact: Raphael Hertzog <hertzog@debian.org>
 
293
Depends: dpkg (>= 1.14.6), perl5, perl\-modules, cpio (>= 2.4.2\-2), bzip2, lzma,
 
294
 patch (>= 2.2\-1), make, binutils, libtimedate\-perl
 
295
Recommends: gcc | c\-compiler, build\-essential
 
296
Suggests: gnupg, debian\-keyring
 
297
Conflicts: dpkg\-cross (<< 2.0.0), devscripts (<< 2.10.26)
 
298
Replaces: manpages\-pl (<= 20051117\-1)
 
299
Description: Debian package development tools
 
300
 This package provides the development tools (including dpkg\-source)
 
301
 required to unpack, build and upload Debian source packages.
 
302
 .
 
303
 Most Debian source packages will require additional tools to build;
 
304
 for example, most packages need make and the C compiler gcc.
 
305
.fi
 
306
 
 
307
 
 
308
.\" .RE
 
309
.SH �BERSETZUNG
 
310
Die deutsche �bersetzung wurde 2004, 2006-2011 von Helge Kreutzmann
 
311
<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
 
312
2008 von Sven Joachim <svenjoac@gmx.de>
 
313
angefertigt. Diese �bersetzung ist Freie Dokumentation; lesen Sie die
 
314
GNU General Public License Version 2 oder neuer f�r die Kopierbedingungen.
 
315
Es gibt KEINE HAFTUNG.
 
316
.SH "SIEHE AUCH"
 
317
\fBdeb\-control\fP(5), \fBdeb\-version\fP(5), \fBdpkg\-source\fP(1)