diff options
Diffstat (limited to 'man/nl/deb-src-control.pod')
-rw-r--r-- | man/nl/deb-src-control.pod | 307 |
1 files changed, 307 insertions, 0 deletions
diff --git a/man/nl/deb-src-control.pod b/man/nl/deb-src-control.pod new file mode 100644 index 0000000..cf7fe1e --- /dev/null +++ b/man/nl/deb-src-control.pod @@ -0,0 +1,307 @@ + + ***************************************************** + * 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 onderdelen, gescheiden door een witregel. Het eerste onderdeel vermeldt alle informatie over het broncodepakket in het algemeen, terwijl elk daaropvolgend onderdeel exact één binair pakket beschrijft. Elk onderdeel 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 S< >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 onderdeel over een binair 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> (met inbegrip van de hoekige haakjes). + +Indien een onderdeel 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 jet onderdeel over 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<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<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> + +=item B<Static-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 L<https://salsa.debian.org/installer-team/debian-installer/-/raw/master/doc/devel/modules.txt>. + +=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 + +I<%PKGDOCDIR%/spec/rootless-builds.txt>, L<deb822(5)>, B<deb-control>(5), B<deb-version>(7), B<dpkg-source>(1) + |