chiark - git - mdw - dpkg/blob - man/nl/deb822.man

   1 .\" dpkg manual page - deb822(5)
   2 .\"
   3 .\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk>
   4 .\" Copyright © 2015 Guillem Jover <guillem@debian.org>
   5 .\"
   6 .\" This is free software; you can redistribute it and/or modify
   7 .\" it under the terms of the GNU General Public License as published by
   8 .\" the Free Software Foundation; either version 2 of the License, or
   9 .\" (at your option) any later version.
  10 .\"
  11 .\" This is distributed in the hope that it will be useful,
  12 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 .\" GNU General Public License for more details.
  15 .\"
  16 .\" You should have received a copy of the GNU General Public License
  17 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  18 .
  19 .\"*******************************************************************
  20 .\"
  21 .\" This file was generated with po4a. Translate the source file.
  22 .\"
  23 .\"*******************************************************************
  24 .TH deb822 5 %RELEASE_DATE% %VERSION% dpkg\-suite
  25 .nh
  26 .SH NAAM
  27 deb822 \- Debian RFC822\-indeling voor controledata
  28 .
  29 .SH BESCHRIJVING
  30 Het pakketbeheersysteem gebruikt gegevens die volgens een gangbare indeling
  31 weergegeven worden, die \fIcontroledata\fP (control\-data) genoemd worden en die
  32 opgeslagen worden in \fIcontrolebestanden\fP
  33 (control\-bestanden). Controlebestanden worden gebruikt voor
  34 broncodepakketten, voor binaire pakketten en voor de \fB.changes\fP\-bestanden
  35 die de installatie van geüploade bestanden sturen (de interne databases van
  36 \fBdpkg\fP hebben een soortgelijke indeling).
  37 .
  38 .SH SYNTAXIS
  39 Een controlebestand bestaat uit één of meer paragrafen die velden bevatten
  40 (de paragrafen worden soms ook met de term stanzas aangeduid). De paragrafen
  41 worden onderling gescheiden door een lege regel. Bij ontleders (parsers)
  42 kunnen regels die enkel bestaan uit U+0020 \fBSPATIE\fP en U+0009 \fBTAB\fP,
  43 gebruikt worden als scheidingsteken tussen paragrafen, maar in
  44 controlebestanden moeten lege regels gebruikt worden. In sommige
  45 controlebestanden is enkel één paragraaf toegestaan, in andere meerdere. In
  46 dat geval heeft elke paragraaf meestal betrekking op een ander pakket. (In
  47 broncodepakketten bijvoorbeeld, heeft de eerste paragraaf betrekking op het
  48 broncodepakket en de volgende op de binaire pakketten die uit de broncode
  49 gegenereerd worden.) De volgorde van de paragrafen in controlebestanden is
  50 betekenisvol.
  51
  52 Elke paragraaf bestaat uit een reeks gegevensvelden. Elk veld bestaat uit de
  53 veldnaam, gevolgd door een dubbelepunt (U+003A ‘\fB:\fP’) en nadien de
  54 data/waarde die bij dat veld hoort. De veldnaam wordt gevormd uit
  55 US\-ASCII\-tekens met uitsluiting van controle\-tekens, spatie en dubbelepunt
  56 (d.w.z. tekens uit het bereik U+0021 ‘\fB!\fP’ tot en met U+0039 ‘\fB9\fP’ en uit
  57 het bereik U+003B ‘\fB;\fP’ tot en met U+007E ‘\fB~\fP’). Veldnamen mogen niet
  58 beginnen met het commentaarteken (U+0023 ‘\fB#\fP’) en evenmin met het
  59 verbindingsteken (U+002D ‘\fB\-\fP’).
  60
  61 Het veld eindigt op het einde van de regel of op het einde van de laatste
  62 vervolgregel (zie later). Er mag horizontale witruimte (U+0020 \fBSPATIE\fP en
  63 U+0009 \fBTAB\fP) voorkomen vlak voor en vlak na de waarde en daar wordt die
  64 genegeerd. Het is gebruikelijk om na de dubbelepunt een enkele spatie te
  65 plaatsen. Een voorbeeld van een veld zou kunnen zijn:
  66 .RS
  67 .nf
  68 Package: dpkg
  69 .fi
  70 .RE
  71 de veldnaam is \fBPackage\fP en de waarde van het veld is \fBdpkg\fP.
  72
  73 Lege veldwaarden mogen enkel voorkomen in controlebestanden van
  74 broncodepakketten (\fIdebian/control\fP). Dergelijke velden worden genegeerd.
  75
  76 In een paragraaf mag een specifieke veldnaam slechts eenmaal voorkomen.
  77
  78 Er bestaan drie types velden:
  79
  80 .RS 0
  81 .TP
  82 \fBsimple\fP
  83 (enkelvoudig) Het veld, met inbegrip van zijn waarde, moet op één enkele
  84 regel staan. Het uitvouwen van het veld is niet toegestaan. Dit is het
  85 standaard veldtype als de definiëring van het veld geen ander type vermeldt.
  86 .TP
  87 \fBfolded\fP
  88 (uitgevouwen) De waarde van een uitgevouwen veld is een logische regel die
  89 verschillende regels mag beslaan. De regels na de eerste regel worden
  90 vervolgregels genoemd en moeten beginnen met een U+0020 \fBSPATIE\fP of een
  91 U+0009 \fBTAB\fP. Witruimte, met inbegrip van regeleindes, is in de veldwaarde
  92 van uitgevouwen velden betekenisloos.
  93
  94 Deze uitvouwmethode is gelijkaardig aan RFC5322, waardoor parsers die voor
  95 RFC5322 geschreven werden, ook in staat zijn controlebestanden te lezen die
  96 slechts één paragraaf en geen velden van het multiregel\-type bevatten.
  97 .TP
  98 \fBmultiline\fP
  99 (multiregel) De waarde van een multiregel\-veld mag bestaan uit meerdere
 100 vervolgregels. De eerste regel van de waarde, het deel dat op dezelfde regel
 101 staat als de veldnaam, heeft vaak een bijzondere betekenis en kan ook leeg
 102 zijn. De andere regels gebruiken dezelfde syntaxis als de vervolgregels van
 103 uitgevouwen velden. Witruimte, met inbegrip van regeleindes, is in de waarde
 104 van multiregel\-velden betekenisvol.
 105 .RE
 106
 107 Er mag geen witruimte voorkomen in namen (van pakketten, architecturen,
 108 bestanden of om het even wat), in versienummers of tussen de tekens van
 109 versierelaties die uitgedrukt worden in meerdere tekens.
 110
 111 De aanwezigheid en de functie van een veld en de syntaxis van zijn waarde
 112 kunnen verschillen naargelang het type van controlebestand.
 113
 114 Veldnamen zijn niet hoofdlettergevoelig, maar het is gebruikelijk om in
 115 veldnamen hoofd\- en kleine letters samen te gebruiken, zoals hierna
 116 geïllustreerd wordt. Veldwaarden zijn wel hoofdlettergevoelig, tenzij het in
 117 de beschrijving van het veld anders aangegeven wordt.
 118
 119 Paragraafscheidingstekens (lege regels) en regels die enkel bestaan uit
 120 U+0020 \fBSPATIE\fP en U+0009 \fBTAB\fP, mogen in veldwaarden en tussen velden
 121 niet gebruikt worden. Lege regels in veldwaarden worden meestal gemaskeerd
 122 door ze voor te stellen als een U+0020 \fBSPATIE\fP gevolgd door een punt
 123 (U+002E ‘\fB.\fP’).
 124
 125 Regels die beginnen met U+0023 ‘\fB#\fP’ zonder dat daar witruimte aan vooraf
 126 gaat, zijn commentaarregels. Zij zijn enkel toegelaten in controlebestanden
 127 van broncodepakketten (\fIdebian/control\fP) en in
 128 \fBdeb\-origin\fP(5)\-bestanden. Deze commentaarregels worden genegeerd, zelfs
 129 tussen twee vervolgregels in. Ze sluiten geen logische regels af.
 130
 131 Alle controlebestanden moeten in UTF\-8 opgesteld worden.
 132 .
 133 .\" .SH EXAMPLE
 134 .\" .RS
 135 .\" .nf
 136 .\" .fi
 137 .\" .RE
 138 .
 139 .SH "ZIE OOK"
 140 \fBRFC822\fP, \fBRFC5322\fP.