blob: 6a954221a8118322981e15c0fa1fdd3f75d001f2 [file] [log] [blame]
.\" Author: Oxan van Leeuwen
.\" Includes text from the deb-control manual page by Raul Miller
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH deb\-src\-control 5 2011\-08\-14 Debian\-Projekt Debian
.SH NAME
deb\-src\-control \- Dateiformat der Hauptsteuerdatei von Debian\-Quellpaketen
.
.SH ÜBERSICHT
control
.
.SH BESCHREIBUNG
Jedes Debian\-Quellpaket enhält die Hauptsteuerdatei »control«, die
mindestens zwei Absätze enthält, die durch eine Leerzeile getrennt
werden. Der erste Absatz führt alle allgemeinen Informationen über das
Quellpaket auf, während jeder folgende Absatz genau ein Binärpaket
beschreibt. Jeder Absatz besteht aus mindestens einem Feld. Ein Feld beginnt
mit einem Feldnamen, wie \fBPackage\fP oder \fBSection\fP (Groß\-/Kleinschreibung
egal), gefolgt von einem Doppelpunkt, dem Inhalt des Feldes und einem
Zeilenumbruch. Mehrzeilige Felder sind auch erlaubt, aber jede ergänzende
Zeile ohne Feldnamen sollte mit mindestens einem Leerzeichen beginnen. Der
Inhalt des mehrzeiligen Feldes wird durch die Werkzeuge im Allgemeinen zu
einer Zeile zusammengeführt (das Feld \fBDescription\fP ist eine Ausnahme,
siehe unten). Um Leerzeilen in ein mehrzeiliges Feld einzufügen, verwenden
Sie einen Satzpunkt nach dem Leerzeichen. Zeilen, die mit \fB»#«\fP beginnen,
werden als Kommentare betrachtet.
.
.SH QUELLPAKET\-FELDER
.TP
\fBSource:\fP \fIQuellpaketname\fP (verpflichtend)
Der Wert dieses Feldes ist der Name des Quellpakets und sollte mit dem Namen
des Quellpakets in der Datei debian/changelog übereinstimmen. Ein Paketname
darf nur aus Kleinbuchstaben (a\-z), Ziffern (0\-9), Plus\- (+) und
Minuszeichen (\-) und Satzpunkten (.) bestehen. Paketnamen müssen mindestens
zwei Zeichen lang sein und mit einem alphanumerischen Zeichen beginnen.
.TP
\fBMaintainer:\fP \fIVollständiger\-Name\-und\-E\-Mail\fP (verpflichtend)
Sollte in dem Format »Joe Bloggs <jbloggs@foo.com sein und
verweist auf die Person, die derzeit das Paket betreut, im Gegensatz zum
Autor der Software, die paketiert wurde, oder dem ursprünglichen Paketierer.
.TP
\fBUploaders:\fP\fI Vollständiger\-Name\-und\-E\-Mail\fP
Listet die Namen und E\-Mail\-Adressen der Ko\-Betreuer des Pakets auf, im
gleichen Format wie das Feld »Maintainer«. Mehrere Ko\-Betreuer sollten durch
Kommata getrennt werden.
.TP
\fBStandards\-Version:\fP \fI Versionszeichenkette\fP
Dies dokumentiert die neuste Version der Standards (die aus dem
Debian\-Richtlinienhandbuch und den aus dem Paket \fBdebian\-policy\fP
referenzierten Texten besteht), an den sich das Paket hält.
.TP
\fBDM\-Upload\-Allowed:\fP \fByes\fP|\fBno\fP
Dieses Feld gibt an, ob das Paket von einem Debian\-Betreuer, der im Feld
»Maintainer« oder »Uploader« auftaucht, hochgeladen werden kann. Der
Standardwert ist »no« (nein).
.TP
\fBHomepage:\fP\fI URL\fP
Die URL des Original\- (Upstream\-)Projekts.
.TP
\fBBugs:\fP\fI URL\fP
Die \fIURL\fP der Fehlerdatenbank für dieses Paket. Das derzeit verwendete
Format ist \fIBTS\-Art\fP\fB://\fP\fIBTS\-Adresse\fP wie in
\fBdebbugs://bugs.debian.org\fP. Dieses Feld wird normalerweise nicht benötigt.
.TP
\fBVcs\-*:\fP \fI URL\fP
Die \fIURL\fP des Versionskontrollsystem\-Depots, das für die Betreuung des
Pakets verwandt wird. Derzeit werden \fBArch\fP, \fBBzr\fP (Bazaar), \fBCvs\fP,
\fBDarcs\fP, \fBGit\fP, \fBHg\fP (Mercurial), \fBMtn\fP (Monotone) und \fBSvn\fP
(Subversion) unterstützt. Normalerweise zeigt dieses Feld auf die neuste
Version des Pakets, wie den Hauptzweig oder den Trunk.
.TP
\fBVcs\-Browser:\fP \fI URL\fP
Die \fIURL\fP der Webschnittstelle, um das Versionskontrollsystem\-Depot
anzuschauen.
.TP
\fBOrigin:\fP\fI Name\fP
Der Name der Distribution, aus der dieses Paket ursprünglich stammt. Dieses
Feld wird normalerweise nicht benötigt.
.TP
\fBSection:\fP\fI Bereich\fP
Dies ist ein allgemeines Feld, das dem Paket eine Kategorie gibt, basierend
auf der Software, die es installiert. Einige übliche Bereiche sind »utils«,
»net«, »mail«, »text«, »x11« usw.
.TP
\fBPriority:\fP\fI Priorität\fP
Setzt die Bedeutung dieses Pakets in Bezug zu dem Gesamtsystem. Übliche
Prioritäten sind »required«, »standard«, »optional«, »extra« usw.
In Debian haben die \fBSection\fP\- und \fBPriority\fP\-Felder einen definierten
Satz an akzeptierten Werten, basierend auf dem Richtlinien\-Handbuch. Eine
Liste dieser Werte kann aus der neusten Version des Pakets \fBdebian\-policy\fP
erhalten werden.
.TP
\fBBuild\-Depends:\fP \fI Paketliste\fP
Eine Liste der Pakete, die installiert und konfiguriert sein müssen, um das
Quellpaket zu bauen.
.TP
\fBBuild\-Depends\-Indep:\fP \fI Paketliste\fP
Identisch zu \fBBuild\-Depends\fP, wird aber nur zum Bau der
architekturunabhängigen Pakete benötigt. In diesem Fall sind die
\fBBuild\-Depends\fP auch installiert.
.TP
\fBBuild\-Conflicts:\fP \fI Paketliste\fP
Eine Liste von Paketen, die beim Bau des Pakets nicht installiert sein
sollten, beispielsweise da sie mit dem verwandten Bausystem in Konflikt
geraten.
.TP
\fBBuild\-Conflicts\-Indep:\fP \fI Paketliste\fP
Identisch zu \fBBuild\-Conflicts\fP, wird aber nur zum Bau der
architekturunabhängigen Pakete benötigt.
Die Syntax der Felder \fBBuild\-Depends\fP und \fBBuild\-Depends\-Indep\fP ist eine
Liste von Gruppen von alternativen Paketen. Jede Gruppe ist eine Liste von
durch vertikale Striche (oder »Pipe«\-Symbole) »|« getrennte Pakete. Die
Gruppen werden durch Kommata getrennt. Kommata müssen als »UND«, vertikale
Striche als »ODER« gelesen werden, wobei die vertikalen Striche stärker
binden. Jeder Paketname wird optional gefolgt von einer
Versionsnummer\-Spezifikation in Klammern und einer Architekturspezifikation
in eckigen Klammern.
Syntaxtisch werden die Felder \fBBuild\-Conflicts\fP und
\fBBuild\-Conflicts\-Indep\fP durch eine Komma\-separierte Liste von Paketnamen
dargestellt, wobei das Komma als »UND« verstanden wird. Die Angabe
alternativer Pakete mit dem »Pipe«\-Symbol wird nicht unterstützt. Jedem
Paketnamen folgt optional eine Versionnummerangabe in Klammern und eine
Architekturspezifikation in eckigen Klammern.
Eine Versionsnummer kann mit »>>« beginnen, in diesem Falle passen
alle neueren Versionen, und kann die Debian\-Paketrevision (getrennt durch
einen Bindestrich) enthalten oder auch nicht. Akzeptierte
Versionsbeziehungen sind »>>« für größer als, »<<« für
kleiner als, »>=« für größer als oder identisch zu, »<=« für kleiner
als oder identisch zu und »=« für identisch zu.
Eine Architekturspezifikation besteht aus einer oder mehreren durch
Leerzeichen getrennten Architekturnamen. Jedem Namen darf ein Ausrufezeichen
vorangestellt werden, das »NICHT« bedeutet.
Beachten Sie, dass die Abhängigkeiten von Paketen aus der Menge der
\fBbuild\-essential\fP entfallen kann und die Angabe von Baukonflikten gegen sie
nicht möglich ist. Eine Liste dieser Pakete befindet sich im Paket
build\-essential.
.SH BINÄRPAKET\-FELDER
.LP
Beachten Sie, dass die Felder \fBPriority\fP, \fBSection\fP und \fBHomepage\fP sich
auch im Binärprogrammabsatz befinden können, um die globalen Werte des
Quellpakets zu überschreiben.
.TP
\fBPackage:\fP \fIBinärpaketname\fP (verpflichtend)
Dieses Feld wird zur Angabe des Binärpaketnamens verwandt. Es gelten die
gleichen Einschränkungen wie beim Quellpaketnamen.
.TP
\fBArchitecture:\fP \fIarch\fP|\fBall\fP|\fBany\fP (verpflichtend)
Die Architektur gibt an, auf welcher Art von Hardware dieses Paket
läuft. Bei Paketen, die auf allen Architekturen laufen, verwenden Sie den
Wert \fBany\fP. Für Pakete, die architekturunabhängig sind, wie Shell\- und
Perl\-Skripte oder Dokumentation, verwenden Sie den Wert \fBall\fP. Um das Paket
für einen bestimmten Satz von Architekturen zu begrenzen, geben Sie die
durch Leerzeichen getrennten Namen der Architekturen an. Es ist auch
möglich, Platzhalter für Architekturen in dieser Liste anzugeben (lesen Sie
\fBdpkg\-architecture\fP(1) für weitere Informationen dazu).
.TP
\fBPackage\-Type:\fP \fBdeb\fP|\fBudeb\fP
Dieses Feld definiert die Art des Pakets. »udeb« ist für größenbegrenzte
Pakete, wie sie vom Debian\-Installer verwandt werden. »deb« ist der
Standardwert, er wird angenommen, falls das Feld fehlt. Weitere Typen
könnten in der Zukunft hinzugefügt werden.
.TP
.PD 0
\fBSubarchitecture:\fP \fI Wert\fP
.TP
.PD 0
\fBKernel\-Version:\fP \fI Wert\fP
.TP
.PD 0
\fBInstaller\-Menu\-Item:\fP \fI Wert\fP
Diese Felder werden im Debian\-Installer verwandt und werden normalerweise
nicht benötigt. Lesen Sie /usr/share/doc/debian\-installer/devel/modules.txt
aus dem Paket \fBdebian\-installer\fP für weitere Informationen über sie.
.TP
.PD 0
\fBEssential:\fP \fByes\fP|\fBno\fP
.TP
.PD 0
\fBMulti\-Arch:\fP \fBsame\fP|\fBforeign\fP|\fBallowed\fP
.TP
.PD 0
\fBTag:\fP \fI Liste\-von\-Markierungen\fP
.TP
.PD 0
\fBDescription:\fP \fIKurzbeschreibung\fP (verpflichtend)
Diese Felder sind in der Handbuchseite \fBdeb\-control\fP(5) beschrieben, da sie
wörtlich in die Steuerdatei des Binärpakets kopiert werden.
.TP
.PD 0
\fBDepends:\fP \fI Paketliste\fP
.TP
.PD 0
\fBPre\-Depends:\fP \fI Paketliste\fP
.TP
.PD 0
\fBRecommends:\fP \fI Paketliste\fP
.TP
.PD 0
\fBSuggests:\fP \fI Paketliste\fP
.TP
.PD 0
\fBBreaks:\fP \fI Paketliste\fP
.TP
.PD 0
\fBEnhances:\fP \fI Paketliste\fP
.TP
.PD 0
\fBReplaces:\fP \fIPaketliste\fP
.TP
.PD 0
\fBConflicts:\fP \fI Paketliste\fP
.TP
.PD 0
\fBProvides:\fP \fI Paketliste\fP
.TP
.PD 0
\fBBuilt\-Using:\fP \fI Paketliste\fP
.br
Diese Felder deklarieren die Beziehungen zwischen Paketen. Sie werden in der
Handbuchseite \fBdeb\-control\fP(5) und im Paket \fBdebian\-policy\fP beschrieben.
.SH "BENUTZERDEFINIERTE FELDER"
Es ist erlaubt, zusätzliche benutzerdefinierte Felder zu der Steuerdatei
hinzuzufügen. Die Werkzeuge werden diese Felder ignorieren. Falls Sie
möchten, dass die Felder in die Ausgabedateien, wie z.B. die Binärpakete,
kopiert werden, müssen Sie ein angepasstes Namensschema verwenden: Die
Felder sollten mit einem X, gefolgt von einem oder mehr der Buchstaben BCS
und einem Gedankenstrich beginnen. Falls der Buchstabe B benutzt wird, wird
das Feld in der Steuerdatei des Binärpakets auftauchen, siehe
\fBdeb\-control\fP(5), beim Buchstaben S in der Quellpaketsteuerdatei wie sie
von \fBdpkg\-source\fP(1) erstellt wird und beim Buchstaben C in der
hochgeladenen Datei control (.changes). Beachten Sie, dass die
X[BCS]\-Vorsilben beim Kopieren in die Ausgabedateien entfernt werden. Ein
Feld \fBXC\-Approved\-By\fP wird als \fBApproved\-By\fP in der Datei changes, aber
nicht in den Steuerdateien des Quell\- und Binärpakets auftauchen.
.SH BEISPIEL
.\" .RS
.nf
# Kommentar
Source: dpkg
Section: admin
Priority: required
Maintainer: Dpkg Developers <debian\-dpkg@lists.debian.org>
# dieses Feld wird in das Binär\- und Quellpaket kopiert
XBS\-Upstream\-Release\-Status: stable
Homepage: http://wiki.debian.org/Teams/Dpkg
Vcs\-Browser: http://git.debian.org/?p=dpkg/dpkg.git
Vcs\-Git: git://git.debian.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
# dies ist ein spezielles Feld im Binärpaket
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.
.fi
.\" .RE
.SH ÜBERSETZUNG
Die deutsche Übersetzung wurde 2004, 2006-2011 von Helge Kreutzmann
<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
2008 von Sven Joachim <svenjoac@gmx.de>
angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
Es gibt KEINE HAFTUNG.
.SH "SIEHE AUCH"
\fBdeb\-control\fP(5), \fBdeb\-version\fP(5), \fBdpkg\-source\fP(1)