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

   1 .\" dpkg manual page - dsc(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 dsc 5 %RELEASE_DATE% %VERSION% dpkg\-suite
  25 .nh
  26 .SH NAAM
  27 dsc \- Indeling van het controlebestand van Debian\-broncodepakketten
  28 .
  29 .SH OVERZICHT
  30 \fIbestandsnaam\fP\fB.dsc\fP
  31 .
  32 .SH BESCHRIJVING
  33 Elk Debian broncodepakket bevat een .dsc\-controlebestand dat uit een aantal
  34 velden bestaat. Ieder veld begint met een markering, zoals \fBSource\fP of
  35 \fBBinary\fP (niet hoofdlettergevoelig), gevolgd door een dubbele punt en de
  36 tekstinhoud van het veld. Velden worden enkel door veldmarkeringen
  37 begrensd. De tekstinhoud van het veld kan met andere woorden verschillende
  38 regels lang zijn, maar de installatiegereedschappen zullen bij het verwerken
  39 van de tekstinhoud de regels gewoonlijk samenvoegen (behalve in het geval
  40 van de multiregel\-velden \fBPackage\-List\fP, \fBFiles\fP, \fBChecksums\-Sha1\fP en
  41 \fBChecksums\-Sha256\fP; zie hierna)
  42 .PP
  43 De controle\-data mogen ingesloten liggen in een OpenPGP\-handtekening met
  44 ASCII\-harnas volgens de specificatie RFC4880.
  45 .
  46 .SH VELDEN
  47 .TP
  48 \fBFormat:\fP \fIindelingsversie\fP (verplicht)
  49 De waarde van dit veld declareert de indelingsversie van het
  50 broncodepakket. De veldwaarde wordt door programma's die met een
  51 broncodepakket werken, gebruikt om de bestandslijst in het broncodepakket te
  52 interpreteren en te bepalen hoe het uitgepakt moet worden. De syntaxis van
  53 de veldwaarde is: een numerieke hoofdversie, een punt, een numerieke
  54 onderversie, en dan eventueel na witruimte een subtype dat, als het
  55 opgegeven wordt, bestaat uit een alfanumeriek woord tussen haakjes. Vanuit
  56 het oogpunt van syntaxis is het subtype optioneel, maar voor specifieke
  57 revisies van de indeling van broncodepakketten kan het een verplicht
  58 onderdeel zijn.
  59
  60 De indelingen van broncodepakketten die momenteel ondersteund worden door
  61 \fBdpkg\fP zijn \fB1.0\fP, \fB2.0\fP, \fB3.0 (native)\fP, \fB3.0 (quilt)\fP, \fB3.0 (git)\fP,
  62 \fB3.0 (bzr)\fP en \fB3.0 (custom)\fP.
  63 .TP
  64 \fBSource:\fP \fIbroncodepakket\-naam\fP (verplicht)
  65 De waarde van dit veld bepaalt de pakketnaam en wordt door de meeste
  66 installatiegereedschappen gebruikt om bestandsnamen te genereren.
  67 .TP
  68 \fBBinary:\fP\fI lijst\-van\-binaire\-pakketten\fP
  69 Dit gevouwen veld somt, door komma's van elkaar gescheiden, de binaire
  70 pakketten op die door dit broncodepakket gebouwd kunnen worden.
  71
  72 Dit veld is nu vervangen door het veld \fBPackage\-List\fP dat voldoende
  73 informatie geeft over welke binaire pakketten op welke architecturen
  74 geproduceerd worden, over bouwprofielen en over andere restricties die van
  75 belang zijn.
  76 .TP
  77 \fBArchitecture:\fP \fIarch\-lijst\fP (aanbevolen)
  78 Een lijst van door spaties van elkaar gescheiden architecturen en
  79 architectuurjokertekens die aangeven voor welk type hardware dit pakket
  80 gecompileerd kan worden. Gebruikelijke architectuurnamen en
  81 architectuurjokertekens zijn \fBamd64\fP, \fBarmel\fP, \fBi386\fP, \fBlinux\-any\fP,
  82 \fBany\-amd64\fP, enz.
  83
  84 Merk op dat de waarde \fBall\fP bedoeld is voor pakketten die
  85 architectuuronafhankelijk zijn en \fBany\fP voor pakketten die
  86 architectuurafhankelijk zijn. De lijst mag de speciale waarde  \fBall\fP
  87 bevatten (of er uitsluitend uit bestaan). Wanneer de lijst het
  88 architectuurjokerteken \fBany\fP bevat, is \fBall\fP de enige andere toegelaten
  89 waarde in de lijst.
  90
  91 De waarde van dit veld wordt gewoonlijk gegenereerd op basis van de
  92 \fBArchitecture\fP\-velden in het bestand \fIdebian/control\fP van het
  93 broncodepakket.
  94 .TP
  95 \fBVersion:\fP \fIversie\-tekenreeks\fP (verplicht)
  96 Gewoonlijk is dit het originele versienummer van het pakket, welke vorm de
  97 auteur van het programma er ook voor gebruikt. Het kan ook een
  98 Debian\-revisienummer bevatten (voor niet uit Debian stammende pakketten). De
  99 exacte indeling en het sorteringsalgoritme worden beschreven in
 100 \fBdeb\-version\fP(5).
 101 .TP
 102 \fBOrigin:\fP\fI naam\fP
 103 De naam van de distributie waaruit dit pakket afkomstig is.
 104 .TP
 105 \fBMaintainer:\fP \fIvolledige\-naam\-en\-e\-mail\fP (aanbevolen)
 106 Moet opgemaakt worden volgens de indeling “Joe Bloggs
 107 <jbloggs@foo.com>”, en is gewoonlijk de persoon die het pakket
 108 maakte, in tegenstelling tot de auteur van de verpakte software.
 109 .TP
 110 \fBUploaders:\fP\fI lijst van volledige\-namen\-en\-e\-mailadressen\fP
 111 Somt al de namen en de e\-mailadressen op van de personen die het pakket mee
 112 onderhouden volgens dezelfde indeling als van het veld
 113 \fBMaintainer\fP. Meerdere mede\-onderhouders moeten onderling door een komma
 114 gescheiden worden.
 115 .TP
 116 \fBHomepage:\fP\fI URL\fP
 117 De \fIURL\fP van de homepage van het toeleverend project (upstream).
 118 .TP
 119 \fBStandards\-Version:\fP \fIversietekenreeks\fP (aanbevolen)
 120 Dit documenteert de meest recente versie van de normen die vastgelegd werden
 121 in de richtlijnen van de distributie en waaraan dit pakket voldoet.
 122 .TP
 123 \fBVcs\-Browser:\fP\fI URL\fP
 124 De \fIurl\fP van een webinterface waarmee door de opslagruimte van het
 125 versiecontrolesysteem kan gebladerd worden.
 126 .TP
 127 \fBVcs\-Arch:\fP\fI URL\fP
 128 .TQ
 129 \fBVcs\-Bzr:\fP\fI URL\fP
 130 .TQ
 131 \fBVcs\-Cvs:\fP\fI URL\fP
 132 .TQ
 133 \fBVcs\-Darcs:\fP\fI URL\fP
 134 .TQ
 135 \fBVcs\-Git:\fP\fI URL\fP
 136 .TQ
 137 \fBVcs\-Hg:\fP\fI URL\fP
 138 .TQ
 139 \fBVcs\-Mtn:\fP\fI URL\fP
 140 .TQ
 141 \fBVcs\-Svn:\fP\fI URL\fP
 142 Deze velden declareren de \fIurl\fP van de opslagruimte van het
 143 versiecontrolesysteem dat gebruikt wordt om dit pakket te onderhouden. Zie
 144 \fBdeb\-src\-control\fP(5) voor verdere informatie.
 145 .TP
 146 \fBTestsuite:\fP\fI namenlijst\fP
 147 Dit veld declareert dat het broncodepakket de opgegeven testsuites bevat. De
 148 waarde is een lijst van onderling door spaties gescheiden testsuites. Indien
 149 de waarde \fBautopkgtest\fP bestaat, wordt verondersteld dat het bestand
 150 \fIdebian/tests/control\fP bestaat. Indien het bestand bestaat, maar de waarde
 151 niet, dan zal \fBdpkg\-source\fP die automatisch toevoegen met behoud van de
 152 vroegere waarden.
 153 .TP
 154 \fBTestsuite\-Triggers:\fP\fI pakketlijst\fP
 155 Dit veld declareert de door komma's gescheiden unie van alle testvereisten
 156 (de velden \fBDepends\fP uit het bestand \fIdebian/tests/control\fP), waaruit alle
 157 restricties verwijderd en alle OR\-vereisten uitgevlakt werden, met
 158 uitzondering van die welke gelden voor de binaire pakketten die dit
 159 broncodepakket genereert en van meta\-vereisten zoals \fB@\fP of \fB@builddeps@\fP.
 160
 161 Motivering: dit veld is noodzakelijk omdat anders elk broncodepakket
 162 uitgepakt zou moeten worden om de testvereisten te kunnen achterhalen.
 163 .TP
 164 \fBBuild\-Depends:\fP\fI pakketlijst\fP
 165 .TQ
 166 \fBBuild\-Depends\-Arch:\fP\fI pakketlijst\fP
 167 .TQ
 168 \fBBuild\-Depends\-Indep:\fP\fI pakketlijst\fP
 169 .TQ
 170 \fBBuild\-Conflicts:\fP\fI pakketlijst\fP
 171 .TQ
 172 \fBBuild\-Conflicts\-Arch:\fP\fI pakketlijst\fP
 173 .TQ
 174 \fBBuild\-Conflicts\-Indep:\fP\fI pakketlijst\fP
 175 Deze velden declareren de relaties tussen het broncodepakket en de pakketten
 176 die gebruikt worden om het te bouwen. Zij worden besproken in de man\-pagina
 177 \fBdeb\-src\-control\fP(5).
 178 .TP
 179 \fBPackage\-List:\fP
 180 .TQ
 181  \fIpakket\fP \fIpakkettype\fP \fIsectie\fP \fIprioriteit\fP \fItrefwoord\-waarde\-lijst\fP
 182 Dit multiregel\-veld bevat een lijst van binaire pakketten die door dit
 183 broncodepakket gegenereerd worden.
 184
 185 Het element \fIpakket\fP is de naam van het binaire pakket.
 186
 187 Het element \fIpakket\-type\fP is het type van het binaire pakket, meestal
 188 \fBdeb\fP; een andere gebruikelijke waarde is \fBudeb\fP.
 189
 190 De elementen \fIsectie\fP (section) en \fIprioriteit\fP (priority) komen overeen
 191 met de velden met dezelfde naam van het binaire pakket.
 192
 193 Het element \fItrefwoord\-waarde\-lijst\fP is een lijst van door spaties
 194 gescheiden \fItrefwoord\fP\fB=\fP\fIwaarde\fP en de momenteel herkende optionele
 195 trefwoorden zijn:
 196
 197 .RS
 198 .TP
 199 \fBarch\fP
 200 De architectuurrestrictie uit het veld \fBArchitecture\fP van het binaire
 201 pakket, waarbij spaties naar ‘,’ geconverteerd worden.
 202 .TP
 203 \fBprofile\fP
 204 De genormaliseerde bouwprofiel\-restrictieformule uit het veld
 205 \fBBuild\-Profile\fP van het binaire pakket, waarbij OR's omgezet worden naar
 206 ‘+’ en AND's naar ‘,’.
 207 .TP
 208 \fBessential\fP
 209 Indien het binaire pakket essentieel (essential) is, zal dit trefwoord de
 210 waarde hebben van het veld \fBEssential\fP en dat is de waarde \fByes\fP.
 211 .RE
 212 .TP
 213 \fBFiles:\fP (verplicht)
 214 .TQ
 215 \fBChecksums\-Sha1:\fP (verplicht)
 216 .TQ
 217 \fBChecksums\-Sha256:\fP (verplicht)
 218 .TQ
 219  \fIcontrolesom\fP \fIgrootte\fP \fIbestandsnaam\fP
 220 Deze multiregel\-velden bevatten een lijst van bestanden met voor elk van hen
 221 een controlesom en een grootte. Deze velden hebben een identieke syntaxis en
 222 verschillen onderling enkel inzake het gebruikte algoritme voor de
 223 controlesom: MD5 voor \fBFiles\fP, SHA\-1 voor \fBChecksums\-Sha1\fP en SHA\-256 voor
 224 \fBChecksums\-Sha256\fP.
 225
 226 De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als
 227 de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van
 228 het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke
 229 regel bestaat uit de controlesom, een spatie, de bestandsgrootte, een spatie
 230 en de bestandsnaam.
 231
 232 Deze velden sommen alle bestanden op die deel uitmaken van het
 233 broncodepakket. De lijst bestanden in deze velden moet overeenkomen met de
 234 lijst bestanden in de andere verwante velden.
 235 .
 236 .\" .SH EXAMPLE
 237 .\" .RS
 238 .\" .nf
 239 .\" .fi
 240 .\" .RE
 241 .
 242 .SH BUGS
 243 Het veld \fBFormat\fP combineert de indeling van het \fB.dsc\fP\-bestand zelf en de
 244 indeling van het uitgepakte broncodepakket.
 245 .SH "ZIE OOK"
 246 \fBdeb\-src\-control\fP(5), \fBdeb\-version\fP(5), \fBdpkg\-source\fP(1).