diff options
Diffstat (limited to 'man/nl/deb-src-control.pod')
-rw-r--r-- | man/nl/deb-src-control.pod | 490 |
1 files changed, 490 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..e1815fe --- /dev/null +++ b/man/nl/deb-src-control.pod @@ -0,0 +1,490 @@ + + ***************************************************** + * 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) + |