NAAM

       deb822 - Debian RFC822-indeling voor controledata

BESCHRIJVING

       Het pakketbeheersysteem gebruikt gegevens die volgens een gangbare indeling weergegeven
       worden, die controledata (control-data) genoemd worden en die opgeslagen worden in
       controlebestanden (control-bestanden). Controlebestanden worden gebruikt voor
       broncodepakketten, voor binaire pakketten en voor de .changes-bestanden die de installatie
       van geüploade bestanden sturen (de interne databases van dpkg hebben een soortgelijke
       indeling).

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
       SPATIE en U+0009 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 ‘:’) 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 ‘!’ tot en met U+0039 ‘9’ en uit het
       bereik U+003B ‘;’ tot en met U+007E ‘~’). Veldnamen mogen niet beginnen met het
       commentaarteken (U+0023 ‘#’) en evenmin met het verbindingsteken (U+002D ‘-’).

       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 SPATIE en U+0009 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:

        Package: dpkg

       de veldnaam is Package en de waarde van het veld is dpkg.

       Lege veldwaarden mogen enkel voorkomen in controlebestanden van broncodepakketten
       (debian/control). Dergelijke velden worden genegeerd.

       In een paragraaf mag een specifieke veldnaam slechts eenmaal voorkomen.

       Er bestaan drie types velden:

           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.

           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 SPATIE of een U+0009 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.

           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.

           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 SPATIE
           en U+0009 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 SPATIE
           gevolgd door een punt (U+002E ‘.’).

           Regels die beginnen met U+0023 ‘#’ zonder dat daar witruimte aan vooraf gaat, zijn
           commentaarregels. Zij zijn enkel toegelaten in controlebestanden van broncodepakketten
           (debian/control) en in 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.

ZIE OOK

       RFC822, RFC5322.