Provided by: dpkg-dev_1.18.4ubuntu1.7_all 
NAMN
deb-src-control - Debians filformat för källkodspakets huvudstyrfil
SYNOPS
control
BESKRIVNING
Each Debian source package contains the master «control» file, which contains at least 2
paragraphs, separated by a blank line. The first paragraph lists all information about the
source package in general, while each following paragraph describes exactly one binary
package. Each paragraph consists of at least one field. A field starts with a fieldname,
such as Package or Section (case insensitive), followed by a colon, the body of the field
and a newline. Multi-line fields are also allowed, but each supplementary line, without a
fieldname, should start with at least one space. The content of the multi-line fields is
generally joined to a single line by the tools (except in the case of the Description
field, see below). To insert empty lines into a multi-line field, insert a dot after the
space. Lines starting with a ‘#’ are treated as comments.
KÄLLKODSFÄLT
Source: 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 alfanumeriskt
tecken.
Maintainer: fullt-namn-epost (krävs)
Should be in the format «Joe Bloggs <jbloggs@foo.com>», and references the person
who currently maintains the package, as opposed to the author of the software or
the original packager.
Uploaders: fullt-namn-epost
Räknar upp namn och e-postadresser till med-underhållare av paketet, i samma format
som fältet Maintainers. Flera med-underhållare bör avdelas med kommatecken.
Standards-Version: versionssträng
Dokumenterar den senaste versionen av standarddokumenten (vilka består av Debians
policyhandbok och refererade texter i paketet debian-policy) som paketet uppfyller.
Homepage: url
URL till uppströmsprojektets hemsida.
Bugs: url
The url of the bug tracking system for this package. The current used format is
bts-type://bts-address, like debbugs://bugs.debian.org. This field is usually not
needed.
Vcs-Arch: url
Vcs-Bzr: url
Vcs-Cvs: url
Vcs-Darcs: url
Vcs-Git: url
Vcs-Hg: url
Vcs-Mtn: url
Vcs-Svn: url
Url:en till versionshanteringsarkivet som används för att underhålla det här
paketet. För närvarande stöds Arch, Bzr (Bazaar), Cvs, Darcs, Git, Hg (Mercurial),
Mtn (Monotone) och Svn (Subversion). Fältet pekar normalt till den senaste
versionen av paketet, såsom huvudgrenen (main eller trunk).
Vcs-Browser: url
Url:en till ett webbgränssnitt för att bläddra i versionshanteringsarkivet.
Origin: namn
Namnet på den distribution paketet härstammar från. Det här fältet är normalt sett
inte nödvändigt.
Section: sektion
This is a general field that gives the package a category based on the software
that it installs. Some common sections are utils, net, mail, text, x11, etc.
Priority: prioritet
Sets the importance of this package in relation to the system as a whole. Common
priorities are required, standard, optional, extra, etc.
I Debian har fälten Section och Priority en definierad uppsättning accepterade
värden baserade på policymanualen. En förteckning över dessa värden finns i den
senaste versionen av paketet debian-policy.
Build-Depends: paketlista
A list of packages that need to be installed and configured to be able to build
from source package. These dependencies need to be satisfied when building binary
architecture dependent or independent packages and source packages. Including a
dependency in this field does not have the exact same effect as including it in
both Build-Depends-Arch and Build-Depends-Indep, because the dependency also needs
to be satisfied when building the source package.
Build-Depends-Arch: package-list
Motsvarar Build-Depends, men de behövs endast för att bygga de arkitekturoberoende
paketen. 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 Build-Depends användas
istället.
Build-Depends-Indep: paketlista
Motsvarar Build-Depends, men de behövs endast för att bygga de arkitekturoberoende
paketen. Build-Depends installeras också i detta fall.
Build-Conflicts: package-list
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 Build-Conflicts-Arch och
Build-Conflicts-Indep, med den ytterligare effekten att den används för byggen av
endast källkod.
Build-Conflicts-Arch: package-list
Motsvarar 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
Build-Conflicts användas istället.
Build-Conflicts-Indep: paketlista
Motsvarar Build-Conflicts, men endast när de arkitekturoberoende paketen byggs.
The syntax of the Build-Depends, Build-Depends-Arch and Build-Depends-Indep fields is a
list of groups of alternative packages. Each group is a list of packages separated by
vertical bar (or “pipe”) symbols, ‘|’. The groups are separated by commas. Commas are to
be read as “AND”, and pipes as “OR”, with pipes binding more tightly. Each package name is
optionally followed by an architecture qualifier appended after a colon ‘:’, optionally
followed by a version number specification in parentheses, an architecture specification
in square brackets, and a restriction formula consisting of one or more lists of profile
names in angle brackets.
The syntax of the Build-Conflicts, Build-Conflicts-Arch and Build-Conflicts-Indep fields
is a list of comma-separated package names, where the comma is read as an “AND”.
Specifying alternative packages using a “pipe” is not supported. Each package name is
optionally followed by a version number specification in parentheses, an architecture
specification in square brackets, and a restriction formula consisting of one or more
lists of profile names in angle brackets.
An architecture qualifier name can be a real Debian architecture name (since dpkg 1.16.5),
any (since dpkg 1.16.2) or native (since dpkg 1.16.5). If omitted, the default for
Build-Depends fields is the current host architecture, the default for Build-Conflicts
fields is any. A real Debian architecture name will match exactly that architecture for
that package name, any will match any architecture for that package name if the package is
marked with Multi-Arch: allowed, and native will match the current build architecture if
the package is not marked with Multi-Arch: foreign.
A version number may start with a ‘>>’, in which case any later version will match, and
may specify or omit the Debian packaging revision (separated by a hyphen). Accepted
version relationships are ‘>>’ for greater than, ‘<<’ for less than, ‘>=’ for greater than
or equal to, ‘<=’ for less than or equal to, and ‘=’ for equal to.
An architecture specification consists of one or more architecture names, separated by
whitespace. Exclamation marks may be prepended to each of the names, meaning “NOT”.
A restriction formula consists of one or more restriction lists, separated by whitespace.
Each restriction list is enclosed in angle brackets. Items in the restriction list are
build profile names, separated by whitespace and can be prefixed with an exclamation mark,
meaning “NOT”. A restriction formula represents a disjunctive normal form expression.
Observera att beroenden på paket i 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.
BINÄRFÄLT
Observera att fälten Priority, Section och Homepage även kan användas i de stycken som
beskriver binärpaket för att överstyra de globala värdena för källkodspaketet.
Package: 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.
Architecture: arch|all|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 any (någon). För paket som är arkitekturoberoende,
som skal- och Perlskript eller dokumentation, används värdet 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 dpkg-architecture(1) för mer information om dessa).
Package-Type: deb|udeb
This field defines the type of the package. udeb is for size-constrained packages
used by the debian installer. deb is the default value, it is assumed if the field
is absent. More types might be added in the future.
Subarchitecture: värde
Kernel-Version: värde
Installer-Menu-Item: värde
Dessa fält används av debian-installer och behövs normalt inte. Se
/usr/share/doc/debian-installer/devel/modules.txt från paketet debian-installer för
mer information om dem.
Essential: yes|no
Build-Essential: yes|no
Multi-Arch: same|foreign|allowed|no
Tag: lista-med-märken
Description: kort-beskrivning (krävs)
Dessa fält beskrivs i manualsidan deb-control(5), eftersom de kopieras ordagrant
till binärpaketets styrfil.
Depends: paketlista
Pre-Depends: paketlista
Recommends: paketlista
Suggests: paketlista
Breaks: paketlista
Enhances: paketlista
Replaces: paketlista
Conflicts: v
Provides: paketlista
Built-Using: paketlista
Dessa fält anger relationer mellan paket. De diskuteras i manualsidan
deb-control(5) och i paketet debian-policy.
ANVÄNDARDEFINIERADE FÄLT
Det är möjligt att lägga till ytterligare användardefinierade fält i styrfilen. Verktygen
ignorerar dessa fält. Om du vill att fälten skall kopieras över till utdatafilerna, som
till exempel i binärpaketen, måste du använda en skräddarsydd namngivning: fälten måste
starta med X, följt av ett eller flera av bokstäverna BCS och ett bindestreck. Om
bokstaven B används kommer fältet att dyka upp i styrfilen i binärpaketet, se
deb-control(5), för bokstaven S i källkodspaketets styrfil som konstrueras av
dpkg-source(1) och för bokstaven C i styrfilen för insändning (.changes). Observera att
X[BCS]-prefixen tas bort när fälten kopieras över till utdatafilerna. Fältet
XC-Approved-By visas som Approved-By i changes-filen och visas inte 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 Private- för dessa fält, som
XB-Private-New-Field.
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://anonscm.debian.org/cgit/dpkg/dpkg.git
Vcs-Git: git://anonscm.debian.org/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.
SE ÄVEN
deb-control(5), deb-version(5), dpkg-source(1)
ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.