diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 09:40:31 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 09:40:31 +0000 |
commit | b86570f63e533abcbcb97c2572e0e5732a96307b (patch) | |
tree | cabc83be691530ae685c45a8bc7620ccc0e1ebdf /man/nl/dsc.pod | |
parent | Initial commit. (diff) | |
download | dpkg-b86570f63e533abcbcb97c2572e0e5732a96307b.tar.xz dpkg-b86570f63e533abcbcb97c2572e0e5732a96307b.zip |
Adding upstream version 1.20.13.upstream/1.20.13upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/nl/dsc.pod')
-rw-r--r-- | man/nl/dsc.pod | 283 |
1 files changed, 283 insertions, 0 deletions
diff --git a/man/nl/dsc.pod b/man/nl/dsc.pod new file mode 100644 index 0000000..72a1ad2 --- /dev/null +++ b/man/nl/dsc.pod @@ -0,0 +1,283 @@ + + ***************************************************** + * 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 + +dsc - Indeling van het controlebestand van Debian-broncodepakketten + +=head1 OVERZICHT + +I<bestandsnaam>B<.dsc> + +=head1 BESCHRIJVING + +Elk Debian-broncodepakket bestaat uit een .dsc-controlebestand, dat een +aantal velden bevat volgens de indeling L<deb822(5)>. + +Ieder veld begint met een markering, zoals B<Source> of B<Binary> (niet +hoofdlettergevoelig), gevolgd door een dubbele punt en de tekstinhoud van +het veld (hoofdlettergevoelig tenzij anders vermeld). Velden worden enkel +door veldmarkeringen begrensd. De tekstinhoud van het veld kan met andere +woorden verschillende regels lang zijn, maar de installatiegereedschappen +zullen bij het verwerken van de tekstinhoud de regels gewoonlijk samenvoegen +(behalve in het geval van de multiregel-velden B<Package-List>, B<Files>, +B<Checksums-Sha1> en B<Checksums-Sha256>; zie hierna) + +De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met +ASCII-harnas volgens de specificatie RFC4880. + +=head1 VELDEN + +=over + +=item B<Format:> I<indelingsversie> (verplicht) + +De waarde van dit veld declareert de indelingsversie van het +broncodepakket. De veldwaarde wordt door programma's die met een +broncodepakket werken, gebruikt om de bestandenlijst in het broncodepakket +te interpreteren en te bepalen hoe het uitgepakt moet worden. De syntaxis +van de veldwaarde is: een numerieke hoofdversie (“0-9”), een punt (“.”), een +numerieke onderversie (“0-9”), en dan eventueel na witruimte (“ \t”) een +subtype dat, als het opgegeven wordt, bestaat uit een alfanumeriek +(“a-z0-9”) woord tussen haakjes (“()”). Vanuit het oogpunt van syntaxis is +het subtype optioneel, maar voor specifieke revisies van de indeling van +broncodepakketten kan het een verplicht onderdeel zijn. + +De indelingen van de broncode die momenteel ondersteund worden door B<dpkg> +zijn B<1.0>, B<2.0>, B<3.0 (native)>, B<3.0 (quilt)>, B<3.0 (git)>, B<3.0 +(bzr)> en B<3.0 (custom)>. Raadpleeg B<dpkg-source>(1) voor de beschrijving +ervan. + +=item B<Source:> I<broncode-naam> (verplicht) + +De waarde van dit veld bepaalt de pakketnaam en wordt door de meeste +installatiegereedschappen gebruikt om bestandsnamen te genereren. + +=item B<Binary:> I<lijst-van-binaire-pakketten> + +Dit gevouwen veld somt, door komma's van elkaar gescheiden, de binaire +pakketten op die door dit broncodepakket gebouwd kunnen worden. + +Dit veld is nu vervangen door het veld B<Package-List> dat voldoende +informatie geeft over welke binaire pakketten op welke architecturen +geproduceerd worden, over bouwprofielen en over andere restricties die van +belang zijn. + +=item B<Architecture:> I<arch-lijst> (aanbevolen) + +Een lijst van door spaties van elkaar gescheiden architecturen en +architectuurjokertekens die aangeven voor welk type hardware dit pakket +gecompileerd kan worden. Gebruikelijke architectuurnamen en +architectuurjokertekens zijn B<amd64>, B<armel>, B<i386>, B<linux-any>, +B<any-amd64>, enz. + +Merk op dat de waarde B<all> bedoeld is voor pakketten die +architectuuronafhankelijk zijn en B<any> voor pakketten die +architectuurafhankelijk zijn. De lijst mag de speciale waarde B<all> +bevatten (of er uitsluitend uit bestaan). Wanneer de lijst het +architectuurjokerteken B<any> bevat, is B<all> de enige andere toegelaten +waarde in de lijst. + +De waarde van dit veld wordt gewoonlijk gegenereerd op basis van de +B<Architecture>-velden in het bestand I<debian/control> van het +broncodepakket. + +=item B<Version:> I<versie-tekenreeks> (verplicht) + +Gewoonlijk is dit het originele versienummer van het pakket, welke vorm de +auteur van het programma er ook voor gebruikt. Het kan ook een +Debian-revisienummer bevatten (voor niet uit Debian stammende pakketten). De +exacte indeling en het sorteringsalgoritme worden beschreven in +B<deb-version>(7). + +=item B<Origin:> I<naam> + +De naam van de distributie waaruit dit pakket afkomstig is. + +=item B<Maintainer:> I<volledige-naam-en-e-mail> (aanbevolen) + +Moet opgemaakt worden volgens de indeling “Joe Bloggs +E<lt>jbloggs@foo.comE<gt>”, en is gewoonlijk de persoon die het pakket +maakte, in tegenstelling tot de auteur van de verpakte software. + +=item B<Uploaders:> I<lijst van volledige-namen-en-e-mailadressen> + +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<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 I<URL> van de homepage van het toeleverend project (upstream). + +=item B<Standards-Version:> I<versietekenreeks> (aanbevolen) + +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<Vcs-Browser:> I<URL> + +De I<url> van een webinterface waarmee door de opslagruimte van het +versiecontrolesysteem kan gebladerd 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> + +Deze velden declareren de I<url> van de opslagruimte van het +versiecontrolesysteem dat gebruikt wordt om dit pakket te onderhouden. Zie +B<deb-src-control>(5) voor verdere informatie. + +=item B<Testsuite:> I<namenlijst> + +Dit veld declareert dat het broncodepakket de opgegeven testsuites bevat. De +waarde is een lijst van onderling door komma's gescheiden testsuites. Indien +de waarde B<autopkgtest> bestaat, wordt verondersteld dat het bestand +I<debian/tests/control> bestaat. Indien het bestand bestaat, maar de waarde +niet, dan zal B<dpkg-source> die automatisch toevoegen met behoud van de +vroegere waarden. + +=item B<Testsuite-Triggers:> I<pakketlijst> + +Dit veld declareert de door komma's gescheiden unie van alle testvereisten +(de velden B<Depends> uit het bestand I<debian/tests/control>), waaruit alle +restricties verwijderd en alle OR-vereisten uitgevlakt werden (dit betekent +omgezet naar aparte AND-relaties), uitgezonderd voor de binaire pakketten, +gegenereerd door dit broncodepakket en het equivalent van zijn meta-vereiste +B<@>. + +Motivering: dit veld is noodzakelijk omdat anders elk broncodepakket +uitgepakt zou moeten worden om de testvereisten te kunnen achterhalen. + +=item B<Build-Depends:> I<pakketlijst> + +=item B<Build-Depends-Arch:> I<pakketlijst> + +=item B<Build-Depends-Indep:> I<pakketlijst> + +=item B<Build-Conflicts:> I<pakketlijst> + +=item B<Build-Conflicts-Arch:> I<pakketlijst> + +=item B<Build-Conflicts-Indep:> I<pakketlijst> + +Deze velden declareren de relaties tussen het broncodepakket en de pakketten +die gebruikt worden om het te bouwen. Zij worden besproken in de man-pagina +B<deb-src-control>(5). + +=item B<Package-List:> + +=item S< >I<pakket> I<pakkettype> I<sectie> I<prioriteit> +I<trefwoord-waarde-lijst> + +Dit multiregel-veld bevat een lijst van binaire pakketten die door dit +broncodepakket gegenereerd worden. + +Het element I<pakket> is de naam van het binaire pakket. + +Het element I<pakket-type> is het type van het binaire pakket, meestal +B<deb>; een andere gebruikelijke waarde is B<udeb>. + +De elementen I<sectie> (section) en I<prioriteit> (priority) komen overeen +met de velden met dezelfde naam van het binaire pakket. + +Het element I<trefwoord-waarde-lijst> is een lijst van door spaties +gescheiden I<trefwoord>B<=>I<waarde> en de momenteel herkende optionele +trefwoorden zijn: + +=over + +=item B<arch> + +De architectuurrestrictie uit het veld B<Architecture> van het binaire +pakket, waarbij spaties naar ‘,’ geconverteerd worden. + +=item B<profile> + +De genormaliseerde bouwprofiel-restrictieformule uit het veld +B<Build-Profile> van het binaire pakket, waarbij OR's omgezet worden naar +‘+’ en AND's naar ‘,’. + +=item B<protected> + +Indien het binaire pakket beschermd (protected) is, zal dit trefwoord de +waarde hebben van het veld B<Protected>, wat een waarde B<yes> is. + +=item B<essential> + +Indien het binaire pakket essentieel (essential) is, zal dit trefwoord de +waarde hebben van het veld B<Essential> en dat is de waarde B<yes>. + +=back + +=item B<Files:> (verplicht) + +=item B<Checksums-Sha1:> (verplicht) + +=item B<Checksums-Sha256:> (verplicht) + +=item S< >I<controlesom> I<grootte> I<bestandsnaam> + +Deze multiregel-velden bevatten een lijst van bestanden met voor elk van hen +een controlesom en een grootte. Deze velden hebben een identieke syntaxis en +verschillen onderling enkel inzake het gebruikte algoritme voor de +controlesom: MD5 voor B<Files>, SHA-1 voor B<Checksums-Sha1> en SHA-256 voor +B<Checksums-Sha256>. + +De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als +de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van +het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke +regel bestaat uit de controlesom, een spatie, de bestandsgrootte, een spatie +en de bestandsnaam. + +Deze velden sommen alle bestanden op die deel uitmaken van het +broncodepakket. De lijst bestanden in deze velden moet overeenkomen met de +lijst bestanden in de andere verwante velden. + +=back + +=head1 BUGS + +Het veld B<Format> combineert de indeling van het B<.dsc>-bestand zelf en de +indeling van het uitgepakte broncodepakket. + +=head1 ZIE OOK + +L<deb822(5)>, B<deb-src-control>(5), B<deb-version>(7), B<dpkg-source>(1). + |