973 lines
49 KiB
HTML
973 lines
49 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of dpkg-source</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>dpkg-source</H1>
|
|
Section: dpkg-suite (1)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAAM</H2>
|
|
|
|
dpkg-source - gereedschap voor het manipuleren van een Debian broncodepakket
|
|
(.dsc)
|
|
<A NAME="lbAC"> </A>
|
|
<H2>OVERZICHT</H2>
|
|
|
|
<B>dpkg-source</B> [<I>optie</I>...] <I>commando</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHRIJVING</H2>
|
|
|
|
<B>dpkg-source</B> pakt Debian broncodearchieven in en uit.
|
|
<P>
|
|
Bij geen enkel van deze commando's is het toegelaten om meerdere opties tot
|
|
één enkele optie te combineren of de waarde van een optie via een apart
|
|
argument op te geven.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>COMMANDO'S</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-x</B>, <B>--extract</B> <I>bestandsnaam</I>.dsc [<I>uitvoermap</I>]<DD>
|
|
Extraheer een broncodepakket (<B>--extract</B> sinds dpkg 1.17.14). Er moet één
|
|
argument dat geen optie is, opgegeven worden, namelijk de naam van het
|
|
controlebestand (<B>.dsc</B>) van de Debian broncode. Facultatief kan een tweede
|
|
argument dat geen optie is, opgegeven worden om de map op te geven waarin
|
|
het pakket geëxtraheerd moet worden. Die mag nog niet bestaan. Indien geen
|
|
uitvoermap opgegeven werd, zal het broncodepakket uitgepakt worden in een
|
|
map met als naam <I>broncode</I>-<I>versie</I>, die onder de huidige werkmap ligt.
|
|
<P>
|
|
<B>dpkg-source</B> zal uit het controlebestand de namen van de andere bestanden
|
|
lezen die samen het broncodepakket vormen. Er wordt van uitgegaan dat ze
|
|
zich in dezelfde map bevinden als het <B>.dsc</B>-bestand.
|
|
<P>
|
|
De permissies en het eigenaarschap van de bestanden uit het geëxtraheerde
|
|
pakket zullen zodanig ingesteld worden dat ze beantwoorden aan wat men zou
|
|
mogen verwachten mochten de bestanden en mappen gewoon aangemaakt zijn -
|
|
mappen en uitvoerbare bestanden zullen 0777 zijn en gewone bestanden 0666 en
|
|
beide zullen aangepast worden op basis van het umask van degene die het
|
|
pakket uitpakt. Indien de bovenliggende map setgid is, zullen de
|
|
geëxtraheerde mappen dat ook zijn en al de bestanden en mappen zullen dit
|
|
groepseigenaarschap overerven.
|
|
<P>
|
|
Indien het broncodepakket een niet-standaardindeling gebruikt (momenteel
|
|
betekent dit alle indelingen behalve "1.0"), dan zal de naam ervan
|
|
opgeslagen worden in <B>debian/source/format</B>, zodat standaard deze indeling
|
|
gebruikt wordt bij de volgende malen dat het broncodepakket gebouwd wordt.
|
|
<P>
|
|
<DT id="2"><B>-b</B>, <B>--build</B> <I>map</I> [<I>indelingsspecifieke-parameters</I>]<DD>
|
|
Bouw een broncodepakket (<B>--build</B> sinds dpkg 1.17.14). Het eerste argument
|
|
dat geen optie is, wordt gebruikt als de naam van de map die de voor Debian
|
|
gereedgemaakte broncodeboom bevat (d.w.z. met een onderliggende map debian
|
|
en eventuele veranderingen aan de originele bestanden). Afhankelijk van de
|
|
broncodepakketindeling die men gebruikt om het broncodepakket te bouwen,
|
|
kunnen bijkomende parameters opgegeven worden.
|
|
<P>
|
|
<B>dpkg-source</B> zal het broncodepakket bouwen volgens de eerste indeling die
|
|
gevonden wordt in de hierna volgende geordende lijst: de indeling opgegeven
|
|
met de commandoregeloptie <I>--format</I>, de indeling aangegeven in
|
|
<B>debian/source/format</B>, "1.0". Het terugvallen op "1.0" word afgeschaft en
|
|
zal op een bepaald moment in de toekomst weggelaten worden. U zou de
|
|
gewenste broncode-indeling steeds moeten documenteren in
|
|
<B>debian/source/format</B>. Zie het onderdeel <B>INDELINGEN VAN
|
|
BRONCODEPAKKETTEN</B> voor een uitgebreide beschrijving van de verschillende
|
|
indelingen voor broncodepakketten.
|
|
<P>
|
|
<DT id="3"><B>--print-format</B> <I>map</I><DD>
|
|
Geef weer welke indeling gebruikt zou worden om het broncodepakket te bouwen
|
|
indien <B>dpkg-source --build </B><I>map</I> aangeroepen werd (in dezelfde condities
|
|
en met dezelfde parameters; sinds dpkg 1.15.5).
|
|
<P>
|
|
<DT id="4"><B>--before-build</B> <I>map</I><DD>
|
|
Voer de overeenkomstige uitbreiding (hook) uit van de broncodepakketindeling
|
|
(sinds dpkg 1.15.8). Deze uitbreiding wordt telkens aangeroepen voor het
|
|
pakket gebouwd wordt (<B>dpkg-buildpackage</B> roept ze zeer vroeg aan, zelfs
|
|
voor <B>debian/rules clean</B>). Dit commando is idempotent en kan meermaals
|
|
aangeroepen worden. Niet alle broncode-indelingen implementeren iets in deze
|
|
uitbreiding, en die welke dat wel doen bereiden gewoonlijk de broncodeboom
|
|
voor op het bouwproces, bijvoorbeeld door ervoor te zorgen dat de
|
|
Debian-patches toegepast worden.
|
|
<P>
|
|
<DT id="5"><B>--after-build</B> <I>map</I><DD>
|
|
Voer de overeenkomstige uitbreiding (hook) uit van de broncodepakketindeling
|
|
(sinds dpkg 1.15.8). Deze uitbreiding wordt telkens aangeroepen nadat het
|
|
pakket gebouwd werd (<B>dpkg-buildpackage</B> roept ze als laatste aan). Dit
|
|
commando is idempotent en kan meermaals aangeroepen worden. Niet alle
|
|
broncode-indelingen implementeren iets in deze uitbreiding, en die welke dat
|
|
wel doen gebruiken ze gewoonlijk om ongedaan te maken wat <B>--before-build</B>
|
|
gedaan heeft.
|
|
<P>
|
|
<DT id="6"><B>--commit</B> [<I>map</I>] ...<DD>
|
|
Tekent veranderingen op in de broncodeboom die in <I>map</I> uitgepakt werd
|
|
(sinds dpkg 1.16.1). Aan dit commando kunnen afhankelijk van de
|
|
broncode-indeling bijkomende parameters opgegeven worden. Het zal een
|
|
foutmelding geven bij indelingen waarvoor deze operatie geen betekenis
|
|
heeft.
|
|
<P>
|
|
<DT id="7"><B>-?</B>, <B>--help</B><DD>
|
|
Toon de gebruiksaanwijzing en sluit af. Met de optie <B>--format</B> kunnen de
|
|
indelingsspecifieke bouw- en extractie-opties getoond worden.
|
|
<DT id="8"><B>--version</B><DD>
|
|
Toon de versie en sluit af.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIES</H2>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Generieke bouwopties</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><B>-c</B><I>controlebestand</I><DD>
|
|
Duidt aan wat het belangrijkste controlebestand van de broncode is waaruit
|
|
informatie gelezen moet worden. Standaard is dat <B>debian/control</B>. Indien
|
|
het opgegeven wordt met een relatieve padnaam, dan wordt die geïnterpreteerd
|
|
te beginnen bij de basismap van de broncodeboom.
|
|
<DT id="10"><B>-l</B><I>changelog-bestand</I><DD>
|
|
Duidt het changelog-bestand aan waaruit informatie gelezen moet
|
|
worden. Standaard is dat <B>debian/changelog</B>. Indien het opgegeven wordt met
|
|
een relatieve padnaam, dan wordt die geïnterpreteerd te beginnen bij de
|
|
basismap van de broncodeboom.
|
|
<DT id="11"><B>-F</B><I>changelog-indeling</I><DD>
|
|
Geeft de indeling van het bestand changelog aan. Zie
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-parsechangelog">dpkg-parsechangelog</A></B>(1) voor informatie over alternatieve indelingen.
|
|
<DT id="12"><B>--format=</B><I>waarde</I><DD>
|
|
Gebruik de opgegeven indeling om het broncodepakket te bouwen (sinds dpkg
|
|
1.14.17). Het vervangt een eventuele in <B>debian/source/format</B> opgegeven
|
|
indeling.
|
|
<DT id="13"><B>-V</B><I>naam</I><B>=</B><I>waarde</I><DD>
|
|
Stel een uitvoersubstitutievariabele in. Zie <B><A HREF="/cgi-bin/man/man2html?5+deb-substvars">deb-substvars</A></B>(5) voor een
|
|
bespreking van uitvoersubstitutie.
|
|
<DT id="14"><B>-T</B><I>substvars-bestand</I><DD>
|
|
Lees substitutievariabelen uit <I>substvars-bestand</I>. De standaard is om geen
|
|
enkel bestand te lezen. Deze optie kan meermaals gebruikt worden om uit
|
|
verschillende bestanden substitutievariabelen te lezen (sinds dpkg 1.15.6).
|
|
<DT id="15"><B>-D</B><I>veld</I><B>=</B><I>waarde</I><DD>
|
|
Vervang in de uitvoer een veld uit het controlebestand of voeg er een toe.
|
|
<DT id="16"><B>-U</B><I>veld</I><DD>
|
|
Verwijder in de uitvoer een veld uit het controlebestand.
|
|
<DT id="17"><B>-Z</B><I>compressie</I>, <B>--compression</B>=<I>compressie</I><DD>
|
|
Duidt het compressieniveau aan dat gebruikt wordt bij het maken van
|
|
tar-archieven en diff-bestanden (<B>--compression</B> sinds dpkg 1.15.5). Merk
|
|
op dat deze optie niet tot effect heeft dat bestaande tar-archieven opnieuw
|
|
gecomprimeerd worden. Ze heeft enkel invloed op nieuwe
|
|
bestanden. Ondersteunde waarden zijn: <I>gzip</I>, <I>bzip2</I>, <I>lzma</I> en
|
|
<I>xz</I>. De standaardwaarde is <I>xz</I> voor de indeling 2.0 en recentere
|
|
indelingen en <I>gzip</I> voor de indeling 1.0. <I>xz</I> wordt enkel sinds dpkg
|
|
1.15.5 ondersteund.
|
|
<DT id="18"><B>-z</B><I>niveau</I>, <B>--compression-level</B>=<I>niveau</I><DD>
|
|
Het te gebruiken compressieniveau (<B>--compression-level</B> sinds dpkg
|
|
1.15.5). Zoals dit het geval is bij <B>-Z</B>, beïnvloedt dit enkel nieuw
|
|
aangemaakte bestanden. Ondersteunde waarden zijn: <I>1</I> tot <I>9</I>, <I>best</I>, en
|
|
<I>fast</I>. De standaardwaarde is <I>9</I> voor gzip en bzip2, <I>6</I> voor xz en
|
|
lzma.
|
|
<DT id="19"><B>-i</B>[<I>regex</I>], <B>--diff-ignore</B>[=<I>regex</I>]<DD>
|
|
U kunt een perl reguliere expressie opgeven om bestanden die ermee
|
|
overeenkomen weg te houden uit de lijst bestanden waarover de gemaakte diff
|
|
(overzicht van ondergane wijzigingen) gaat (<B>--diff-ignore</B> sinds dpkg
|
|
1.15.6). (Deze lijst wordt gegenereerd door een find-opdracht.) (Als het
|
|
broncodepakket gebouwd wordt als een versie 3 broncodepakket dat gebruik
|
|
maakt van een VCS (Version Control System - versiebeheersysteem), kan dit
|
|
gebruikt worden om niet-toegepaste wijzigingen aan specifieke bestanden te
|
|
laten negeren. Door -i.* te gebruiken zullen ze allemaal genegeerd worden.)
|
|
<P>
|
|
De optie <B>-i</B> zelf schakelt deze instelling in met een standaard reguliere
|
|
expressie (met behoud van eventuele wijzigingen aan de standaard reguliere
|
|
expressie onder invloed van een eerder gebruikt <B>--extend-diff-ignore</B>) die
|
|
zorgt voor het uitfilteren van controlebestanden en -mappen van de meest
|
|
courante versiebeheersystemen, van back-upbestanden en wisselbestanden en
|
|
van bouwuitvoermappen van Libtool. Er kan slechts één reguliere expressie
|
|
actief zijn. Van meerdere <B>-i</B>-opties zal enkel de laatste uitwerking
|
|
hebben.
|
|
<P>
|
|
Dit is erg bruikbaar voor het wegknippen van vreemde bestanden die mee
|
|
opgenomen geraken in de diff, bijvoorbeeld als u de broncode onderhoudt in
|
|
een versiebeheersysteem en een werkkopie (checkout) wilt gebruiken om een
|
|
broncodepakket te bouwen, zonder dat daarin ook de extra bestanden en mappen
|
|
die ze meestal bevat (bijvoorbeeld CVS/, .cvsignore, .svn/), mee opgenomen
|
|
worden. De standaard reguliere expressie is reeds zeer exhaustief, maar
|
|
indien u ze moet vervangen, moet u ermee rekening houden dat ze standaard
|
|
een overeenkomst kan opleveren met elk onderdeel van een pad. Indien u dus
|
|
een overeenkomst zoekt met het begin van een bestandsnaam of enkel met
|
|
volledige bestandsnamen, zult u zelf de nodige ankers (bijvoorbeeld '(^|/)',
|
|
'($|/)') moeten opgeven.
|
|
<DT id="20"><B>--extend-diff-ignore</B>=<I>regex</I><DD>
|
|
De opgegeven perl reguliere expressie breidt de standaardwaarde die door
|
|
<B>--diff-ignore</B> gebruikt wordt, uit en de huidige waarde ervan als die
|
|
ingesteld werd (sinds dpkg 1.15.6). Het doet dit door "<B>|</B><I>regex</I>" samen
|
|
te voegen met de bestaande waarde. Deze optie is handig om te gebruiken in
|
|
<B>debian/source/options</B> om bepaalde automatisch gegenereerde bestanden uit
|
|
te sluiten bij het automatisch genereren van patches.
|
|
<DT id="21"><B>-I</B>[<I>bestandspatroon</I>], <B>--tar-ignore</B>[=<I>bestandspatroon</I>]<DD>
|
|
Indien deze optie opgegeven werd, wordt het patroon doorgegeven aan de optie
|
|
<B>--exclude</B> van <B><A HREF="/cgi-bin/man/man2html?1+tar">tar</A></B>(1) wanneer dit commando ingeroepen wordt om een
|
|
bestand .orig.tar of .tar aan te maken (<B>--tar-ignore</B> sinds dpkg
|
|
1.15.6). Bijvoorbeeld, <B>-I</B>CVS zal tar CVS-mappen doen overslaan bij het
|
|
genereren van een .tar.gz-bestand. Deze optie kan meermaals herhaald worden
|
|
om meerdere patronen die uitgesloten moeten worden op te sommen.
|
|
<P>
|
|
<B>-I</B> zelf voegt standaard <B>--exclude</B>-opties toe die zorgen voor het
|
|
uitfilteren van controlebestanden en -mappen van de meest courante
|
|
versiebeheersystemen, van back-upbestanden en wisselbestanden en van
|
|
bouwuitvoermappen van Libtool.
|
|
</DL>
|
|
<P>
|
|
|
|
<B>Opmerking:</B> hoewel zij vergelijkbare bedoelingen hebben, hebben <B>-i</B> en
|
|
<B>-I</B> een heel verschillende syntaxis en semantiek. <B>-i</B> kan slechts
|
|
eenmaal opgegeven worden en verwacht een reguliere expressie die
|
|
perl-compatibel is en die vergeleken wordt met het volledige relatieve pad
|
|
van elk bestand. <B>-I</B> kan meermaals opgegeven worden en verwacht een
|
|
bestandsnaampatroon met shell-jokertekens. Het patroon wordt toegepast op
|
|
het volledige relatieve pad maar ook op elk individueel onderdeel van het
|
|
pad. De exacte semantiek van de optie <B>--exclude</B> van tar is enigszins
|
|
gecompliceerd. Zie voor een volledige documentatie
|
|
<A HREF="https://www.gnu.org/software/tar/manual/tar.html#wildcards.">https://www.gnu.org/software/tar/manual/tar.html#wildcards.</A>
|
|
<P>
|
|
De standaard reguliere expressies en patronen voor beide opties zijn te zien
|
|
in de uitvoer van het commando <B>--help</B>.
|
|
<A NAME="lbAH"> </A>
|
|
<H3>Generieke extractieopties</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="22"><B>--no-copy</B><DD>
|
|
Kopieer de originele tar-archieven bij het geëxtraheerde broncodepakket niet
|
|
(sinds dpkg 1.14.17).
|
|
<DT id="23"><B>--no-check</B><DD>
|
|
Controleer voor het uitpakken geen ondertekeningen en controlesommen (sinds
|
|
dpkg 1.14.17).
|
|
<DT id="24"><B>--no-overwrite-dir</B><DD>
|
|
Overschrijf de extractiemap niet als ze al bestaat (sinds dpkg 1.18.8).
|
|
<DT id="25"><B>--require-valid-signature</B><DD>
|
|
Weiger het broncodepakket uit te pakken als het geen OpenPGP-ondertekening
|
|
bevat die kan gecontroleerd worden (sinds dpkg 1.15.0) met ofwel de
|
|
<I>trustedkeys.gpg</I>-sleutelbos van de gebruiker, één van de
|
|
leveranciersspecifieke sleutelbossen of met één van de officiële
|
|
sleutelbossen van Debian (<I>/usr/share/keyrings/debian-keyring.gpg</I> en
|
|
<I>/usr/share/keyrings/debian-maintainers.gpg</I>).
|
|
<DT id="26"><B>--require-strong-checksums</B><DD>
|
|
Wijger het broncodepakket uit te pakken als het geen krachtige
|
|
controlesommen bevat (sinds dpkg 1.18.7). Momenteel is <B>SHA-256</B> de enige
|
|
gekende controlesom die als krachtig aanzien wordt.
|
|
<DT id="27"><B>--ignore-bad-version</B><DD>
|
|
Als bij een controle het versienummer van het broncodepakket foutief blijkt
|
|
te zijn, maakt deze instelling dat de gegeven waarschuwing geen fataal
|
|
karakter heeft (sinds dpkg 1.17.7). Deze optie zou enkel nodig moeten zijn
|
|
bij het extraheren van oude broncodepakketten met een defecte versie om
|
|
neerwaartse compatibiliteit te verzekeren.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>INDELINGEN VAN BRONCODEPAKKETTEN</H2>
|
|
|
|
Indien u niet weet welke indeling te kiezen voor de broncode, zou u wellicht
|
|
ofwel "3.0 (quilt)" of "3.0 (native)" moeten kiezen. Zie
|
|
<A HREF="https://wiki.debian.org/Projects/DebSrc3.0">https://wiki.debian.org/Projects/DebSrc3.0</A> voor informatie over het in
|
|
gebruik nemen van deze indelingen binnen Debian.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>Indeling: 1.0</H3>
|
|
|
|
Een broncodepakket volgens deze indeling bestaat ofwel uit een
|
|
<B>.orig.tar.gz</B> gekoppeld aan een <B>.diff.gz</B> of één enkele <B>.tar.gz</B> (in
|
|
dat geval wordt van het pakket gezegd dat het <I>native</I> (eigen - van
|
|
oorsprong van Debian) is). Optioneel mag bij het originele tar-archief een
|
|
afzonderlijke handtekening van de toeleveraar <B>.orig.tar.gz.asc</B> gevoegd
|
|
zijn. De extractie ervan wordt ondersteund sinds dpkg 1.18.5.
|
|
<P>
|
|
<B>Extraheren</B>
|
|
<P>
|
|
Een Debian-eigen (native) pakket extraheren is een eenvoudige extractie van
|
|
het enige tar-archief in de doelmap. Een niet-eigen pakket extraheren
|
|
bestaat eruit dat eerst <B>.orig.tar.gz</B> uitgepakt wordt en dat dan de patch
|
|
erop toegepast wordt uit het bestand <B>.diff.gz</B>. Voor alle bestanden waarop
|
|
een patch toegepast werd, wordt de tijdsaanduiding teruggezet op het
|
|
tijdstip van extraheren van het broncodepakket (dit vermijdt
|
|
scheeftrekkingen van de tijdsaanduiding hetgeen tot problemen kan leiden
|
|
wanneer automatisch gegenereerde bestanden gepatcht worden). Het
|
|
diff-bestand kan nieuwe bestanden aanmaken (de volledige debian-map wordt op
|
|
die manier aangemaakt), maar kan geen bestanden verwijderen (lege bestanden
|
|
blijven achter).
|
|
<P>
|
|
<B>Bouwen</B>
|
|
<P>
|
|
Een Debian-eigen (native) pakket bouwen is gewoon een enkel tar-archief
|
|
maken met daarin de broncodemap. Een niet-eigen pakket bouwen bestaat uit
|
|
het extraheren van het originele tar-archief in een aparte map ".orig" en
|
|
het opnieuw aanmaken van het bestand <B>.diff.gz</B> door de <I>map</I> van het
|
|
broncodepakket te vergelijken met de .orig-map.
|
|
<P>
|
|
<B>Bouwopties (met --build):</B>
|
|
<P>
|
|
Indien een tweede argument opgegeven wordt dat geen optie is, moet het de
|
|
naam van de originele broncodemap zijn of van het tar-archief of een lege
|
|
tekenreeks als het pakket Debian-specifiek is en dus geen diffs bevat in
|
|
verband met de debianisering. Indien geen tweede argument opgegeven werd,
|
|
zal <B>dpkg-source</B> zoeken naar het tar-bestand met de originele broncode
|
|
<I>pakket</I><B>_</B><I>toeleveraarsversie</I><B>.orig.tar.gz</B> of naar de map met de
|
|
originele broncode <I>map</I><B>.orig</B>, afhankelijk van de argumenten <B>-sX</B>.
|
|
<P>
|
|
<B>-sa</B>, <B>-sp</B>, <B>-sk</B>, <B>-su</B> en <B>-sr</B> zullen geen bestaande tar-bestanden
|
|
of -mappen overschrijven. Indien dat wel gewenst wordt, dan moeten in de
|
|
plaats daarvan <B>-sA</B>, <B>-sP</B>, <B>-sK</B>, <B>-sU</B> en <B>-sR</B> gebruikt worden.
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="28"><B>-sk</B><DD>
|
|
Geeft aan dat verwacht mag worden dat de originele broncode in de vorm van
|
|
een tar-bestand kan aangetroffen worden, wat standaard
|
|
<I>pakket</I><B>_</B><I>toeleveraarsversie</I><B>.orig.tar.</B><I>extensie</I> is. Het zal deze
|
|
originele broncode als een tar-bestand laten staan of ze naar de huidige map
|
|
kopiëren als ze zich daar nog niet bevindt. Het tar-archief zal uitgepakt
|
|
worden in <I>map</I><B>.orig</B> met het oog op het genereren van het diff-bestand.
|
|
<DT id="29"><B>-sp</B><DD>
|
|
Zoals <B>-sk</B> maar dit zal naderhand de map weer verwijderen.
|
|
<DT id="30"><B>-su</B><DD>
|
|
Geeft aan dat verwacht mag worden dat de originele broncode in de vorm van
|
|
een map kan aangetroffen worden, wat standaard
|
|
<I>pakket</I><B>-</B><I>toeleveraarsversie</I><B>.orig</B> is, en <B>dpkg-source</B> zal er een
|
|
nieuw archief met de originele broncode mee maken.
|
|
<DT id="31"><B>-sr</B><DD>
|
|
Zoals <B>-su</B>, maar het zal die map na gebruik verwijderen.
|
|
<DT id="32"><B>-ss</B><DD>
|
|
Geeft aan dat de originele broncode zowel als een map als in de vorm van een
|
|
tar-bestand te vinden is. <B>dpkg-source</B> zal de map gebruiken om het
|
|
diff-bestand te creëren, maar het tar-bestand om het <B>.dsc</B>-bestand te
|
|
maken. Gebruik deze optie met zorg - indien de map en het tar-bestand niet
|
|
overeenkomen zal er een slecht broncodearchief gegenereerd worden.
|
|
<DT id="33"><B>-sn</B><DD>
|
|
Geeft aan dat er niet naar een originele broncode gezocht moet worden en dat
|
|
er geen diff-bestand aangemaakt moet worden. Als er een tweede argument
|
|
opgegeven wordt, moet het de lege tekenreeks zijn. Dit wordt gebruikt voor
|
|
Debian-specifieke pakketten die geen afzonderlijke toeleveraarsbroncode
|
|
hebben en om die reden ook geen debianiserings-diffs.
|
|
<DT id="34"><B>-sa</B> of <B>-sA</B><DD>
|
|
Geeft aan dat naar de originele broncode gezocht moet worden in de vorm van
|
|
een tar-bestand of een map. Als er een tweede argument opgegeven wordt, mag
|
|
dat een van die twee zijn of een lege tekenreeks (dit is het equivalent voor
|
|
het gebruik van <B>-sn</B>). Indien er een tar-bestand gevonden wordt, zal het
|
|
dat uitpakken om het diff-bestand aan te maken en het daarna verwijderen
|
|
(dit is het equivalent voor <B>-sp</B>). Indien een map aangetroffen wordt, zal
|
|
het die inpakken om de originele broncode te creëren en ze vervolgens
|
|
verwijderen (dit is het equivalent voor <B>-sr</B>). Indien geen van beide
|
|
gevonden wordt, zal het aannemen dat het pakket geen debianiserings-diffs
|
|
heeft, maar enkel een eenvoudig broncodearchief (dit is het equivalent voor
|
|
<B>-sn</B>). Indien beide aangetroffen worden, dan zal <B>dpkg-source</B> de map
|
|
negeren, en ze overschrijven als <B>-sA</B> opgegeven werd (dit is het
|
|
equivalent voor <B>-sP</B>) of een foutmelding geven als <B>-sa</B> opgegeven
|
|
werd. <B>-sa</B> is de standaard.
|
|
<DT id="35"><B>--abort-on-upstream-changes</B><DD>
|
|
Het proces mislukt als het gegenereerde diff-bestand wijzigingen aan
|
|
bestanden buiten de onderliggende debian-map bevat (sinds dpkg 1.15.8). Deze
|
|
optie is in <B>debian/source/options</B> niet toegestaan, maar ze kan wel
|
|
gebruikt worden in <B>debian/source/local-options</B>.
|
|
</DL>
|
|
<P>
|
|
|
|
<P>
|
|
<B>Extractieopties (met --extract):</B>
|
|
<P>
|
|
In alle gevallen zal een eventuele bestaande originele broncodeboom
|
|
verwijderd worden.
|
|
<DL COMPACT>
|
|
<DT id="36"><B>-sp</B><DD>
|
|
Als dit bij het extraheren gebruikt wordt, dan zal het de (eventuele)
|
|
originele broncode in zijn vorm van tar-bestand laten. Indien dit zich nog
|
|
niet in de huidige map bevindt, of indien er zich een bestaand maar
|
|
verschillend bestand bevindt, zal het naar daar gekopieerd worden. (<B>Dit is
|
|
de standaard</B>).
|
|
<DT id="37"><B>-su</B><DD>
|
|
Pakt de originele broncodeboom uit.
|
|
<DT id="38"><B>-sn</B><DD>
|
|
Zorgt ervoor dat de originele broncode noch naar de huidige map gekopieerd
|
|
wordt noch uitgepakt wordt. Een eventuele originele broncodeboom die zich in
|
|
de huidige map bevond, wordt nog steeds verwijderd.
|
|
</DL>
|
|
<P>
|
|
|
|
Al de <B>-s</B><I>X</I>-opties sluiten elkaar wederzijds uit. Indien u er meer dan
|
|
één opgeeft, dan zal enkel de laatste gebruikt worden.
|
|
<DL COMPACT>
|
|
<DT id="39"><B>--skip-debianization</B><DD>
|
|
Slaat het toepassen van de debian diff bovenop de broncode van de
|
|
toeleveraar over (sinds dpkg 1.15.1).
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H3>Indeling: 2.0</H3>
|
|
|
|
Extraheren wordt sinds dpkg 1.13.9 ondersteund, bouwen sinds dpkg
|
|
1.14.8. Ook gekend als wig&pen. Deze indeling wordt niet aangeraden voor
|
|
massaal gebruik, de indeling "3.0 (quilt)" vervangt ze. Wig&pen was de
|
|
eerste specificatie van een broncodepakketindeling van de nieuwe generatie.
|
|
<P>
|
|
Het gedrag van deze indeling is hetzelfde als bij de indeling "3.0 (quilt)",
|
|
behalve dat het geen gebruik maakt van een expliciete lijst van
|
|
patches. Alle bestanden in <B>debian/patches/</B> die beantwoorden aan de
|
|
reguliere expressie <B>[\w-]+</B> moeten geldige patches zijn: zij worden op
|
|
het moment van extraheren toegepast.
|
|
<P>
|
|
Bij het bouwen van een nieuw broncodepakket worden eventuele wijzigingen aan
|
|
de broncode van de toeleveraar opgeslagen in een patch met als naam
|
|
<B>zz_debian-diff-auto</B>.
|
|
<A NAME="lbAL"> </A>
|
|
<H3>Indeling: 3.0 (native) (d.w.z. debian-eigen)</H3>
|
|
|
|
Wordt ondersteund sinds dpkg 1.14.17. Deze indeling is een uitbreiding van
|
|
de native pakketindeling, zoals gedefinieerd in de indeling 1.0. Ze
|
|
ondersteunt alle compressiemethodes en negeert standaard eventuele
|
|
VCS-specifieke bestanden en mappen (bestanden en mappen die verband houden
|
|
met het versiebeheersysteem) evenals vele tijdelijke bestanden (zie de
|
|
uitvoer van de optie <B>--help</B> voor de standaardwaarde van de optie <B>-I</B>).
|
|
<A NAME="lbAM"> </A>
|
|
<H3>Indeling: 3.0 (quilt)</H3>
|
|
|
|
Wordt ondersteund sinds dpkg 1.14.17. Een broncodepakket volgens deze
|
|
indeling bevat minstens een origineel tar-archief (<B>.orig.tar.</B><I>ext</I>
|
|
waarbij <I>ext</I> <B>gz</B>, <B>bz2</B>, <B>lzma</B> en <B>xz</B> kan zijn) en een debian
|
|
tar-archief (<B>.debian.tar.</B><I>ext</I>). Het kan ook bijkomende originele
|
|
tar-archieven bevatten (<B>.orig-</B><I>component</I><B>.tar.</B><I>ext</I>). <I>component</I>
|
|
mag enkel alfanumerieke tekens ('a-zA-Z0-9') en koppeltekens ('-')
|
|
bevatten. Optioneel mag bij elk origineel tar-archief een afzonderlijke
|
|
handtekening van de toeleveraar (<B>.orig.tar.</B><I>ext</I><B>.asc</B> en
|
|
<B>.orig-</B><I>component</I><B>.tar.</B><I>ext</I><B>.asc</B>), gevoegd worden. De extractie
|
|
ervan wordt ondersteund sinds dpkg 1.17.20 en het bouwen sinds dpkg 1.18.5.
|
|
<P>
|
|
<P>
|
|
|
|
<B>Extraheren</B>
|
|
<P>
|
|
|
|
Eerst wordt het belangrijkste originele tar-archief uitgepakt en nadien
|
|
worden alle bijkomende originele tar-archieven uitgepakt in onderliggende
|
|
mappen die genoemd worden naar het <I>component</I>-gedeelte van hun
|
|
bestandsnaam (een eventuele reeds bestaande map wordt vervangen). Het debian
|
|
tar-archief wordt bovenop de broncodemap geëxtraheerd nadat eerst een
|
|
eventuele reeds bestaande <B>debian</B>-map verwijderd werd. Merk op dat het
|
|
debian tar-archief een onderliggende map <B>debian</B> moet bevatten, maar dat
|
|
het ook binaire bestanden kan bevatten buiten die map (zie de optie
|
|
<B>--include-binaries</B>).
|
|
<P>
|
|
|
|
Vervolgens worden alle patches toegepast die vermeld zijn in
|
|
<B>debian/patches/</B><I>leverancier</I><B>.series</B> of <B>debian/patches/series</B>,
|
|
waarbij <I>leverancier</I> de naam is in kleine letters van de huidige
|
|
leverancier, of <B>debian</B> als geen leverancier gedefinieerd is. Indien het
|
|
eerste bestand gebruikt wordt en het laatste niet bestaat (of een
|
|
symbolische koppeling is), dan zal het laatste vervangen worden door een
|
|
symbolische koppeling naar het eerste. Dit is bedoeld om het gebruik van
|
|
<B>quilt</B> bij het beheer van het geheel van patches te
|
|
vereenvoudigen. Leveranciersspecifieke series-bestanden hebben tot doel het
|
|
serialiseren van meerdere leveranciersgebonden ontwikkelingstakken op een
|
|
declaratieve manier mogelijk te maken, wat verkieslijker is boven een open
|
|
codering van deze manipulatie in <B>debian/rules</B>. Dit is in het bijzonder
|
|
nuttig wanneer de broncode voorwaardelijk gepatched moet worden omdat de
|
|
betrokken bestanden geen ingebouwde ondersteuning hebben voor conditionele
|
|
occlusie. Merk nochtans op dat hoewel <B>dpkg-source</B> op correcte wijze de
|
|
ontleding uitvoert van series-bestanden met expliciete opties die gebruikt
|
|
worden voor het toepassen van patches (op elke regel opgeslagen na de
|
|
bestandsnaam van de patch en één of meer spaties), het deze opties negeert
|
|
en steeds patches verwacht die kunnen toegepast worden met de optie <B>-p1</B>
|
|
van <B>patch</B>. Het zal dus een waarschuwing geven als het dergelijke opties
|
|
tegenkomt en het bouwen zal waarschijnlijk mislukken.
|
|
<P>
|
|
|
|
Opmerking: indien leveranciers-series-bestanden gebruikt worden, geeft
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lintian">lintian</A></B>(1) onvoorwaardelijke waarschuwingen als gevolg van een
|
|
controversieel Debian-specifiek besluit. Extern gebruik zou hierdoor niet
|
|
getroffen mogen worden. Om dergelijke waarschuwingen het zwijgen op te
|
|
leggen kunt u het dpkg-profiel van lintian gebruiken door aan <B><A HREF="/cgi-bin/man/man2html?1+lintian">lintian</A></B>(1)
|
|
de optie «<B>--profile dpkg</B>» mee te geven.
|
|
<P>
|
|
|
|
Voor alle bestanden waarop een patch toegepast werd, wordt de
|
|
tijdsaanduiding teruggezet op het tijdstip van extraheren van het
|
|
broncodepakket (dit vermijdt scheeftrekkingen van de tijdsaanduiding hetgeen
|
|
tot problemen kan leiden wanneer automatisch gegenereerde bestanden gepatcht
|
|
worden).
|
|
<P>
|
|
|
|
In tegenstelling tot het standaardgedrag van <B>quilt</B> wordt verwacht dat
|
|
patches zonder gedoe toegepast kunnen worden. Indien dat niet het geval is,
|
|
zou u de patches moeten verversen met <B>quilt</B>, anders zal <B>dpkg-source</B>
|
|
met een foutmelding afbreken terwijl het probeert ze toe te passen.
|
|
<P>
|
|
|
|
Analoog aan het standaardgedrag van <B>quilt</B> kunnen patches ook bestanden
|
|
verwijderen.
|
|
<P>
|
|
|
|
Als tijdens het extraheren patches werden toegepast, wordt het bestand
|
|
<B>.pc/applied-patches</B> aangemaakt.
|
|
<P>
|
|
|
|
<B>Bouwen</B>
|
|
<P>
|
|
|
|
Alle originele tar-archieven die in de huidige map gevonden worden, worden
|
|
geëxtraheerd in een tijdelijke map en daarbij wordt dezelfde logica gevolgd
|
|
als bij het uitpakken. De debian-map wordt naar de tijdelijke map gekopieerd
|
|
en alle patches worden toegepast, behalve de automatische patch
|
|
(<B>debian-changes-</B><I>versie</I> of <B>debian-changes</B>, afhankelijk van
|
|
<B>--single-debian-patch</B>). De tijdelijke map wordt vergeleken met de map van
|
|
het broncodepakket. Indien de diff niet leeg is, zal het bouwen mislukken,
|
|
tenzij <B>--single-debian-patch</B> of <B>--auto-commit</B> gebruikt werden en in
|
|
dat geval wordt de diff opgeslagen in de automatische patch. Indien de
|
|
automatische patch aangemaakt/verwijderd wordt, wordt hij toegevoegd
|
|
aan/verwijderd van het bestand series en van de metadata van <B>quilt</B>.
|
|
<P>
|
|
Een eventuele wijziging aan een binair bestand kan niet weergegeven worden
|
|
in een diff en zal dus tot een mislukking leiden, tenzij de onderhouder
|
|
bewust besloot dat gewijzigd binair bestand toe te voegen aan het Debian
|
|
tar-archief (door het op te sommen in
|
|
<B>debian/source/include-binaries</B>). Het bouwen zal ook mislukken als er
|
|
binaire bestanden aangetroffen worden in de onderliggende map debian, tenzij
|
|
zij op de witte lijst gezet werden via <B>debian/source/include-binaries</B>.
|
|
<P>
|
|
De bijgewerkte map debian en de lijst van gewijzigde binaire bestanden wordt
|
|
dan gebruikt om het Debian tar-archief te genereren.
|
|
<P>
|
|
De automatisch gegenereerde diff bevat geen wijzigingen aan VCS-specifieke
|
|
bestanden (d.w.z. bestanden eigen aan het versiebeheersysteem) en aan veel
|
|
tijdelijke bestanden (kijk in de uitvoer van <B>--help</B> voor de
|
|
standaardwaarde die met de optie <B>-i</B>) verbonden is. In het bijzonder wordt
|
|
de map <B>.pc</B> die door <B>quilt</B> gebruikt wordt, genegeerd tijdens het
|
|
genereren van de automatische patch.
|
|
<P>
|
|
Opmerking: <B>dpkg-source</B> <B>--before-build</B> (en <B>--build</B>) zal ervoor
|
|
zorgen dat alle patches die in het bestand series opgesomd zijn, toegepast
|
|
worden, zodat bij het bouwen van een pakket steeds alle patches toegepast
|
|
zijn. Het doet dit door te zoeken naar niet-toegepaste patches (ze worden
|
|
opgesomd in het bestand <B>series</B> maar niet in <B>.pc/applied-patches</B>) en
|
|
indien de eerste patch uit die reeks foutloos toegepast kan worden, zal het
|
|
ze allemaal toepassen. De optie <B>--no-preparation</B> kan gebruikt worden om
|
|
dit gedrag uit te schakelen.
|
|
<P>
|
|
<P>
|
|
|
|
<B>Wijzigingen optekenen</B>
|
|
<DL COMPACT>
|
|
<DT id="40"><B>--commit</B> [<I>map</I>] [<I>patchnaam</I>] [<I>patchbestand</I>]<DD>
|
|
Genereert een patch in verband met de lokale wijzigingen die niet door het
|
|
patchsysteem van <B>quilt</B> beheerd worden en integreert die in het
|
|
patchsysteem onder de naam <I>patchnaam</I>. Indien de naam ontbreekt, zal er
|
|
interactief om gevraagd worden. Indien <I>patchbestand</I> opgegeven werd, wordt
|
|
dat gebruikt als de te integreren patch in verband met de lokale
|
|
wijzigingen. Na de integratie wordt een editor opgestart, zodat u de
|
|
meta-informatie in de koptekst van de patch kunt bewerken.
|
|
<P>
|
|
Een <I>patchbestand</I> opgeven is vooral nuttig na een mislukte bouwpoging die
|
|
dat bestand vooraf aanmaakte. Op grond daarvan wordt dat bestand na
|
|
integratie verwijderd. Merk ook op dat de wijzigingen die het patch-bestand
|
|
bevat, reeds toegepast moeten zijn op de boom en dat de bestanden die door
|
|
de patch aangepast werden geen bijkomende niet-opgetekende wijzigingen mogen
|
|
bevatten.
|
|
<P>
|
|
Indien het genereren van de patch gewijzigde binaire bestanden opmerkt,
|
|
zullen die automatisch toegevoegd worden aan
|
|
<B>debian/source/include-binaries</B>, zodat die terecht komen in het debian
|
|
tar-archief (exact op dezelfde manier als <B>dpkg-source --include-binaries
|
|
--build</B> zou doen).
|
|
</DL>
|
|
<P>
|
|
|
|
<B>Bouwopties</B>
|
|
<DL COMPACT>
|
|
<DT id="41"><B>--allow-version-of-quilt-db=</B><I>versie</I><DD>
|
|
Laat <B>dpkg-source</B> toe het broncodepakket te bouwen als de versie van de
|
|
metadata van <B>quilt</B> de opgegeven versie is, zelfs al kent <B>dpkg-source</B>
|
|
die niet (sinds dpkg 1.15.5.4). Dit zegt effectief dat de opgegeven versie
|
|
van de <B>quilt</B>-metadata compatibel is met versie 2 die momenteel door
|
|
<B>dpkg-source</B> ondersteund wordt. De versie van de metadata van <B>quilt</B>
|
|
wordt opgeslagen in <B>.pc/.version</B>.
|
|
<DT id="42"><B>--include-removal</B><DD>
|
|
Negeer verwijderde bestanden niet en neem ze op in de automatisch
|
|
gegenereerde patch.
|
|
<DT id="43"><B>--include-timestamp</B><DD>
|
|
Voeg de tijdsaanduiding toe in de automatisch gegenereerde patch.
|
|
<DT id="44"><B>--include-binaries</B><DD>
|
|
Voeg alle gewijzigde binaire bestanden toe aan het debian tar-archief. Voeg
|
|
ze ook toe in <B>debian/source/include-binaries</B>: in erop volgende
|
|
bouwactiviteiten zullen ze standaard toegevoegd worden en is deze optie dus
|
|
niet meer nodig.
|
|
<DT id="45"><B>--no-preparation</B><DD>
|
|
Tracht de bouwboom niet voor te bereiden door patches toe te passen die
|
|
blijkbaar niet toegepast zijn (sinds dpkg 1.14.18).
|
|
<DT id="46"><B>--single-debian-patch</B><DD>
|
|
Gebruik <B>debian/patches/debian-changes</B> in plaats van
|
|
<B>debian/patches/debian-changes-</B><I>versie</I> voor de naam van de tijdens het
|
|
bouwen automatisch gegenereerde patch (sinds dpkg 1.15.5.4). Deze optie is
|
|
in het bijzonder nuttig als het pakket wordt onderhouden in een VCS
|
|
(versiebeheersysteem) en een reeks patches niet op een betrouwbare manier
|
|
gegenereerd kan worden. De huidige verschillen (de diff) met de
|
|
toeleveraarsversie moeten dan eerder in een enkele patch opgeslagen
|
|
worden. Deze optie wordt geplaatst in <B>debian/source/local-options</B> en gaat
|
|
samen met een bestand <B>debian/source/local-patch-header</B> waarin uitgelegd
|
|
wordt hoe de door Debian aangebrachte wijzigingen best herzien kunnen
|
|
worden, bijvoorbeeld in het versiebeheersysteem dat gebruikt wordt.
|
|
<DT id="47"><B>--create-empty-orig</B><DD>
|
|
Creëer automatisch een leeg primair origineel tar-archief als dat ontbreekt
|
|
en er wel bijkomende originele tar-archieven zijn (sinds dpkg 1.15.6). Deze
|
|
optie is bedoeld om gebruikt te worden als het broncodepakket slechts een
|
|
bundel is van samengestelde toegeleverde software zonder een "centraal"
|
|
programma.
|
|
<DT id="48"><B>--no-unapply-patches, --unapply-patches</B><DD>
|
|
Standaard zal <B>dpkg-source</B> de patches uit de uitbreiding (hook)
|
|
<B>--after-build</B> automatisch terugdraaien als het die tijdens
|
|
<B>--before-build</B> heeft toegepast (<B>--unapply-patches</B> sinds dpkg 1.15.8,
|
|
<B>--no-unapply-patches</B> sinds dpkg 1.16.5). Deze opties laten u toe om het
|
|
proces van automatisch terugdraaien van patches uitdrukkelijk in of uit te
|
|
schakelen. Deze opties mogen enkel in <B>debian/source/local-options</B>
|
|
gebruikt worden, zodat alle gegenereerde broncodepakketten standaard
|
|
hetzelfde gedrag vertonen.
|
|
<DT id="49"><B>--abort-on-upstream-changes</B><DD>
|
|
Het proces mislukt als een automatische patch gegenereerd werd (sinds dpkg
|
|
1.15.8). Deze optie kan gebruikt worden om te verzekeren dat alle
|
|
wijzigingen terdege geregistreerd worden in aparte <B>quilt</B>-patches
|
|
vooraleer het broncodepakket gegenereerd wordt. Deze optie is niet
|
|
toegestaan in <B>debian/source/options</B>, maar mag gebruikt worden in
|
|
<B>debian/source/local-options</B>.
|
|
<DT id="50"><B>--auto-commit</B><DD>
|
|
Het proces mislukt niet als een automatische patch gegenereerd werd. In de
|
|
plaats daarvan wordt hij onmiddellijk opgetekend in het bestand series van
|
|
<B>quilt</B>.
|
|
<P>
|
|
</DL>
|
|
<P>
|
|
|
|
<B>Extractieopties</B>
|
|
<DL COMPACT>
|
|
<DT id="51"><B>--skip-debianization</B><DD>
|
|
Slaat het extraheren van het debian tar-archief bovenop de broncode van de
|
|
toeleveraar over (sinds dpkg 1.15.1).
|
|
<DT id="52"><B>--skip-patches</B><DD>
|
|
Pas op het einde van de extractie geen patches toe (sinds dpkg 1.14.18).
|
|
</DL>
|
|
<A NAME="lbAN"> </A>
|
|
<H3>Indeling: 3.0 (custom) (d.w.z. aangepast)</H3>
|
|
|
|
Ondersteund sinds dpkg 1.14.17. Deze indeling is bijzonder. Ze stelt
|
|
eigenlijk geen echte broncodepakketindeling voor, maar kan gebruikt worden
|
|
om broncodepakketten met arbitraire bestanden te maken.
|
|
<P>
|
|
|
|
<B>Bouwopties</B>
|
|
<P>
|
|
|
|
Alle argumenten die geen opties zijn, worden geïnterpreteerd als bestanden
|
|
die geïntegreerd moeten worden in het gegenereerde broncodepakket. Ze moeten
|
|
bestaan en zich bij voorkeur in de huidige map bevinden. Tenminste één
|
|
bestand moet opgegeven worden.
|
|
<DL COMPACT>
|
|
<DT id="53"><B>--target-format=</B><I>waarde</I><DD>
|
|
<B>Verplicht</B>. Definieert de echte indeling van het gegenereerde
|
|
broncodepakket. Het gegenereerde .dsc-bestand zal in het veld <B>Format</B> deze
|
|
waarde bevatten en niet "3.0 (custom)".
|
|
</DL>
|
|
<A NAME="lbAO"> </A>
|
|
<H3>Indeling: 3.0 (git)</H3>
|
|
|
|
Ondersteund sinds dpkg 1.14.17. Dit is een experimentele indeling.
|
|
<P>
|
|
|
|
Een broncodepakket volgens deze indeling bestaat uit een eenvoudige
|
|
bundeling van een git-depot <B>.git</B> die de broncode van het pakket bevat. Er
|
|
kan ook een bestand <B>.gitshallow</B> bestaan die de revisies vermeldt van een
|
|
git shallow clone (een summiere kloon van een git-depot).
|
|
<P>
|
|
|
|
<B>Extraheren</B>
|
|
<P>
|
|
|
|
De bundel wordt gekloond in de doelmap als een git-depot. Als er een bestand
|
|
gitshallow bestaat, wordt het als <I>.git/shallow</I> geïnstalleerd binnenin het
|
|
gekloonde git-depot.
|
|
<P>
|
|
|
|
Merk op dat standaard het nieuwe depot dezelfde tak zal binnengehaald hebben
|
|
die binnengehaald was in de originele broncode. (Meestal is dat "master",
|
|
maar dat kan om het even wat zijn). Eventuele andere takken zullen
|
|
beschikbaar zijn onder <I>remotes/origin/</I>.
|
|
<P>
|
|
|
|
<B>Bouwen</B>
|
|
<P>
|
|
|
|
Vooraleer voort te gaan, worden een aantal controles uitgevoerd om zeker te
|
|
zijn dat er geen niet-vastgelegde wijzigingen zijn die niet mogen genegeerd
|
|
worden.
|
|
<P>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+git-bundle">git-bundle</A></B>(1) wordt gebruikt om een bundel te genereren van het
|
|
git-depot. Standaard worden alle takken en tags uit het depot in de bundel
|
|
opgenomen.
|
|
<P>
|
|
|
|
<B>Bouwopties</B>
|
|
<DL COMPACT>
|
|
<DT id="54"><B>--git-ref=</B><I>ref</I><DD>
|
|
Laat toe om een git-referentie op te geven die in de bundel opgenomen moet
|
|
worden. Daar gebruik van maken schakelt het standaardgedrag om alle takken
|
|
en tags op te nemen uit. Kan meermaals vermeld worden. De <I>referentie</I> kan
|
|
de naam van een tak of een tag zijn die opgenomen moet worden. Het kan ook
|
|
een parameter zijn die doorgegeven kan worden aan
|
|
<B><A HREF="/cgi-bin/man/man2html?1+git-rev-list">git-rev-list</A></B>(1). Gebruik bijvoorbeeld <B>--git-ref=</B>master om enkel de
|
|
master-tak op te nemen. Om alle takken en tags, behalve de tak persoonlijk
|
|
op te nemen, gebruikt u <B>--git-ref=</B>--all <B>--git-ref=</B>^persoonlijk.
|
|
<DT id="55"><B>--git-depth=</B><I>aantal</I><DD>
|
|
Creëert een summiere (shallow) kloon met een geschiedenis die afgekapt werd
|
|
bij het opgegeven aantal revisies.
|
|
</DL>
|
|
<A NAME="lbAP"> </A>
|
|
<H3>Indeling: 3.0 (bzr)</H3>
|
|
|
|
Ondersteund sinds dpkg 1.14.17. Dit is een experimentele indeling. Ze
|
|
genereert één enkel tar-archief met daarin het bzr-depot.
|
|
<P>
|
|
|
|
<B>Extraheren</B>
|
|
<P>
|
|
|
|
Het tar-archief wordt uitgepakt en daarna wordt bzr gebruikt om een
|
|
werkkopie van de huidige tak te maken.
|
|
<P>
|
|
|
|
<B>Bouwen</B>
|
|
<P>
|
|
|
|
Vooraleer voort te gaan, worden een aantal controles uitgevoerd om zeker te
|
|
zijn dat er geen niet-vastgelegde wijzigingen zijn die niet mogen genegeerd
|
|
worden.
|
|
<P>
|
|
|
|
Daarna wordt het versiebeheerspecifieke deel van de broncodemap gekopieerd
|
|
naar een tijdelijke map. Vooraleer deze tijdelijke map in een tar-archief
|
|
ingepakt wordt, worden verschillende opruimtaken verricht om plaats te
|
|
winnen.
|
|
<A NAME="lbAQ"> </A>
|
|
<H2>DIAGNOSTIEK</H2>
|
|
|
|
<A NAME="lbAR"> </A>
|
|
<H3>geen broncode-indeling opgegeven in debian/source/format</H3>
|
|
|
|
Het bestand <B>debian/source/format</B> moet altijd bestaan en de gewenste
|
|
broncode-indeling aangeven. Met het oog op neerwaartse compatibiliteit wordt
|
|
indeling "1.0" verondersteld als het bestand niet bestaat, maar u zou hierop
|
|
niet moeten betrouwen: ergens in de toekomst zal <B>dpkg-source</B> aangepast
|
|
worden, zodat het zal mislukken als het bestand niet bestaat.
|
|
<P>
|
|
De verantwoording is dat indeling "1.0" niet langer de aanbevolen indeling
|
|
is. U zou gewoonlijk één van de recentere indelingen ("3.0 (quilt)", "3.0
|
|
(native)") moeten kiezen, maar <B>dpkg-source</B> zal dit niet automatisch voor
|
|
u doen. Indien u de oude indeling wilt blijven gebruiken, moet u dat
|
|
expliciet aangeven en "1.0" plaatsen in <B>debian/source/format</B>.
|
|
<A NAME="lbAS"> </A>
|
|
<H3>de diff wijzigt de volgende bestanden van de toeleveraar</H3>
|
|
|
|
Als u broncode-indeling "1.0" gebruikt, is het meestal geen goed idee om
|
|
rechtstreeks wijzigingen aan te brengen in bestanden van de toeleveraar,
|
|
vermits de wijzigingen verborgen en grotendeels niet-gedocumenteerd belanden
|
|
in het bestand .diff.gz. U zou uw wijzigingen dan beter opslaan als patches
|
|
in de map debian en ze dan op het ogenblik van het bouwen toepassen. Om deze
|
|
complexe werkwijze te vermijden, kunt u ook de indeling "3.0 (quilt)"
|
|
gebruiken, die dit geïntegreerd aanbiedt.
|
|
<A NAME="lbAT"> </A>
|
|
<H3>kan wijziging aan <I>bestand</I> niet representeren</H3>
|
|
|
|
Wijzigingen aan de broncode van de toeleveraar worden gewoonlijk met
|
|
patch-bestanden opgeslagen, maar niet alle wijzigingen kunnen met patches
|
|
gerepresenteerd worden, omdat die enkel de inhoud van gewone tekstbestanden
|
|
kunnen aanpassen. Indien u een bestand tracht te vervangen door iets van een
|
|
ander type (bijvoorbeeld een gewoon bestand vervangen door een symbolische
|
|
koppeling of een map), zult u deze foutmelding krijgen.
|
|
<A NAME="lbAU"> </A>
|
|
<H3>nieuw gecreëerd leeg bestand <I>bestand</I> zal niet gerepresenteerd worden in de diff</H3>
|
|
|
|
Lege bestanden kunnen niet met behulp van patch-bestanden aangemaakt
|
|
worden. Deze wijziging wordt dus niet geregistreerd in het broncodepakket en
|
|
u wordt daarover ingelicht.
|
|
<A NAME="lbAV"> </A>
|
|
<H3><I>toegangsrechten</I> uitvoerbare modus van <I>bestand</I> zullen niet gerepresenteerd worden in de diff</H3>
|
|
|
|
Patch-bestanden registreren geen toegangsrechten van bestanden en dus wordt
|
|
het feit dat een bestand uitvoerbaar is, niet in het broncodepakket
|
|
opgeslagen. Deze waarschuwing brengt dit feit in herinnering.
|
|
<A NAME="lbAW"> </A>
|
|
<H3><I>toegangsrechten</I> bijzondere modus van <I>bestand</I> zullen niet gerepresenteerd worden in de diff</H3>
|
|
|
|
Patch-bestanden registreren geen toegangsrechten van bestanden en dus worden
|
|
wijzigingen aan toegangsrechten niet opgeslagen in het broncodepakket. Deze
|
|
waarschuwing brengt dit feit in herinnering.
|
|
<A NAME="lbAX"> </A>
|
|
<H2>OMGEVING</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="56"><B>DPKG_COLORS</B><DD>
|
|
Stelt de kleurmodus in (sinds dpkg 1.18.5). Waarden die momenteel gebruikt
|
|
mogen worden zijn: <B>auto</B> (standaard), <B>always</B> en <B>never</B>.
|
|
<DT id="57"><B>DPKG_NLS</B><DD>
|
|
Indien dit ingesteld is, zal het gebruikt worden om te beslissen over het
|
|
activeren van moedertaalondersteuning, ook gekend als
|
|
internationaliseringsondersteuning (of i18n) (sinds dpkg 1.19.0). Geldige
|
|
waarden zijn: <B>0</B> and <B>1</B> (standaard).
|
|
<DT id="58"><B>SOURCE_DATE_EPOCH</B><DD>
|
|
Indien dit ingesteld werd, zal het gebruikt worden als de tijdsaanduiding
|
|
(timestamp) (in seconden sinds de epoch) om de mtime vast te zetten op de
|
|
items uit het <B><A HREF="/cgi-bin/man/man2html?5+tar">tar</A></B>(5)-bestand.
|
|
<DT id="59"><B>VISUAL</B><DD>
|
|
|
|
<B>EDITOR</B>
|
|
Gebruikt door de broncode-indelingmodules "2.0" en "3.0 (quilt)".
|
|
<DT id="60"><B>GIT_DIR</B><DD>
|
|
|
|
<B>GIT_INDEX_FILE</B>
|
|
|
|
<B>GIT_OBJECT_DIRECTORY</B>
|
|
|
|
<B>GIT_ALTERNATE_OBJECT_DIRECTORIES</B>
|
|
|
|
<B>GIT_WORK_TREE</B>
|
|
Gebruikt door de broncode-indelingmodules "3.0 (git)".
|
|
</DL>
|
|
<A NAME="lbAY"> </A>
|
|
<H2>BESTANDEN</H2>
|
|
|
|
<A NAME="lbAZ"> </A>
|
|
<H3>debian/source/format</H3>
|
|
|
|
Dit bestand bevat op één enkele regel de indeling die gebruikt moet worden
|
|
om het broncodepakket te bouwen (mogelijke indelingen werden hierboven
|
|
beschreven). Voorafgaande of nakomende witruimte is niet toegelaten.
|
|
<A NAME="lbBA"> </A>
|
|
<H3>debian/source/include-binaries</H3>
|
|
|
|
Dit bestand bevat een lijst van binaire bestanden (één per regel) die
|
|
opgenomen moeten worden in het debian tar-archief. Voorafgaande of nakomende
|
|
spaties worden gestript. Regels die beginnen met '<B>#</B>' zijn commentaar en
|
|
worden overgeslagen. Lege regels worden genegeerd.
|
|
<A NAME="lbBB"> </A>
|
|
<H3>debian/source/options</H3>
|
|
|
|
Dit bestand bevat een lijst met lange opties die automatisch voorgevoegd
|
|
moeten worden aan de reeks commandoregelopties die gebruikt worden bij het
|
|
inroepen van het commando <B>dpkg-source --build</B> of <B>dpkg-source
|
|
--print-format</B>. Opties zoals <B>--compression</B> en <B>--compression-level</B>
|
|
zijn zeer geschikt voor dit bestand.
|
|
<P>
|
|
|
|
Elke optie moet op een aparte regel geplaatst worden. Lege regels en regels
|
|
die beginnen met '<B>#</B>' worden genegeerd. De '<B>--</B>' vooraan moeten
|
|
weggelaten worden en korte opties zijn niet toegelaten. Facultatieve
|
|
witruimte rond het symbool '<B>=</B>' en facultatieve aanhalingstekens rond de
|
|
waarde zijn toegelaten. Hierna volgt een voorbeeld van een dergelijk
|
|
bestand:
|
|
<P>
|
|
|
|
<BR> # laat dpkg-source een bestand debian.tar.bz2 aanmaken met maximale compressie
|
|
<BR> compression = "bzip2"
|
|
<BR> compression-level = 9
|
|
<BR> # gebruik debian/patches/debian-changes als automatische patch
|
|
<BR> single-debian-patch
|
|
<BR> # negeer wijzigingen aan config.{sub,guess}
|
|
<BR> extend-diff-ignore = "(^|/)(config.sub|config.guess)$"
|
|
<P>
|
|
|
|
Opmerking: <B>--format</B>-opties worden niet aanvaard in dit bestand. U moet
|
|
daarvoor eerder <B>debian/source/format</B> gebruiken.
|
|
<A NAME="lbBC"> </A>
|
|
<H3>debian/source/local-options</H3>
|
|
|
|
Precies zoals <B>debian/source/options</B>, behalve dat het bestand niet
|
|
opgenomen wordt in het gegenereerde broncodepakket. Dit kan nuttig zijn om
|
|
een voorkeur op te slaan die eigen is aan de onderhouder of aan een bepaald
|
|
depot van een versiebeheersysteem waarin het pakket onderhouden wordt.
|
|
<A NAME="lbBD"> </A>
|
|
<H3>debian/source/local-patch-header en debian/source/patch-header</H3>
|
|
|
|
Vrij opgemaakte tekst die geplaatst wordt bovenaan de automatische patch die
|
|
gegenereerd wordt bij de indelingen "2.0" en "3.0
|
|
(quilt)". <B>local-patch-header</B> wordt niet toegevoegd aan het gegenereerde
|
|
broncodepakket, terwijl dat met <B>patch-header</B> wel het geval is.
|
|
<A NAME="lbBE"> </A>
|
|
<H3>debian/patches/<I>leverancier</I>.series</H3>
|
|
|
|
<A NAME="lbBF"> </A>
|
|
<H3>debian/patches/series</H3>
|
|
|
|
Dit bestand somt alle patches op die toegepast moeten worden (in de
|
|
opgegeven volgorde) bovenop het broncodepakket van de toeleveraar. Spaties
|
|
vooraan en achteraan worden weggehaald. <I>leverancier</I> is de naam in kleine
|
|
letters van de huidige leverancier of <B>debian</B> als geen leverancier
|
|
gedefinieerd werd. Indien het leveranciersspecifieke series-bestand niet
|
|
bestaat, zal het leveranciersloze series-bestand gebruikt worden. Regels die
|
|
beginnen met '<B>#</B>' zijn commentaar en worden overgeslagen. Lege regels
|
|
worden genegeerd. De overige regels beginnen met de bestandsnaam van een
|
|
patch (relatief ten opzichte van de map <B>debian/patches/</B>) tot aan de
|
|
eerste spatie of het einde van de regel. Facultatieve <B>quilt</B>-opties kunnen
|
|
daarna komen tot aan het einde van de regel of tot aan het eerste
|
|
'<B>#</B>'-teken dat voorafgegaan wordt door één of meer spaties (hetgeen het
|
|
begin van een commentaarstuk aangeeft dat doorloopt tot het einde van de
|
|
regel).
|
|
<A NAME="lbBG"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Het punt waarop de vervanging van velden plaats vindt, vergeleken met
|
|
bepaalde standaardinstellingen voor uitvoervelden, is eerder onduidelijk.
|
|
<A NAME="lbBH"> </A>
|
|
<H2>ZIE OOK</H2>
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-src-control">deb-src-control</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?5+deb-changelog">deb-changelog</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?5+dsc">dsc</A></B>(5).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="61"><A HREF="#lbAB">NAAM</A><DD>
|
|
<DT id="62"><A HREF="#lbAC">OVERZICHT</A><DD>
|
|
<DT id="63"><A HREF="#lbAD">BESCHRIJVING</A><DD>
|
|
<DT id="64"><A HREF="#lbAE">COMMANDO'S</A><DD>
|
|
<DT id="65"><A HREF="#lbAF">OPTIES</A><DD>
|
|
<DL>
|
|
<DT id="66"><A HREF="#lbAG">Generieke bouwopties</A><DD>
|
|
<DT id="67"><A HREF="#lbAH">Generieke extractieopties</A><DD>
|
|
</DL>
|
|
<DT id="68"><A HREF="#lbAI">INDELINGEN VAN BRONCODEPAKKETTEN</A><DD>
|
|
<DL>
|
|
<DT id="69"><A HREF="#lbAJ">Indeling: 1.0</A><DD>
|
|
<DT id="70"><A HREF="#lbAK">Indeling: 2.0</A><DD>
|
|
<DT id="71"><A HREF="#lbAL">Indeling: 3.0 (native) (d.w.z. debian-eigen)</A><DD>
|
|
<DT id="72"><A HREF="#lbAM">Indeling: 3.0 (quilt)</A><DD>
|
|
<DT id="73"><A HREF="#lbAN">Indeling: 3.0 (custom) (d.w.z. aangepast)</A><DD>
|
|
<DT id="74"><A HREF="#lbAO">Indeling: 3.0 (git)</A><DD>
|
|
<DT id="75"><A HREF="#lbAP">Indeling: 3.0 (bzr)</A><DD>
|
|
</DL>
|
|
<DT id="76"><A HREF="#lbAQ">DIAGNOSTIEK</A><DD>
|
|
<DL>
|
|
<DT id="77"><A HREF="#lbAR">geen broncode-indeling opgegeven in debian/source/format</A><DD>
|
|
<DT id="78"><A HREF="#lbAS">de diff wijzigt de volgende bestanden van de toeleveraar</A><DD>
|
|
<DT id="79"><A HREF="#lbAT">kan wijziging aan <I>bestand</I> niet representeren</A><DD>
|
|
<DT id="80"><A HREF="#lbAU">nieuw gecreëerd leeg bestand <I>bestand</I> zal niet gerepresenteerd worden in de diff</A><DD>
|
|
<DT id="81"><A HREF="#lbAV"><I>toegangsrechten</I> uitvoerbare modus van <I>bestand</I> zullen niet gerepresenteerd worden in de diff</A><DD>
|
|
<DT id="82"><A HREF="#lbAW"><I>toegangsrechten</I> bijzondere modus van <I>bestand</I> zullen niet gerepresenteerd worden in de diff</A><DD>
|
|
</DL>
|
|
<DT id="83"><A HREF="#lbAX">OMGEVING</A><DD>
|
|
<DT id="84"><A HREF="#lbAY">BESTANDEN</A><DD>
|
|
<DL>
|
|
<DT id="85"><A HREF="#lbAZ">debian/source/format</A><DD>
|
|
<DT id="86"><A HREF="#lbBA">debian/source/include-binaries</A><DD>
|
|
<DT id="87"><A HREF="#lbBB">debian/source/options</A><DD>
|
|
<DT id="88"><A HREF="#lbBC">debian/source/local-options</A><DD>
|
|
<DT id="89"><A HREF="#lbBD">debian/source/local-patch-header en debian/source/patch-header</A><DD>
|
|
<DT id="90"><A HREF="#lbBE">debian/patches/<I>leverancier</I>.series</A><DD>
|
|
<DT id="91"><A HREF="#lbBF">debian/patches/series</A><DD>
|
|
</DL>
|
|
<DT id="92"><A HREF="#lbBG">BUGS</A><DD>
|
|
<DT id="93"><A HREF="#lbBH">ZIE OOK</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:19 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|