path: root/man/nl/deb-src-control.pod

        *****************************************************
        *           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 NAAM

deb-src-control - Indeling van het hoofdcontrolebestand van
Debian-broncodepakketten

=head1 OVERZICHT

B<debian/control>

=head1 BESCHRIJVING

Elk Debian bronpakket bevat het hoofdcontrolebestand «B<debian/control>» en
de L<deb822(5)>-indeling ervan is een superverzameling van het
B<control>-bestand dat meekomt in binaire Debian-pakketten, zie
B<deb-control>(5).

Dit bestand bevat tenminste twee paragrafen, gescheiden door een
witregel. De eerste paragraaf vermeldt alle informatie over het
broncodepakket in het algemeen, terwijl elke daaropvolgende paragraaf exact
één binair pakket beschrijft. Elke paragraaf bestaat minstens uit één
veld. Een veld begint met een veldnaam, zoals B<Package> of B<Section> (niet
hoofdlettergevoelig), gevolgd door een dubbele punt, het tekstgedeelte van
het veld (hoofdlettergevoelig tenzij anders vermeld) en een
regeleinde. Velden mogen ook uit meerdere regels bestaan, maar iedere
bijkomende regel zonder veldnaam moet minstens met één spatie
beginnen. Gereedschap voegt de inhoud van velden die uit meerdere regels
bestaan, meestal samen tot één regel (behalve in het geval van het veld
B<Description>; zie hierna). Om lege regels toe te voegen in een veld dat
uit meerdere regels bestaat, moet u na de spatie een punt toevoegen. Regels
die met een ‘B<#>’ beginnen worden als commentaar behandeld.

=head1 VELDEN BRONCODEPAKKET

=over 

=item B<Source:> I<broncodepakket-naam> (verplicht)

De waarde van dit veld is de naam van het broncodepakket en moet
overeenkomen met de naam van het broncodepakket in het bestand
debian/changelog. Een pakketnaam mag enkel bestaan uit kleine letters (a-z),
cijfers (0-9), plussen (+) en minnen (-) en punten (.). Pakketnamen moeten
minstens twee tekens lang zijn en moeten met een alfanumeriek teken (a-z0-9)
in kleine letter beginnen.

=item B<Maintainer:> I<volledige-naam-en-e-mail> (aanbevolen)

Moet volgens de indeling «Joe Bloggs E<lt>jbloggs@foo.comE<gt>» opgemaakt
zijn en verwijzen naar de persoon die momenteel het pakket onderhoudt, in
tegenstelling tot de auteur van de software of de originele verpakker ervan.

=item B<Uploaders:> I<volledige-naam-en-e-mailadres>

Somt al de namen en de e-mailadressen op van de personen die het pakket mee
onderhouden volgens dezelfde indeling als van het veld
B<Maintainer>. Meerdere mede-onderhouders moeten onderling door een komma
gescheiden worden.

=item B<Standards-Version:> I<versietekenreeks>

Dit documenteert de meest recente versie van de normen die vastgelegd werden
in de richtlijnen van de distributie en waaraan dit pakket voldoet.

=item B<Description:> I<korte-beschrijving>

=item B<> I<uitgebreide-beschrijving>

De indeling van een pakketbeschrijving bestaat uit een beknopte korte
samenvatting op de eerste regel (na de veldmarkering B<Description>). De
daaropvolgende regels moeten gebruikt worden voor een langere, meer
gedetailleerde beschrijving. Elke regel van de uitgebreide beschrijving moet
voorafgegaan worden door een spatie, en lege regels in de uitgebreide
beschrijving moeten één enkele ‘B<.>’ bevatten die volgt op de eraan
voorafgaande spatie.

=item B<Homepage:> I<URL>

De URL van de homepage van het toeleverend project (upstream).

=item B<Bugs:> I<URL>

De I<URL> van het bugopvolgingssysteem voor dit pakket. De momenteel
gebruikte indeling is I<bts-type>B<://>I<bts-adres>, zoals
B<debbugs://bugs.debian.org>. Meestal is dit veld niet nodig.

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

Dit veld wordt gebruikt om aan te geven of het bestand B<debian/rules>
voorrechten van (fake)root nodig heeft om sommige van zijn targets uit te
voeren, en zo ja wanneer.

=over 

=item B<no>

De binaire targets zullen (fake)root helemaal niet nodig hebben.

=item B<binary-targets>

De binaire targets moeten altijd onder (fake)root uitgevoerd worden. Dit is
de standaardwaarde als dit veld ontbreekt. Als dit veld toegevoegd wordt met
een expliciete B<binary-targets>, terwijl dit strikt genomen niet nodig is,
geeft dit aan dat de noodzaak ervan onderzocht werd.

=item I<impl-trefwoorden>

Dit is een door witruimte gescheiden lijst van trefwoorden die omschrijven
wanneer (fake)root vereist is.

Een trefwoord bestaat uit I<naamruimte>/I<gevallen>. Het onderdeel
I<naamruimte> mag geen "/" en geen witruimte bevatten. Het onderdeel
I<gevallen> mag geen witruimte bevatten. Voorts moeten beide delen volledig
uit afdrukbare ASCII-tekens bestaan.

Elk gereedschap/pakket zal een naamruimte definiëren die vernoemd wordt naar
zichzelf en een aantal gevallen waarin (fake)root vereist is. (Zie
"Implementation provided keywords" in I<rootless-builds.txt>).

Wanneer het veld ingesteld is op een van de I<impl-trefwoorden>, zal het
bouwprogramma een interface ontsluiten die gebruikt wordt om een commando
onder (fake)root uit te voeren. (Zie "Gain Root API" in
I<rootless-builds.txt>.)

=back

=item B<Testsuite:> I<namenlijst>

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

Deze velden worden beschreven in de man-pagina B<dsc>(5), aangezien zij
gegenereerd worden op basis van informatie, afgeleid uit
B<debian/tests/control>, of letterlijk naar het controlebestand van de
broncode gekopieerd worden.

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

De I<URL> van de opslagruimte van het versiecontrolesysteem dat gebruikt
wordt bij het onderhouden van dit pakket. Momenteel worden ondersteund:
B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg> (Mercurial),
B<Mtn> (Monotone) en B<Svn> (Subversion). Meestal verwijst dit veld naar de
laatste versie van het pakket, zoals de hoofdtak (main branch) of de stam
(trunk)

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

De I<URL> van een webinterface om door de opslagruimte van het
versiecontrolesysteem te bladeren.

=item B<Origin:> I<naam>

De naam van de distributie waaruit dit pakket afkomstig is. Meestal is dit
veld niet nodig.

=item B<Section:> I<sectie>

Dit is een veld van algemene aard dat het pakket in een categorie
onderbrengt op basis van de software die het installeert. Enkele
gebruikelijke secties zijn B<utils>, B<net>, B<mail>, B<text>, B<x11>, enz.

=item B<Priority:> I<prioriteit>

Duidt het belang van dit pakket aan in verhouding tot het gehele
systeem. Gebruikelijke prioriteiten zijn B<required>, B<standard>,
B<optional>, B<extra>, enz.

De velden B<Section> en B<Priority> hebben gewoonlijk een welbepaalde set
mogelijke waarden, afhankelijk van de richtlijnen van de distributie.

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

Een lijst van pakketten die geïnstalleerd en geconfigureerd moeten zijn om
het pakket uit de broncode te kunnen bouwen. Aan deze vereisten moet voldaan
zijn bij het bouwen van binaire architectuurafhankelijke of
architectuuronafhankelijke pakketten en broncodepakketten. Een vereiste
vermelden in dit veld heeft niet exact hetzelfde effect als ze zowel in
B<Build-Depends-Arch> als in B<Build-Depends-Indep> vermelden, aangezien ook
voldaan moet zijn aan de vereiste voor het bouwen van het broncodepakket.

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

Hetzelfde als B<Build-Depends>, maar ze zijn enkel nodig bij het bouwen van
de architectuurafhankelijke pakketten. In dit geval worden ook de pakketten
uit B<Build-Depends> geïnstalleerd. Dit veld wordt ondersteund sinds dpkg
1.16.4; om met oudere versies van dpkg pakketten te bouwen moet in plaats
daarvan B<Build-Depends> gebruikt worden.

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

Hetzelfde als B<Build-Depends>, maar ze zijn enkel nodig bij het bouwen van
de architectuuronafhankelijke pakketten. In dit geval worden ook de
pakketten uit B<Build-Depends> geïnstalleerd.

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

Een lijst van pakketten die niet geïnstalleerd mogen zijn bij het bouwen van
het pakket, bijvoorbeeld omdat ze interfereren met het gebruikte
bouwsysteem. Een afhankelijkheidsrelatie opnemen in deze lijst heeft
hetzelfde effect als ze zowel in B<Build-Conflicts-Arch> als in
B<Build-Conflicts-Indep> opnemen, met het bijkomende effect dat ze ook
gebruikt wordt als enkel het broncodepakket gebouwd wordt.

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

Hetzelfde als B<Build-Conflicts>, maar enkel bij het bouwen van de
architectuurafhankelijke pakketten. Dit veld wordt ondersteund sinds dpkg
1.16.4; om met oudere versies van dpkg pakketten te bouwen moet in plaats
daarvan B<Build-Conflicts> gebruikt worden.

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

Hetzelfde als B<Build-Conflicts>, maar enkel bij het bouwen van de
architectuuronafhankelijke pakketten.

=back

De syntaxis van de velden B<Build-Depends>, B<Build-Depends-Arch> en
B<Build-Depends-Indep> is een lijst van groepen van alternatieve
pakketten. Elke groep is een lijst van pakketten die onderling gescheiden
worden door het symbool verticale streep (of “pijp”), ‘B<|>’. De groepen
worden onderling gescheiden door komma's ‘B<,>’ en de lijst kan eindigen met
een afsluitende komma, die bij het genereren van de velden voor
B<deb-control>(5) weggelaten zal worden (sinds dpkg 1.10.14). Een komma moet
geïnterpreteerd worden als een “AND” en een pijp als een “OR”, waarbij
pijpen de sterkste binding hebben. Elke pakketnaam kan facultatief gevolgd
worden door een architectuurkwalificatie, die toegevoegd wordt na een
dubbele punt ‘B<:>’, facultatief gevolgd door de vermelding van een
versienummer tussen ronde haakjes ‘B<(>’ en ‘B<)>’, een
architectuurspecificatie tussen vierkante haakjes ‘B<[>’ en ‘B<]>’ en een
restrictieformule die bestaat uit één of meer lijsten van profielnamen
tussen punthaakjes ‘B<E<lt>>’ en ‘B<E<gt>>’.

De syntaxis van de velden B<Build-Conflicts>, B<Build-Conflicts-Arch> en
B<Build-Conflicts-Indep> is een lijst van pakketnamen die onderling
gescheiden zijn door een komma, waarbij de komma geïnterpreteerd moet worden
als een “AND” en waarbij de lijst kan eindigen met een afsluitende komma,
die bij het genereren van de velden voor B<deb-control>(5) weggelaten zal
worden (sinds dpkg 1.10.14).. Het specificeren van alternatieve pakketten
met behulp van een “pijp” wordt niet ondersteund. Elke pakketnaam kan
facultatief gevolgd worden door de vermelding van een versienummer tussen
ronde haakjes, een architectuurspecificatie tussen vierkante haakjes en een
restrictieformule die bestaat uit één of meer lijsten van profielnamen
tussen punthaakjes.

De naam van een architectuurkwalificatie kan een echte
Debian-architectuurnaam zijn (sinds dpkg 1.16.5), B<any> (sinds dpkg 1.16.2)
of B<native> (since dpkg 1.16.5). Indien ze weggelaten is, is de standaard
voor het veld B<Build-Depends> de architectuur van de huidige computer en
voor het veld B<Build-Conflicts> is dat B<any>. Een echte
Debian-architectuurnaam komt exact overeen met die architectuur voor die
pakketnaam; B<any> komt overeen met om het even welke architectuur voor die
pakketnaam als het pakket gemarkeerd werd als B<Multi-Arch: allowed>;
B<native> komt overeen met de huidige bouwarchitectuur indien het pakket
niet gemarkeerd werd als B<Multi-Arch: foreign>.

Een versienummer kan beginnen met een ‘B<E<gt>E<gt>>’. In dat geval levert
dit met alle latere versies een overeenkomst op. Een versienummer kan al dan
niet ook een Debian-pakketrevisie bevatten (met een koppelteken tussen
versienummer en Debian-pakketrevisie). Toegestane versierelaties zijn
‘B<E<gt>E<gt>>’ voor hoger dan, ‘B<E<lt>E<lt>>’ voor lager dan, ‘B<E<gt>=>’
voor hoger of gelijk aan, ‘B<E<lt>=>’ voor lager of gelijk aan en ‘B<=>’
voor gelijk aan.

Een architectuuraanduiding bestaat uit één of meer architectuurnamen,
onderling gescheiden door witruimte. Een uitroepteken mag elk van de namen
voorafgaan, hetgeen de betekenis heeft van “NOT” (niet).

Een restrictieformule bestaat uit één of meer restrictielijsten, onderling
gescheiden door witruimte. Elke restrictielijst staat tussen punthaakjes. De
items in de restrictielijst zijn bouwprofielnamen, onderling gescheiden door
witruimte, en kunnen voorafgegaan worden door een uitroepteken, hetgeen de
betekenis heeft van “NOT” (niet). Een restrictieformule heeft de
verschijningsvorm van een expressie in disjunctieve normaalvorm.

Merk op dat de vermelding dat pakketten vereist worden die behoren tot de
categorie B<build-essential>, weggelaten kan worden en dat het onmogelijk is
om tegenover dergelijke pakketten een bouwtegenstrijdigheid te
formuleren. Een lijst van deze pakketten is te vinden in het pakket
build-essential.

=head1 VELDEN BINAIR PAKKET

Merk op dat de velden B<Priority>, B<Section> en B<Homepage> ook in een
paragraaf van het binaire pakket kunnen voorkomen ter vervanging van de
globale waarde uit het broncodepakket.

=over 

=item B<Package:> I<naam-binair-pakket> (verplicht)

Dit veld wordt gebruikt om de naam van het binaire pakket te
vermelden. Dezelfde restricties gelden als voor de naam van een
broncodepakket.

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

Dit veld definieert het pakkettype. B<udeb> is voor pakketten waarvan de
omvang aan beperkingen onderworpen is en die door het installatieprogramma
van Debian gebruikt worden. B<deb> is de standaardwaarde, die verondersteld
wordt als het veld ontbreekt. In de toekomst kunnen nog andere types
toegevoegd worden.

=item B<Architecture:> I<arch>|B<all>|B<any> (verplicht)

De architectuur geeft aan op welk type hardware dit pakket werkt. Gebruik de
waarde B<any> voor pakketten die op alle architecturen werken. Voor
pakketten die architectuuronafhankelijk zijn, zoals shell- en Perl-scripts
of documentatie, moet u de waarde B<all> gebruiken. Om pakketten tot een
bepaalde set van architecturen te beperken, moet u de namen van de
architecturen opgeven, onderling gescheiden door een spatie. Het is ook
mogelijk om architectuur-jokers te plaatsen in de lijst (zie
B<dpkg-architecture>(1) voor bijkomende informatie daarover).

=item B<Build-Profiles:> I<restrictie-formule>

Dit veld geeft de condities aan waaronder dit binaire pakket al dan niet te
bouwen is. Om deze conditie uit te drukken wordt voor de restrictieformule
dezelfde syntaxis gebruikt als die van het veld B<Build-Depends>.

Indien de paragraaf over een binair pakket dit veld niet bevat, dan betekent
dit impliciet dat het te bouwen is met alle bouwprofielen (met inbegrip van
helemaal geen).

Met andere woorden, indien aan de paragraaf betreffende een binair pakket
een niet-leeg B<Build-Profiles>-veld toegevoegd is, dan wordt dat binair
pakket gegenereerd indien en enkel indien de conditie die uitgedrukt wordt
door de expressie in conjunctieve normaalvorm als waar geëvalueerd wordt.

=item B<Protected:> B<Byes>|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<lijst-van-markeringen>

=item B<Description:> I<korte-beschrijving> (aanbevolen)

Deze velden worden beschreven in de man-pagina B<deb-control>(5), vermits
zij letterlijk naar het controlebestand van het binaire pakket gekopieerd
worden.

=item B<Depends:> I<pakketlijst>

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

=item B<Recommends:> I<pakketlijst>

=item B<Suggests:> I<pakketlijst>

=item B<Breaks:> I<pakketlijst>

=item B<Enhances:> I<pakketlijst>

=item B<Replaces:> I<pakketlijst>

=item B<Conflicts:> I<pakketlijst>

=item B<Provides:> I<pakketlijst>

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

Deze velden benoemen relaties tussen pakketten. Ze worden besproken in de
man-pagina B<deb-control>(5). Wanneer deze velden in I<debian/control>
voorkomen, kunnen ze ook eindigen met een afsluitende komma (sinds dpkg
1.10.14), kunnen ze architectuurspecificaties bevatten en restrictieformules
bevatten, wat bij het genereren van de velden voor B<deb-control>(5)
allemaal teruggebracht zal worden.

=item B<Subarchitecture:> I<waarde>

=item B<Kernel-Version:> I<waarde>

=item B<Installer-Menu-Item:> I<waarde>

Deze velden worden door het installatieprogramma van Debian in B<udeb>'s
gebruikt en zijn meestal niet nodig. Zie voor meer details over deze velden
/usr/share/doc/debian-installer/devel/modules.txt uit het pakket
B<debian-installer>.

=back

=head1 DOOR DE GEBRUIKER GEDEFINIEERDE VELDEN

Het is toegelaten om aan het bestand control bijkomende door de gebruiker
gedefinieerde velden toe te voegen. De gereedschappen zullen deze velden
negeren. Indien u wilt dat de velden mee gekopieerd worden naar de
uitvoerbestanden, zoals de binaire pakketten, moet u een aangepast
naamgevingsschema hanteren: de velden moeten beginnen met een B<X>, gevolgd
door nul of meer van de tekens B<SBC> en een koppelteken.

=over 

=item B<S>

Het veld zal voorkomen in het control-bestand van het broncodepakket, zie
B<dsc>(5).

=item B<B>

Het veld zal voorkomen in het control-bestand van het binair pakket, zie
B<deb-control>(5).

=item B<C>

Het veld zal voorkomen in het controlebestand (.changes) van de upload, zie
B<deb-changes>(5).

=back

Merk op dat de voorvoegsels B<X>[B<SBC>]B<-> weggelaten worden wanneer de
velden gekopieerd worden naar de uitvoerbestanden. Een veld
B<XC-Approved-By> zal als B<Approved-By> in het changes-bestand vermeld
staan en niet opgenomen zijn in het control-bestand van het binair en het
bronpakket.

Houd er rekening mee dat deze door de gebruiker gedefinieerde velden gebruik
maken van de globale naamruimte, waardoor ze op een gegeven ogenblik in de
toekomst in botsing zouden kunnen komen met officieel erkende velden. Om
deze mogelijke situatie te vermijden kunt u die velden laten voorafgaan door
B<Private->, zoals B<XB-Private-Nieuw-Veld>.

=head1 VOORBEELD

 # Commentaar
 Source: dpkg
 Section: admin
 Priority: required
 Maintainer: Dpkg Developers <debian-dpkg@lists.debian.org>
 # dit veld wordt gekopieerd naar het binaire en het broncodepakket
 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
 # dit is een aangepast veld in het binaire pakket
 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 ZIE OOK

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