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/deb822.pod | |
parent | Initial commit. (diff) | |
download | dpkg-upstream.tar.xz dpkg-upstream.zip |
Adding upstream version 1.20.13.upstream/1.20.13upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r-- | man/nl/deb822.pod | 138 |
1 files changed, 138 insertions, 0 deletions
diff --git a/man/nl/deb822.pod b/man/nl/deb822.pod new file mode 100644 index 0000000..b691f6c --- /dev/null +++ b/man/nl/deb822.pod @@ -0,0 +1,138 @@ + + ***************************************************** + * 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 + +deb822 - Debian RFC822-indeling voor controledata + +=head1 BESCHRIJVING + +Het pakketbeheersysteem gebruikt gegevens die volgens een gangbare indeling +weergegeven worden, die I<controledata> (control-data) genoemd worden en die +opgeslagen worden in I<controlebestanden> +(control-bestanden). Controlebestanden worden gebruikt voor +broncodepakketten, voor binaire pakketten en voor de B<.changes>-bestanden +die de installatie van geüploade bestanden sturen (de interne databases van +B<dpkg> hebben een soortgelijke indeling). + +=head1 SYNTAXIS + +Een controlebestand bestaat uit één of meer paragrafen die velden bevatten +(de paragrafen worden soms ook met de term stanzas aangeduid). De paragrafen +worden onderling gescheiden door een lege regel. Bij ontleders (parsers) +kunnen regels die enkel bestaan uit U+0020 B<SPATIE> en U+0009 B<TAB>, +gebruikt worden als scheidingsteken tussen paragrafen, maar in +controlebestanden moeten lege regels gebruikt worden. In sommige +controlebestanden is enkel één paragraaf toegestaan, in andere meerdere. In +dat geval heeft elke paragraaf meestal betrekking op een ander pakket. (In +broncodepakketten bijvoorbeeld, heeft de eerste paragraaf betrekking op het +broncodepakket en de volgende op de binaire pakketten die uit de broncode +gegenereerd worden.) De volgorde van de paragrafen in controlebestanden is +betekenisvol. + +Elke paragraaf bestaat uit een reeks gegevensvelden. Elk veld bestaat uit de +veldnaam, gevolgd door een dubbelepunt (U+003A ‘B<:>’) en nadien de +data/waarde die bij dat veld hoort. De veldnaam wordt gevormd uit +US-ASCII-tekens met uitsluiting van controle-tekens, spatie en dubbelepunt +(d.w.z. tekens uit het bereik U+0021 ‘B<!>’ tot en met U+0039 ‘B<9>’ en uit +het bereik U+003B ‘B<;>’ tot en met U+007E ‘B<~>’). Veldnamen mogen niet +beginnen met het commentaarteken (U+0023 ‘B<#>’) en evenmin met het +verbindingsteken (U+002D ‘B<->’). + +Het veld eindigt op het einde van de regel of op het einde van de laatste +vervolgregel (zie later). Er mag horizontale witruimte (U+0020 B<SPATIE> en +U+0009 B<TAB>) voorkomen vlak voor en vlak na de waarde en daar wordt die +genegeerd. Het is gebruikelijk om na de dubbelepunt een enkele spatie te +plaatsen. Een voorbeeld van een veld zou kunnen zijn: + +=over + + Package: dpkg + +=back + +de veldnaam is B<Package> en de waarde van het veld is B<dpkg>. + +Lege veldwaarden mogen enkel voorkomen in controlebestanden van +broncodepakketten (I<debian/control>). Dergelijke velden worden genegeerd. + +In een paragraaf mag een specifieke veldnaam slechts eenmaal voorkomen. + +Er bestaan drie types velden: + +=over + +=over + +=item B<simple> + +(enkelvoudig) Het veld, met inbegrip van zijn waarde, moet op één enkele +regel staan. Het uitvouwen van het veld is niet toegestaan. Dit is het +standaard veldtype als de definiëring van het veld geen ander type vermeldt. + +=item B<folded> + +(uitgevouwen) De waarde van een uitgevouwen veld is een logische regel die +verschillende regels mag beslaan. De regels na de eerste regel worden +vervolgregels genoemd en moeten beginnen met een U+0020 B<SPATIE> of een +U+0009 B<TAB>. Witruimte, met inbegrip van regeleindes, is in de veldwaarde +van uitgevouwen velden betekenisloos. + +Deze uitvouwmethode is gelijkaardig aan RFC5322, waardoor parsers die voor +RFC5322 geschreven werden, ook in staat zijn controlebestanden te lezen die +slechts één paragraaf en geen velden van het multiregel-type bevatten. + +=item B<multiline> + +(multiregel) De waarde van een multiregel-veld mag bestaan uit meerdere +vervolgregels. De eerste regel van de waarde, het deel dat op dezelfde regel +staat als de veldnaam, heeft vaak een bijzondere betekenis en kan ook leeg +zijn. De andere regels gebruiken dezelfde syntaxis als de vervolgregels van +uitgevouwen velden. Witruimte, met inbegrip van regeleindes, is in de waarde +van multiregel-velden betekenisvol. + +=back + +Er mag geen witruimte voorkomen in namen (van pakketten, architecturen, +bestanden of om het even wat), in versienummers of tussen de tekens van +versierelaties die uitgedrukt worden in meerdere tekens. + +De aanwezigheid en de functie van een veld en de syntaxis van zijn waarde +kunnen verschillen naargelang het type van controlebestand. + +Veldnamen zijn niet hoofdlettergevoelig, maar het is gebruikelijk om in +veldnamen hoofd- en kleine letters samen te gebruiken, zoals hierna +geïllustreerd wordt. Veldwaarden zijn wel hoofdlettergevoelig, tenzij het in +de beschrijving van het veld anders aangegeven wordt. + +Paragraafscheidingstekens (lege regels) en regels die enkel bestaan uit +U+0020 B<SPATIE> en U+0009 B<TAB>, mogen in veldwaarden en tussen velden +niet gebruikt worden. Lege regels in veldwaarden worden meestal gemaskeerd +door ze voor te stellen als een U+0020 B<SPATIE> gevolgd door een punt +(U+002E ‘B<.>’). + +Regels die beginnen met U+0023 ‘B<#>’ zonder dat daar witruimte aan vooraf +gaat, zijn commentaarregels. Zij zijn enkel toegelaten in controlebestanden +van broncodepakketten (I<debian/control>) en in +B<deb-origin>(5)-bestanden. Deze commentaarregels worden genegeerd, zelfs +tussen twee vervolgregels in. Ze sluiten geen logische regels af. + +Alle controlebestanden moeten in UTF-8 opgesteld worden. + +=back + +=head1 ZIE OOK + +B<RFC822>, B<RFC5322>. + |