959 lines
56 KiB
HTML
959 lines
56 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: suite dpkg (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>NOM</H2>
|
|
|
|
dpkg-source - Outil de manipulation des paquets sources Debian (.dsc).
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>dpkg-source</B> [<I>option</I>...] <I>commande</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>dpkg-source</B> empaquette ou dépaquette une archive source Debian.
|
|
<P>
|
|
Aucune de ces commandes ne permet la combinaison de plusieurs options en une
|
|
seule et elles ne permettent pas d'indiquer la valeur d'une option dans un
|
|
argument séparé.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>COMMANDES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-x </B>, <B>--extract</B> <I>nom-de-fichier</I>.dsc [<I>répertoire-de-sortie</I>]<DD>
|
|
Cette option sert à extraire un paquet source (<B>--extract</B> depuis
|
|
dpkg 1.17.14). Un seul argument sans option doit être donné : le nom du
|
|
fichier de contrôle des sources Debian (<B>.dsc</B>). Un deuxième argument sans
|
|
option peut également être donné pour indiquer le répertoire où extraire le
|
|
paquet source : ce répertoire ne doit pas déjà exister. Quand aucun
|
|
répertoire n'est indiqué, le paquet source est extrait dans un répertoire
|
|
<I>source</I>-<I>version</I> du répertoire courant.
|
|
<P>
|
|
<B>dpkg-source</B> lit, dans le fichier de contrôle, les noms des fichiers qui
|
|
composent le paquet source ; il suppose qu'ils sont dans le même répertoire
|
|
que le fichier <B>.dsc</B>.
|
|
<P>
|
|
Les fichiers extraits du paquet auront leurs propriétaires et permissions
|
|
définis à ceux attendus s'ils avaient été simplement créés. Les répertoires
|
|
et les fichiers exécutables auront une permission égale à 0777 et les
|
|
simples fichiers à 0666, les deux étant modifiées par le masque (umask) de
|
|
celui qui fait l'extraction. Si le répertoire parent est « setgid », les
|
|
répertoires extraits le seront aussi et tous les fichiers et répertoires
|
|
hériteront de sa propriété de groupe.
|
|
<P>
|
|
Si le paquet source utilise un format non standard (actuellement, cela
|
|
signifie tous les formats sauf le « 1.0 »), son nom sera enregistré dans
|
|
<B>debian/source/format</B> de sorte que la construction du paquet source
|
|
utilise le même format par défaut.
|
|
<P>
|
|
<DT id="2"><B>-b</B>, <B>--build</B> <I>répertoire</I> [<I>paramètres-dans-un-format-spécifique</I>]<DD>
|
|
Construit un paquet source (<B>--build</B> depuis dpkg 1.17.14). Le premier
|
|
argument sans option est pris comme nom du répertoire contenant
|
|
l'arborescence des sources debianisée (c'est-à-dire avec un sous-répertoire
|
|
debian et peut-être des modifications sur les fichiers d'origine). Selon le
|
|
format du paquet source utilisé pour construire le paquet, d'autres
|
|
paramètres peuvent être acceptés.
|
|
<P>
|
|
<B>dpkg-source</B> va construire le paquet source dans le premier format trouvé
|
|
dans la liste suivante : le(s) format(s) indiqué(s) avec le paramètre de la
|
|
ligne de commande <I>--format</I>, le format indiqué dans
|
|
<B>debian/source/format</B>, « 1.0 ». L'utilisation de « 1.0 » comme dernier
|
|
recours est obsolète et sera retirée dans le futur. Le format source devrait
|
|
toujours être indiqué dans <B>debian/source/format</B>. Voir la section
|
|
<B>FORMATS DE PAQUET SOURCE</B> pour une description plus détaillée des
|
|
différents formats de paquet source.
|
|
<P>
|
|
<DT id="3"><B>--print-format</B> <I>répertoire</I><DD>
|
|
Affiche le format source qui serait utilisé pour construire le paquet source
|
|
si <B>dpkg-source --build </B><I>répertoire</I> était utilisé (dans les mêmes
|
|
conditions et avec les mêmes options ; depuis dpkg 1.15.5).
|
|
<P>
|
|
<DT id="4"><B>--before-build</B> <I>répertoire</I><DD>
|
|
Exécute le point d'entrée correspondant du format de paquet source (depuis
|
|
dpkg 1.15.8). Ce point d'entrée doit être utilisé avant toute construction
|
|
du paquet (<B>dpkg-buildpackage</B> l'utilise très tôt, avant même
|
|
<B>debian/rules clean</B>). Cette commande est idempotente et peut être lancée
|
|
plusieurs fois. Tous les formats source ne mettent pas en œuvre ce
|
|
branchement et ceux qui le font préparent l'arborescence source pour la
|
|
construction, par exemple en garantissant que les correctifs Debian sont
|
|
appliqués.
|
|
<P>
|
|
<DT id="5"><B>--after-build</B> <I>répertoire</I><DD>
|
|
Exécute le point d'entrée correspondant du format de paquet source (depuis
|
|
dpkg 1.15.8). Ce point d'entrée doit être utilisé après toute construction
|
|
du paquet (<B>dpkg-buildpackage</B> l'utilise en dernier). Cette commande est
|
|
idempotente et peut être lancée plusieurs fois. Tous les formats source ne
|
|
mettent pas en œuvre ce branchement et ceux qui le font s'en servent pour
|
|
défaire ce qui a été fait par <B>--before-build</B>.
|
|
<P>
|
|
<DT id="6"><B>--commit</B> [<I>répertoire</I>] ...<DD>
|
|
Enregistre les modifications dans l'arborescence source décompressée dans
|
|
<I>répertoire</I> (depuis dpkg 1.16.1). Cette commande peut accepter des
|
|
paramètres supplémentaires selon le format source. Elle provoquera une
|
|
erreur pour les formats où cette opération n'a pas de signification.
|
|
<P>
|
|
<DT id="7"><B>-?</B>, <B>--help</B><DD>
|
|
Affiche un message d'aide puis quitte. Les options de construction et
|
|
d'extraction spécifiques au format peuvent être montrées avec l'option
|
|
<B>--format</B>.
|
|
<DT id="8"><B>--version</B><DD>
|
|
Affiche le numéro de version puis quitte.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Options de construction générique</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><B>-c</B><I>fichier-de-contrôle</I><DD>
|
|
Indique le principal fichier de contrôle des sources où trouver les
|
|
renseignements. Par défaut, c'est le fichier <B>debian/control</B>. Lorsqu'un
|
|
chemin relatif est fourni, on considère qu'il est relatif au répertoire le
|
|
plus élevé de l'arborescence source.
|
|
<DT id="10"><B>-l</B><I>fichier-des-changements</I><DD>
|
|
Indique le journal des modifications où trouver des renseignements. Par
|
|
défaut, c'est le fichier <B>debian/changelog</B>. Lorsqu'un chemin relatif est
|
|
fourni, on considère qu'il est relatif au répertoire le plus élevé de
|
|
l'arborescence source.
|
|
<DT id="11"><B>-F</B><I>format-du-fichier-des-changements</I><DD>
|
|
Indique le format du fichier des changements. Voir <B><A HREF="/cgi-bin/man/man2html?1+dpkg-parsechangelog">dpkg-parsechangelog</A></B>(1)
|
|
pour plus d'informations à propos des formats gérés.
|
|
<DT id="12"><B>--format=</B><I>valeur</I><DD>
|
|
Utilise le format indiqué pour la construction du paquet source (depuis
|
|
dpkg 1.14.17). Ce choix remplace le format indiqué dans
|
|
<B>debian/source/format</B>.
|
|
<DT id="13"><B>-V</B><I>nom</I><B>=</B><I>valeur</I><DD>
|
|
Fixe la valeur d'une variable de substitution. Consultez <B><A HREF="/cgi-bin/man/man2html?5+deb-substvars">deb-substvars</A></B>(5)
|
|
pour une discussion sur la valeur de substitution.
|
|
<DT id="14"><B>-T</B><I>fichier-substvars</I><DD>
|
|
Lit les variables de substitution dans <I>fichier-substvars</I> ; par défaut
|
|
aucun fichier n'est lu. Cette option peut être utilisée plusieurs fois pour
|
|
lire des variables de substitution depuis plusieurs fichiers (depuis
|
|
dpkg 1.15.6).
|
|
<DT id="15"><B>-D</B><I>champ</I><B>=</B><I>valeur</I><DD>
|
|
Remplace ou ajoute en sortie un champ dans le fichier de contrôle.
|
|
<DT id="16"><B>-U</B><I>champ</I><DD>
|
|
Supprime en sortie un champ dans le fichier de contrôle.
|
|
<DT id="17"><B>-Z</B><I>compression</I>, <B>--compression</B>=<I>compression</I><DD>
|
|
Spécifie le niveau de compression à utiliser pour les fichiers archive et
|
|
diff créés (<B>--compression</B> depuis dpkg 1.15.5). Notez que cette option ne
|
|
causera pas la recompression des archives existantes, cela ne concerne que
|
|
les nouveaux fichiers. Les valeurs acceptées sont les suivantes : <I>gzip</I>,
|
|
<I>bzip2</I>, <I>lzma</I> et <I>xz</I>. L'option par défaut est <I>xz</I> pour les
|
|
formats 2.0 et plus récents, et <I>gzip</I> pour le format 1.0. <I>xz</I> n'est géré
|
|
que depuis dpkg 1.15.5.
|
|
<DT id="18"><B>-z</B><I>niveau</I>, <B>--compression-level</B>=<I>niveau</I><DD>
|
|
Niveau de compression à utiliser (<B>--compression-level</B> depuis
|
|
dpkg 1.15.5). Comme avec <B>-Z</B> cela ne concerne que les fichiers
|
|
nouvellement créés. Les valeurs prises possibles sont les suivantes : <I>1</I> à
|
|
<I>9</I>, <I>best</I> et <I>fast</I>. La valeur par défaut est <I>9</I> pour gzip et bzip2,
|
|
<I>6</I> pour xz et lzma.
|
|
<DT id="19"><B>-i</B>[<I>expression-rationnelle</I>], <B>--diff-ignore</B>[=<I>expression-rationnelle</I>]<DD>
|
|
Il est possible de donner une expression rationnelle Perl pour filtrer les
|
|
fichiers qui doivent être éliminés de la liste des fichiers pour le « diff »
|
|
(<B>--diff-ignore</B> depuis dpkg 1.15.6). Cette liste est créée avec une
|
|
commande « find ». Si le fichier source en construction est un fichier
|
|
source de version 3 utilisant un système de suivi de versions, cette option
|
|
est utile pour ignorer les modifications non envoyées. Utiliser <B>-i</B><I>.*</I>
|
|
les ignorera toutes.
|
|
<P>
|
|
L'option <B>-i</B> active cette fonction avec une expression rationnelle par
|
|
défaut (en préservant toutes les modifications faites avec l'expression
|
|
rationnelle par défaut par une utilisation précédente de
|
|
<B>--extend-diff-ignore</B>) qui couvre les fichiers de contrôle des plus usuels
|
|
systèmes de gestion de version, les fichiers de sauvegarde, les fichiers
|
|
d'échange et les répertoires utilisés par Libtool. Il ne peut y avoir qu'une
|
|
seule expression rationnelle active ; avec de multiples options <B>-i</B>, seule
|
|
la dernière mentionnée sera prise en compte.
|
|
<P>
|
|
C'est très utile pour supprimer des fichiers qui sont inclus dans le diff,
|
|
par exemple, si vous maintenez un source avec un système de contrôle de
|
|
version et que voulez construire un paquet source sans inclure des fichiers
|
|
et répertoires additionnels qu'il contient généralement (par exemple CVS/,
|
|
.cvsignore, .svn/). L'expression rationnelle par défaut est déjà très
|
|
exhaustive, mais si avez besoin de la remplacer, veuillez noter que par
|
|
défaut, il sait vérifier n'importe quelle partie d'un chemin, donc si vous
|
|
voulez trouver le début d'un nom de fichier ou des noms de fichiers
|
|
complets, vous devrez fournir les caractères spéciaux vous-même (par exemple
|
|
« (^|/) », « ($|/) »).
|
|
<DT id="20"><B>--extend-diff-ignore</B>=<I>expression-rationnelle</I><DD>
|
|
L'expression rationnelle Perl indiquée complétera la valeur par défaut
|
|
utilisée par <B>--diff-ignore</B> et sa valeur courante si elle est définie
|
|
(depuis dpkg 1.15.6). Cela est effectué en concaténant
|
|
« <B>|</B><I>expression-rationnelle</I> » à la valeur existante. Cette option est
|
|
pratique dans <B>debian/source/options</B> pour exclure certains fichiers
|
|
auto-créés de la création automatique de correctifs.
|
|
<DT id="21"><B>-I</B>[<I>motif-fichier</I>], <B>--tar-ignore</B>[=<I>motif-fichier</I>]<DD>
|
|
Avec cette option, le fichier est passé à l'option <B>--exclude</B> de <B><A HREF="/cgi-bin/man/man2html?1+tar">tar</A></B>(1)
|
|
quand on veut créer un fichier .orig.tar ou .tar (<B>--tar-ignore</B> depuis
|
|
dpkg 1.15.6). Par exemple, <B>-I</B>CVS fera que tar sautera les répertoires du
|
|
CVS quand il doit créer un fichier .tar.gz. On peut répéter cette option
|
|
pour exclure à partir de plusieurs motifs.
|
|
<P>
|
|
<B>-I</B> ajoute par défaut des options <B>--exclude</B> qui élimineront les
|
|
fichiers et les répertoires de contrôles des systèmes les plus connus de
|
|
contrôle de version, les fichiers d'échange et de sauvegarde et les
|
|
répertoires utilisés par Libtool.
|
|
</DL>
|
|
<P>
|
|
|
|
<B>Note</B> : même si elles ont des rôles similaires, <B>-i</B> et <B>-I</B> ont une
|
|
syntaxe et une sémantique très différentes. <B>-i</B> ne peut être spécifié
|
|
qu'une fois et reçoit une expression rationnelle compatible avec le langage
|
|
Perl qui est appliquée sur chaque chemin relatif complet de chaque
|
|
fichier. <B>-I</B> peut être spécifié plusieurs fois et prend un motif de nom de
|
|
fichier avec les méta-caractères du shell. Le motif est appliqué au chemin
|
|
relatif complet mais aussi à chaque partie du chemin individuellement. La
|
|
sémantique exacte de l'option <B>--exclude</B> de tar est un peu compliquée,
|
|
voir <A HREF="https://www.gnu.org/software/tar/manuel/tar.html#wildcards">https://www.gnu.org/software/tar/manuel/tar.html#wildcards</A> pour une
|
|
documentation plus complète.
|
|
<P>
|
|
L'expression rationnelle et le motif par défaut pour les deux options
|
|
peuvent être trouvés dans la sortie de la commande <B>--help</B>.
|
|
<A NAME="lbAH"> </A>
|
|
<H3>Options d'extraction génériques</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="22"><B>--no-copy</B><DD>
|
|
Ne copie pas l'archive d'origine à côté de l'extraction du paquet source
|
|
(depuis dpkg 1.14.17).
|
|
<DT id="23"><B>--no-check</B><DD>
|
|
Ne vérifie pas les signatures et les sommes de contrôle avant de
|
|
dépaqueter(depuis dpkg 1.14.17).
|
|
<DT id="24"><B>--no-overwrite-dir</B><DD>
|
|
Ne pas remplacer le répertoire d'extraction s'il existe déjà (depuis
|
|
dpkg 1.18.8)
|
|
<DT id="25"><B>--require-valid-signature</B><DD>
|
|
Refuse de décompresser le paquet source s'il ne contient pas de signature
|
|
OpenPGP pouvant être vérifiée (depuis dpkg 1.15.0) soit avec le fichier de
|
|
clés <I>trustedkeys.gpg</I> de l'utilisateur, un des fichiers de clés propre à
|
|
un distributeur ou un des fichiers de clés officiels de Debian
|
|
(<I>/usr/share/keyrings/debian-keyring.gpg</I> et
|
|
<I>/usr/share/keyrings/debian-maintainers.gpg</I>).
|
|
<DT id="26"><B>--require-strong-checksums</B><DD>
|
|
Refuse de décompresser le paquet source s'il ne contient pas de somme de
|
|
contrôle robuste (depuis dpkg 1.18.7). Actuellement, <B>SHA-256</B> est le seul
|
|
type de somme de contrôle considéré comme robuste.
|
|
<DT id="27"><B>--ignore-bad-version</B><DD>
|
|
Transforme la vérification des mauvaises versions des paquets source en
|
|
avertissement non fatal (since dpkg 1.17.7). Cette option sera seulement
|
|
nécessaire quand on extrait des anciens paquets source avec des versions
|
|
cassées, pour préserver la compatibilité avec les versions précédentes.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FORMATS DE PAQUET SOURCE</H2>
|
|
|
|
Si vous ne savez pas quel format source utiliser, il est conseillé de
|
|
choisir soit « 3.0 (quilt) » soit « 3.0 (native) ». Voir
|
|
<A HREF="https://wiki.debian.org/Projects/DebSrc3.0">https://wiki.debian.org/Projects/DebSrc3.0</A> pour plus d'informations sur la
|
|
mise en œuvre de ces formats dans Debian.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>Format : 1.0</H3>
|
|
|
|
Un paquet source dans ce format se compose soit d'un <B>.orig.tar.gz</B> associé
|
|
à un <B>.diff.gz</B> ou un simple <B>.tar.gz</B> (dans ce cas, le paquet est appelé
|
|
natif <I>native</I>). L'archive tar originale pourrait être accompagnée de façon
|
|
facultative d'une signature amont séparée <B>.orig.tar.gz.asc</B>, extraction
|
|
prise en charge depuis dpkg 1.18.5.
|
|
<P>
|
|
<B>Extraction</B>
|
|
<P>
|
|
Extraire un paquet natif revient à une simple extraction de l'archive tar
|
|
dans le répertoire cible. L'extraction d'un paquet non natif consiste au
|
|
dépaquetage du <B>.orig.tar.gz</B> puis l'application des correctifs contenus
|
|
dans le <B>.diff.gz</B>. La date de tous les fichiers correctifs est réglée à
|
|
celle du moment de l'extraction depuis le paquet source (cela évite les
|
|
horodatages faux menant à des problèmes lorsque des fichiers générés
|
|
automatiquement sont modifiés). Le diff peut créer de nouveaux fichiers
|
|
(tout le répertoire debian est créé de cette façon) mais ne peut pas
|
|
supprimer de fichiers (les fichiers vides seront laissés là).
|
|
<P>
|
|
<B>Construction</B>
|
|
<P>
|
|
Construire un paquet natif revient simplement à créer une archive tar avec
|
|
le répertoire du source. La création d'un paquet non natif consiste à
|
|
extraire l'archive d'origine dans un répertoire séparé « .orig » puis à
|
|
régénérer le <B>.diff.gz</B> en comparant le <I>répertoire</I> du paquet source avec
|
|
le répertoire « .orig ».
|
|
<P>
|
|
<B>Options de construction (avec --build)</B> :
|
|
<P>
|
|
Si l'on donne un second argument, ce sera le nom du répertoire source
|
|
d'origine ou le nom du fichier tar ou bien une chaîne vide si le paquet est
|
|
un « Debian pure souche » et n'a donc pas de fichiers « diffs » pour sa
|
|
« debianisation ». S'il n'y a pas de second argument, <B>dpkg-source</B> cherche
|
|
le fichier tar des sources d'origine
|
|
<I>paquet</I><B>_</B><I>version-amont</I><B>.orig.tar.gz</B> ou bien le répertoire source
|
|
d'origine <I>répertoire</I><B>.orig</B> selon les paramètres <B>-sX</B>.
|
|
<P>
|
|
Les options <B>-sa</B>, <B>-sp</B>, <B>-sk</B>, <B>-su</B> et <B>-sr</B> ne remplacent pas les
|
|
fichiers tar ou les répertoires existants. Pour cela, il faut utiliser les
|
|
options <B>-sA</B>, <B>-sP</B>, <B>-sK</B>, <B>-sU</B> et <B>-sR.</B>
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="28"><B>-sk</B><DD>
|
|
Spécifie que le source d'origine est attendu sous forme tar ; par défaut,
|
|
<I>paquet</I><B>_</B><I>version-amont</I><B>.orig.tar</B><I>extension</I>. Il le laisse en place
|
|
en tant que fichier tar ou le copie dans le répertoire en cours s'il n'y est
|
|
pas déjà. Le fichier sera dépaqueté dans <I>répertoire</I><B>.orig</B> pour la
|
|
génération du fichier diff.
|
|
<DT id="29"><B>-sp</B><DD>
|
|
Comme <B>-sk</B> mais supprimera le répertoire à nouveau par la suite.
|
|
<DT id="30"><B>-su</B><DD>
|
|
Quand on spécifie que le source d'origine est un répertoire ; la valeur par
|
|
défaut est le répertoire <I>paquet</I><B>-</B><I>version-amont</I><B>.orig</B> et
|
|
<B>dpkg-source</B> crée une nouvelle archive du source d'origine.
|
|
<DT id="31"><B>-sr</B><DD>
|
|
Comme <B>-su</B> mais supprimera ce répertoire après utilisation.
|
|
<DT id="32"><B>-ss</B><DD>
|
|
Indique que le source d'origine est disponible à la fois comme un répertoire
|
|
et comme un fichier tar. <B>dpkg-source</B> se servira du répertoire pour créer
|
|
le « diff », mais du fichier tar pour créer le fichier <B>.dsc</B>. Aussi, faire
|
|
attention avec cette option. Si le répertoire et le fichier tar ne
|
|
correspondent pas, il en résulte une mauvaise archive source.
|
|
<DT id="33"><B>-sn</B><DD>
|
|
Indique de ne pas chercher de source d'origine et de ne pas créer de
|
|
« diff ». Le second argument, s'il existe, doit être une chaîne vide. Cela
|
|
sert pour les paquets Debian pure souche qui n'ont pas un source d'origine
|
|
distincte et donc pas de fichier « diff » de debianisation.
|
|
<DT id="34"><B>-sa</B> or <B>-sA</B><DD>
|
|
Indique comme source d'origine soit un fichier tar, soit un répertoire --- le
|
|
deuxième argument, s'il existe, doit être l'un d'eux ou bien une chaîne vide
|
|
(cela revient à utiliser l'option <B>-sn)</B>. Quand un fichier tar existe, il
|
|
est dépaqueté pour créer le fichier « diff » ; ensuite il est supprimé (cela
|
|
revient à utiliser l'option <B>-sp)</B> ; quand un répertoire est trouvé, il est
|
|
empaqueté et <B>dpkg-source</B> crée le source d'origine et supprime ensuite ce
|
|
répertoire (cela revient à utiliser l'option <B>-sr)</B> ; quand ni l'un ni
|
|
l'autre n'est trouvé, <B>dpkg-source</B> suppose que le paquet ne possède pas de
|
|
fichier « diff » de debianisation, mais seulement une simple archive source
|
|
(cela revient à utiliser l'option <B>-sn</B>). Quand les deux sont trouvés,
|
|
<B>dpkg-source</B> ignore le répertoire et le remplace si l'option <B>-sA</B> a été
|
|
spécifiée (cela revient à utiliser l'option <B>-sP)</B> ou il provoque une
|
|
erreur si l'option <B>-sa</B> a été spécifiée. L'option par défaut est <B>-sa</B>.
|
|
<DT id="35"><B>--abort-on-upstream-changes</B><DD>
|
|
Ce processus échoue si le fichier de différences contient des modifications
|
|
apportées à des fichiers en dehors du sous-répertoire debian (depuis
|
|
dpkg 1.15.8). Cette option n'est pas autorisée dans <B>debian/source/options</B>
|
|
mais peut être utilisée dans <B>debian/source/local-options</B>.
|
|
</DL>
|
|
<P>
|
|
|
|
<P>
|
|
<B>options d'extraction (avec --extract)</B> :
|
|
<P>
|
|
Dans tous ces cas, l'arborescence existante des sources d'origine est
|
|
supprimée.
|
|
<DL COMPACT>
|
|
<DT id="36"><B>-sp</B><DD>
|
|
Quand on extrait le répertoire source d'origine (s'il existe), il est
|
|
conservé en tant que fichier tar. S'il n'est pas déjà dans le répertoire
|
|
courant ou si ce répertoire contient un fichier différent, le fichier tar
|
|
est copié dans ce répertoire. (<B>Cela est le comportement par défaut</B>).
|
|
<DT id="37"><B>-su</B><DD>
|
|
Dépaquetage de l'arborescence du répertoire source d'origine.
|
|
<DT id="38"><B>-sn</B><DD>
|
|
Assure que le répertoire source d'origine ne sera ni copié dans le
|
|
répertoire en cours, ni dépaqueté. Si une arborescence source d'origine est
|
|
présente dans le répertoire courant, elle est toujours supprimée.
|
|
</DL>
|
|
<P>
|
|
|
|
Toutes les options <B>-s</B><I>X</I> s'excluent mutuellement. Si vous en indiquez
|
|
plusieurs, seule la dernière sera prise en compte.
|
|
<DL COMPACT>
|
|
<DT id="39"><B>--skip-debianization</B><DD>
|
|
Passe l'étape d'application du fichier de différences Debian aux sources
|
|
amont (depuis dpkg 1.15.1).
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H3>Format : 2.0</H3>
|
|
|
|
Extraction prise en charge depuis dpkg 1.13.9, construction depuis
|
|
dpkg 1.14.8. Aussi connu sous le nom de « wig&pen ». Ce format n'est pas
|
|
recommandé pour une utilisation massive, le format « 3.0 (quilt) » le
|
|
remplace. Wig&pen a été la première spécification d'une nouvelle génération
|
|
de format de paquet source.
|
|
<P>
|
|
Le comportement de ce format est le même que pour le format « 3.0 (quilt) »
|
|
sauf qu'il n'utilise pas de liste explicite de correctifs. Tous les fichiers
|
|
dans <B>debian/patches/</B> correspondant à l'expression rationnelle Perl
|
|
<B>[\w-]+</B> doivent être des correctifs valables : ils sont appliqués au
|
|
moment de l'extraction.
|
|
<P>
|
|
Lors de la construction d'un nouveau paquet source, toute modification
|
|
apportée au source amont est enregistrée dans un correctif nommé
|
|
<B>zz_debian-diff-auto</B>.
|
|
<A NAME="lbAL"> </A>
|
|
<H3>Format : 3.0 (native)</H3>
|
|
|
|
Pris en charge depuis dpkg 1.14.17. Ce format est une extension du format de
|
|
paquet natif tel que défini dans le format 1.0. Il gère toutes les méthodes
|
|
de compression et ignore par défaut tout fichier et répertoire spécifique à
|
|
VCS ainsi que de nombreux fichiers temporaires (voir la valeur par défaut
|
|
associée à l'option <B>-I</B> dans la sortie de <B>--help</B>).
|
|
<A NAME="lbAM"> </A>
|
|
<H3>Format : 3.0 (quilt)</H3>
|
|
|
|
Pris en charge depuis 1.14.17. Un paquet source dans ce format contient au
|
|
moins une archive tar d'origine (<B>.orig.tar.</B><I>ext</I> où <I>ext</I> peut être
|
|
<B>gz</B>, <B>bz2</B> <B>lzma</B> et <B>xz</B>) et une archive tar debian
|
|
(<B>.debian.tar.</B><I>ext</I>). Il peut également contenir d'autres archives tar
|
|
d'origine (<B>.orig-</B><I>composant</I><B>.tar.</B><I>ext</I>). <I>composant</I> ne peut être
|
|
constitué que de caractères alphanumériques (« a-zA-Z0-9 ») et de tirets
|
|
(« - »). Chaque archive tar originale peut être accompagnée de façon
|
|
facultative d'une signature amont séparée (<B>.orig.tar.</B><I>ext</I><B>.asc</B> et
|
|
<B>.orig-</B><I>composant</I><B>.tar.</B><I>ext</I><B>.asc</B>), extraction prise en charge
|
|
depuis dpkg 1.17.20, construction depuis dpkg 1.18.5.
|
|
<P>
|
|
<P>
|
|
|
|
<B>Extraction</B>
|
|
<P>
|
|
|
|
L'archive principale tar d'origine est extraite tout d'abord, puis toutes
|
|
les autres archives tar d'origine sont extraites dans des sous-répertoires
|
|
dont le nom est formé à partir de la partie <I>composant</I> de leur
|
|
nom. L'archive tar Debian est extraite du répertoire source, après la
|
|
suppression de tout répertoire <B>debian</B> existant. Notez que l'archive tar
|
|
Debian doit contenir un sous-répertoire <B>debian</B>, mais elle peut également
|
|
contenir des fichiers binaires en dehors de ce répertoire (voir l'option
|
|
<B>--include-binaries</B>).
|
|
<P>
|
|
|
|
Toutes les modifications figurant dans
|
|
<B>debian/patches/</B><I>distributeur</I><B>.series</B> ou <B>debian/patches/series</B> sont
|
|
alors appliquées, où <I>distributeur</I> sera le nom en minuscules du
|
|
distributeur actuel, ou Debian s'il n'y a pas de distributeur défini. Si
|
|
l'ancien fichier est utilisé et qu'il n'y en a pas de plus récent (ou si
|
|
c'est un lien symbolique), alors celui-ci est remplacé par un lien
|
|
symbolique vers l'ancien. Cette disposition vise à simplifier l'utilisation
|
|
de <B>quilt</B> pour gérer l'ensemble des correctifs. Les fichiers de séries
|
|
propres au distributeur sont destinés à permettre de sérialiser plusieurs
|
|
branches de développement en se basant sur le distributeur, d'une manière
|
|
déclarative, de préférence au codage ouvert de cette gestion dans
|
|
<B>debian/rules</B>. Cela est particulièrement utile quand le source à besoin de
|
|
correctifs de manière conditionnelle car les fichiers affectés n'ont pas de
|
|
gestion interne d'inclusion conditionnelle. Notez toutefois que si
|
|
<B>dpkg-source</B> analyse correctement les fichiers de séries avec les options
|
|
utilisées pour l'application du correctif (stockées sur chaque ligne après
|
|
le nom du correctif et une ou plusieurs espaces), il n'ignore pas ces
|
|
options et s'attendra toujours à ce que les correctifs puissent être
|
|
appliqués avec l'option <B>-p1</B> de <B>patch</B>. Il va donc émettre un
|
|
avertissement lorsqu'il rencontrera ces options, et la construction est
|
|
susceptible d'échouer.
|
|
<P>
|
|
|
|
Notez que <B><A HREF="/cgi-bin/man/man2html?1+lintian">lintian</A></B>(1) émettra des avertissements sans condition lors de
|
|
l'utilisation de séries de distributeur du fait d'une règle controversée
|
|
particulière de Debian qui ne devrait pas affecter une utilisation externe ;
|
|
pour les faire taire, le profil lintian de dpkg peut être utilisé en passant
|
|
l'option «<B>--profile dpkg</B>» à <B><A HREF="/cgi-bin/man/man2html?1+lintian">lintian</A></B>(1).
|
|
<P>
|
|
|
|
La date de tous les fichiers correctifs est celle du moment où se déroule
|
|
l'extraction du paquet source (cela évite les horodatages faux menant à des
|
|
problèmes lorsque des fichiers générés automatiquement sont modifiés).
|
|
<P>
|
|
|
|
Au contraire du comportement par défaut de <B>quilt</B>, les correctifs doivent
|
|
s'appliquer sans décalage (« fuzz »). Quand cela n'est pas le cas, il est
|
|
suggéré de les rafraîchir avec <B>quilt</B> sinon <B>dpkg-source</B> se terminera
|
|
avec une erreur en tentant de les appliquer.
|
|
<P>
|
|
|
|
Similaire au comportement par défaut de <B>quilt</B>, les modifications peuvent
|
|
aussi supprimer des fichiers.
|
|
<P>
|
|
|
|
Le fichier <B>.pc/applied-patches</B> est créé si certains correctifs ont été
|
|
appliqués au cours de l'extraction.
|
|
<P>
|
|
|
|
<B>Construction</B>
|
|
<P>
|
|
|
|
Les originaux de toutes les archives tar trouvées dans le répertoire courant
|
|
sont extraits dans un répertoire temporaire en suivant la même logique que
|
|
pour le dépaquetage, le répertoire debian est copié dans le répertoire
|
|
temporaire, et tous les correctifs excepté le correctif automatique
|
|
<B>debian-changes-</B><I>version</I> ou <B>debian-changes</B>, selon
|
|
<B>--single-debian-patch</B>) sont appliquées. Le répertoire temporaire est
|
|
comparé à celui du paquet source. Si le fichier de différences n'est pas
|
|
vide, la construction échoue à moins que <B>--single-debian-patch</B> ou
|
|
<B>--auto-commit</B> aient été utilisés, et dans ce cas le diff est stocké dans
|
|
le correctif automatique. Si le correctif automatique est créé ou supprimé,
|
|
il est ajouté ou supprimé dans le fichier « series » et les métadonnées de
|
|
<B>quilt</B>.
|
|
<P>
|
|
Tout changement dans un fichier binaire ne peut être indiqué dans le diff et
|
|
va déboucher sur un échec à moins que le responsable ne décide délibérément
|
|
d'inclure cette modification binaire dans l'archive tar Debian (en le
|
|
listant dans <B>debian/source/include-binaries</B>). La construction pourra
|
|
également échouer si des fichiers binaires sont trouvés dans le
|
|
sous-répertoire debian sans être indiqué dans la liste blanche de
|
|
<B>debian/source/include-binaries</B>.
|
|
<P>
|
|
Le répertoire debian mis à jour et la liste des binaires modifiés sont
|
|
ensuite utilisés pour recréer l'archive tar debian.
|
|
<P>
|
|
Le diff généré automatiquement n'inclut pas les changements spécifiques sur
|
|
les fichiers VCS ainsi sur que de nombreux fichiers temporaires (pour la
|
|
valeur par défaut associée à l'option <B>-i</B>, voir la sortie de
|
|
<B>--help</B>). En particulier, le répertoire <B>.pc</B> utilisé par <B>quilt</B> est
|
|
ignoré lors de la génération automatique du correctif.
|
|
<P>
|
|
Note : <B>dpkg-source</B> <B>--before-build</B> (et <B>--build</B>) prendront soin
|
|
d'appliquer les correctifs indiqués dans le fichier series afin qu'un paquet
|
|
soit toujours construit avec toutes les corrections appliquées. Pour
|
|
effectuer cette détection, il recherche la liste des correctifs non
|
|
appliqués (ils sont mentionnés dans le fichier <B>series</B> mais pas dans
|
|
<B>.pc/applied-patches</B>) et si le premier de cette liste peut être appliqué
|
|
sans erreur, il les applique tous. L'option <B>--no-preparation</B> peut être
|
|
utilisée pour désactiver ce comportement.
|
|
<P>
|
|
<P>
|
|
|
|
<B>Enregistrement des modifications</B>
|
|
<DL COMPACT>
|
|
<DT id="40"><B>--commit</B> [<I>répertoire</I>] [<I>nom-du-correctif</I>] [<I>fichier-de-correctif</I>]<DD>
|
|
Crée un correctif correspondant aux modifications locales non gérées par le
|
|
système de gestion de correctifs <B>quilt</B> et les intègre dans la liste des
|
|
correctifs sous le nom <I>nom-du-correctif</I>. Si le nom est omis, il sera
|
|
demandé interactivement. Si <I>fichier-de-correctifs</I> est indiqué, il est
|
|
utilisé comme fichier de modifications locales à intégrer. Une fois intégré,
|
|
un éditeur est lancé afin de permettre d'ajouter des méta-informations dans
|
|
l'en-tête du correctif.
|
|
<P>
|
|
Le fait de passer <I>fichier-de-correctifs</I> est essentiellement utile après
|
|
un échec de construction qui prégénère ce fichier. Sur ces bases, le fichier
|
|
est supprimé après intégration. Veuillez également noter que les
|
|
modifications contenues dans le fichier de correctifs doivent déjà être
|
|
appliquées dans l'arborescence et que les fichiers modifiés par le correctif
|
|
ne doivent pas comporter de modifications supplémentaires.
|
|
<P>
|
|
Si la création de correctif détecte des fichiers binaires modifiés, ils
|
|
seront ajoutés automatiquement à <B>debian/source/include-binaries</B> afin de
|
|
pouvoir être inclus dans l'archive debian (de façon analogue à ce que ferait
|
|
<B>dpkg-source --include-binaries --build</B>).
|
|
</DL>
|
|
<P>
|
|
|
|
<B>Options de construction</B>
|
|
<DL COMPACT>
|
|
<DT id="41"><B>--allow-version-of-quilt-db=</B><I>version</I><DD>
|
|
Autorise <B>dpkg-source</B> à construire le fichier si la version des
|
|
métadonnées de <B>quilt</B> est celle indiquée, même si <B>dpkg-source</B> n'en n'a
|
|
pas connaissance (depuis dpkg 1.15.5.4). En fait, cela indique que la
|
|
version indiquée des métadonnées de <B>quilt</B> est compatible avec la
|
|
version 2 que <B>dpkg-source</B> gère. La version des métadonnées de <B>quilt</B>
|
|
est conservée dans <B>.pc/.version</B>.
|
|
<DT id="42"><B>--include-removal</B><DD>
|
|
N'ignore pas les fichiers supprimés et les inclut dans le fichier de
|
|
modifications généré automatiquement.
|
|
<DT id="43"><B>--include-timestamp</B><DD>
|
|
Inclut la date dans le correctif généré automatiquement.
|
|
<DT id="44"><B>--include-binaries</B><DD>
|
|
Ajoute tous les binaires modifiés dans l'archive tar debian. Les ajoute
|
|
aussi à <B>debian/source/include-binaries</B> : elles seront ajoutées par défaut
|
|
dans les constructions suivantes aussi cette option n'est donc plus
|
|
nécessaire.
|
|
<DT id="45"><B>--no-preparation</B><DD>
|
|
N'essaye pas de préparer l'arbre de la construction en appliquant les
|
|
correctifs qui ne sont apparemment pas appliqués (depuis dpkg 1.14.8).
|
|
<DT id="46"><B>--single-debian-patch</B><DD>
|
|
Utilise <B>debian/patches/debian-changes</B> au lieu de
|
|
<B>debian/patches/debian-changes-</B><I>version</I> comme nom du correctif
|
|
automatique créé au cours de la construction (depuis dpkg 1.15.5.4). Cette
|
|
option est particulièrement pratique lorsque le paquet est géré avec un
|
|
outil de gestion de versions et qu'un jeu de correctifs ne peut être créé de
|
|
façon fiable. Dans ce cas, les différences avec la version amont doivent
|
|
être conservées dans un correctif unique. Cette option serait indiquée dans
|
|
<B>debian/source/local-options</B> et accompagnée par un fichier
|
|
<B>debian/source/local-patch-header</B> qui explique la meilleure méthode pour
|
|
revoir les corrections spécifiques à Debian, par exemple dans le
|
|
gestionnaire de versions utilisé.
|
|
<DT id="47"><B>--create-empty-orig</B><DD>
|
|
Crée automatiquement l'archive principale tar d'origine vide si elle est
|
|
manquante et qu'il existe des archives tar d'origine additionnelles (depuis
|
|
dpkg 1.15.6). Cette option peut être utilisée lorsque le paquet source est
|
|
une collection de différents sources amont et qu'il n'existe pas de logiciel
|
|
« principal ».
|
|
<DT id="48"><B>--no-unapply-patches, --unapply-patches</B><DD>
|
|
Par défaut, <B>dpkg-source</B> retire automatiquement les correctifs dans le
|
|
point d'entrée <B>--after-build</B> s'ils ont été appliqués pendant
|
|
<B>--before-build</B> (<B>--unapply-patches</B> depuis dpkg 1.15.8,
|
|
<B>--no-unapply-patches</B> depuis dpkg 1.16.5). Ces options permettent de
|
|
désactiver ou activer unilatéralement ce retrait des correctifs. Elles ne
|
|
sont permises que dans <B>debian/source/local-options</B> afin que tous les
|
|
paquets source créés aient le même comportement par défaut.
|
|
<DT id="49"><B>--abort-on-upstream-changes</B><DD>
|
|
Ce processus échouera si un correctif automatique a été créé (depuis
|
|
dpkg 1.15.8). Cette option peut servir à vérifier que toutes les
|
|
modifications ont été enregistrées correctement dans des correctifs <B>quilt</B>
|
|
distincts avant la construction du paquet source. Elle n'est pas autorisée
|
|
dans <B>debian/source/options</B> mais peut prendre place dans
|
|
<B>debian/source/local-options</B>.
|
|
<DT id="50"><B>--auto-commit</B><DD>
|
|
Pas d'échec du processus de construction si un correctif automatique a été
|
|
créé : il est enregistré automatiquement dans le fichier series de <B>quilt</B>.
|
|
<P>
|
|
</DL>
|
|
<P>
|
|
|
|
<B>Options d'extraction</B>
|
|
<DL COMPACT>
|
|
<DT id="51"><B>--skip-debianization</B><DD>
|
|
Passe l'étape d'extraction de l'archive tar debian des sources amont (depuis
|
|
dpkg 1.15.1).
|
|
<DT id="52"><B>--skip-patches</B><DD>
|
|
Ne pas appliquer des correctifs à la fin de l'extraction (depuis
|
|
dpkg 1.14.18).
|
|
</DL>
|
|
<A NAME="lbAN"> </A>
|
|
<H3>Format : 3.0 (custom)</H3>
|
|
|
|
Pris en charge depuis dpkg 1.14.17. Ce format est particulier. Il ne
|
|
représente pas un réel format de paquet source mais peut être utilisé pour
|
|
créer des paquets sources avec des fichiers arbitraires.
|
|
<P>
|
|
|
|
<B>Options de construction</B>
|
|
<P>
|
|
|
|
Tous les arguments qui ne sont pas des options sont pris pour des fichiers à
|
|
intégrer dans le paquet source généré. Ils doivent exister et être de
|
|
préférence dans le répertoire courant. Au moins un fichier doit être donné.
|
|
<DL COMPACT>
|
|
<DT id="53"><B>--target-format=</B><I>valeur</I><DD>
|
|
<B>Required</B>. Définit le format réel du paquet source généré. Le fichier
|
|
généré .dsc contiendra cette valeur dans son champ <B>format</B> et non « 3.0
|
|
(custom) ».
|
|
</DL>
|
|
<A NAME="lbAO"> </A>
|
|
<H3>Format : 3.0 (git)</H3>
|
|
|
|
Pris en charge depuis dpkg 1.14.17. Ce format est expérimental.
|
|
<P>
|
|
|
|
Un paquet source qui utilise ce format est constitué d'un seul ensemble d'un
|
|
dépôt git <B>.git</B> qui contient les sources du paquet. Il peut également
|
|
exister un fichier <I>.gitshallow</I> qui donne les révisions d'un clone git
|
|
« shallow ».
|
|
<P>
|
|
|
|
<B>Extraction</B>
|
|
<P>
|
|
|
|
Cet ensemble est cloné sous forme d'un dépôt git dans le répertoire
|
|
cible. S'il existe un fichier <I>.gitshallow</I>, il est installé en tant que
|
|
<I>.git/shallow</I> dans le dépôt git cloné.
|
|
<P>
|
|
|
|
Veuillez noter que, par défaut, le nouveau dépôt aura la même branche
|
|
récupérée que celle qui était récupérée dans les sources d'origine (souvent
|
|
« master » mais cela peut être tout à fait autre chose). Toutes les autres
|
|
branches seront disponibles sous <I>remotes/origin</I>.
|
|
<P>
|
|
|
|
<B>Construction</B>
|
|
<P>
|
|
|
|
Avant d'aller plus loin, quelques vérifications sont effectuées afin de
|
|
s'assurer qu'il n'existe aucun changement non ignoré non soumis.
|
|
<P>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+git-bundle">git-bundle</A></B>(1) permet de créer un ensemble à partir du dépôt git. Par
|
|
défaut, toutes les branches et étiquettes du dépôt sont incluses dans cet
|
|
ensemble.
|
|
<P>
|
|
|
|
<B>Options de construction</B>
|
|
<DL COMPACT>
|
|
<DT id="54"><B>--git-ref=</B><I>réf</I><DD>
|
|
Permet d'indiquer une référence git à inclure dans l'ensemble
|
|
git. L'utilisation de cette option désactive le comportement par défaut qui
|
|
est d'inclure toutes les branches et étiquettes. Cette option peut être
|
|
utilisée plusieurs fois. Le paramètre <I>réf</I> peut être le nom d'une branche
|
|
ou une étiquette à inclure. Il peut également être tout paramètre que l'on
|
|
peut passer à <B><A HREF="/cgi-bin/man/man2html?1+git-rev-list">git-rev-list</A></B>(1). Par exemple, pour n'inclure que la branche
|
|
« master », on peut utiliser <B>--git-ref=</B>master. Pour inclure toutes les
|
|
étiquettes et toutes les branches, sauf la branche privée, on peut utiliser
|
|
-<B>git-ref=</B>--all <B>-- git-ref=</B>^private.
|
|
<DT id="55"><B>--git-depth=</B><I>nombre</I><DD>
|
|
Crée un clone « shallow » dont l'historique est tronqué au nombre indiqué de
|
|
révisions.
|
|
</DL>
|
|
<A NAME="lbAP"> </A>
|
|
<H3>Format : 3.0 (bzr)</H3>
|
|
|
|
Pris en charge depuis dpkg 1.14.17. Ce format est expérimental. Il crée une
|
|
archive tar contenant le dépôt bzr correspondant.
|
|
<P>
|
|
|
|
<B>Extraction</B>
|
|
<P>
|
|
|
|
L'archive tar est décompressée puis bzr est utilisé afin de récupérer la
|
|
branche courante.
|
|
<P>
|
|
|
|
<B>Construction</B>
|
|
<P>
|
|
|
|
Avant d'aller plus loin, quelques vérifications sont effectuées afin de
|
|
s'assurer qu'il n'existe aucun changement non ignoré non soumis.
|
|
<P>
|
|
|
|
Ensuite, la partie spécifique du répertoire source du gestionnaire de
|
|
versions est copiée dans un répertoire temporaire. Avant que ce répertoire
|
|
temporaire ne soit empaqueté dans une archive tar, divers nettoyages sont
|
|
effectués pour économiser de l'espace.
|
|
<A NAME="lbAQ"> </A>
|
|
<H2>DIAGNOSTICS</H2>
|
|
|
|
<A NAME="lbAR"> </A>
|
|
<H3>aucun format source indiqué dans debian/source/format</H3>
|
|
|
|
Le fichier <B>debian/source/format</B> devrait toujours exister et indiquer le
|
|
format source souhaité. Pour préserver la compatibilité avec d'anciennes
|
|
versions, le format « 1.0 » est implicite quand le fichier n'existe pas. Il
|
|
est déconseillé de dépendre de ce comportement qui pourrait être modifié
|
|
dans de futures versions de <B>dpkg-source</B>, qui échoueront alors en
|
|
l'absence d'une mention explicite de format.
|
|
<P>
|
|
Cela est dû au fait que le format « 1.0 » n'est plus le format recommandé,
|
|
qu'il est conseillé de choisir un des formats les plus récents (« 3.0
|
|
(quilt) » ou « 3.0 (native) ») mais que dpkg-source ne le fera pas
|
|
automatiquement. Si vous souhaitez continuer à utiliser l'ancien format, il
|
|
est nécessaire d'être explicite et indiquer « 1.0 » dans
|
|
<B>debian/source/format</B>.
|
|
<A NAME="lbAS"> </A>
|
|
<H3>le fichier de différences modifie les fichiers amont suivants</H3>
|
|
|
|
Lors de l'utilisation du format source « 1.0 », il est déconseillé de
|
|
modifier directement les fichiers amont car les modifications restent alors
|
|
cachées et souvent non documentées dans le fichier diff.gz. Au contraire, il
|
|
est conseillé de conserver les modifications sous forme de correctifs dans
|
|
le répertoire debian et de les appliquer au moment de la construction. Pour
|
|
éviter ces opérations plus complexes, vous pouvez également choisir le
|
|
format « 3.0 (quilt) » qui permet ces opérations de manière native.
|
|
<A NAME="lbAT"> </A>
|
|
<H3>impossible d'identifier les changements de <I>fichier</I></H3>
|
|
|
|
Les modifications des sources amont sont en général conservées dans des
|
|
fichiers de correctifs mais certaines modifications ne peuvent être
|
|
représentées sous forme de tels fichiers qui ne peuvent modifier que des
|
|
fichiers texte. Si vous essayez de remplacer un fichier avec un objet d'un
|
|
type différent (par exemple remplacer un fichier par un lien ou un
|
|
répertoire), ce message d'erreur s'affichera.
|
|
<A NAME="lbAU"> </A>
|
|
<H3>le fichier <I>fichier</I>, nouvellement créé, ne sera pas représenté dans le fichier de différences</H3>
|
|
|
|
Les fichiers vides ne peuvent pas être créés avec des correctifs. En
|
|
conséquence, la modification n'est pas enregistrée dans le paquet source, ce
|
|
qui provoque cet avertissement.
|
|
<A NAME="lbAV"> </A>
|
|
<H3>le mode exécutable <I>permissions</I> de <I>fichier</I> ne sera pas représenté dans le fichier de différences</H3>
|
|
|
|
Les fichiers de correctifs n'enregistrent pas les permissions de fichiers
|
|
et, en conséquence, les permissions des exécutables ne sont pas enregistrées
|
|
dans le paquet source, ce qui provoque cet avertissement.
|
|
<A NAME="lbAW"> </A>
|
|
<H3>le mode spécial <I>permissions</I> de <I>fichier</I> ne sera pas représenté dans le fichier de différences</H3>
|
|
|
|
Les fichiers correctifs n'enregistrent pas les permissions de fichiers et,
|
|
en conséquence, les permissions modifiées ne sont pas enregistrées dans le
|
|
paquet source, ce qui provoque cet avertissement.
|
|
<A NAME="lbAX"> </A>
|
|
<H2>ENVIRONNEMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="56"><B>DPKG_COLORS</B><DD>
|
|
Définit le mode de couleur (depuis dpkg 1.18.5). Les valeurs actuellement
|
|
acceptées sont <B>auto</B> (par défaut), <B>always</B> et <B>never</B>.
|
|
<DT id="57"><B>DPKG_NLS</B><DD>
|
|
Si cette variable est définie, elle sera utilisée pour décider l'activation
|
|
de la prise en charge des langues (NLS - Native Language Support), connu
|
|
aussi comme la gestion de l'internationalisation (ou i18n) (depuis
|
|
dpkg 1.19.0). Les valeurs permises sont : <B>0</B> et <B>1</B> (par défaut).
|
|
<DT id="58"><B>SOURCE_DATE_EPOCH</B><DD>
|
|
Si cette option est utilisée, elle sera utilisée comme horodatage (en
|
|
seconde à partir de « l'epoch ») pour fixer le « mtime » dans les entrées du
|
|
fichier <B><A HREF="/cgi-bin/man/man2html?5+tar">tar</A></B>(5).
|
|
<DT id="59"><B>VISUAL</B><DD>
|
|
|
|
<B>EDITOR</B>
|
|
Utilisé par les modules de format source « 2.0 » et « 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>
|
|
Utilisés par les modules de format source « 3.0 (git) ».
|
|
</DL>
|
|
<A NAME="lbAY"> </A>
|
|
<H2>FICHIERS</H2>
|
|
|
|
<A NAME="lbAZ"> </A>
|
|
<H3>debian/source/format</H3>
|
|
|
|
Ce fichier contient sur une seule ligne le format à utiliser pour construire
|
|
le paquet source (les formats acceptés sont décrits plus haut). Il ne doit
|
|
pas contenir d'espace avant ou après l'indication du format.
|
|
<A NAME="lbBA"> </A>
|
|
<H3>debian/source/include-binaries</H3>
|
|
|
|
Ce fichier contient une liste de fichiers binaires (un par ligne) qui
|
|
doivent être inclus dans l'archive tar debian. Les espaces placées avant ou
|
|
après ces noms sont supprimées. Les lignes commençant par « <B>#</B> » sont des
|
|
commentaires et sont ignorées, ainsi que les lignes vides.
|
|
<A NAME="lbBB"> </A>
|
|
<H3>debian/source/options</H3>
|
|
|
|
Ce fichier contient la liste des options qui seront automatiquement ajoutées
|
|
au jeu d'options de ligne de commande lors de l'appel à <B>dpkg-source
|
|
--build</B> ou <B>dpkg-source --print-format</B>. Des options comme
|
|
<B>--compression</B> et <B>--compression-level</B> conviennent bien pour ce fichier.
|
|
<P>
|
|
|
|
Chaque option doit être placée sur une ligne distincte. Les lignes vides et
|
|
les lignes commençant par le caractère « <B>#</B> » sont ignorées. Les
|
|
caractères initiaux « <B>--</B> » doivent être retirés et les options courtes ne
|
|
peuvent pas être utilisées. Des espaces optionnelles sont autorisées autour
|
|
du symbole « <B>=</B> », ainsi que des guillemets optionnels autour de la valeur
|
|
d'une option donnée. Voici un exemple d'un tel fichier :
|
|
<P>
|
|
|
|
<BR> # autoriser dpkg-source à créer un fichier debian.tar.bz2 avec la
|
|
<BR> #compression maximale
|
|
<BR> compression = "bzip2"
|
|
<BR> compression-level = 9
|
|
<BR> # utiliser debian/patches/debian-changes comme correctif automatique
|
|
<BR> single-debian-patch
|
|
<BR> # ignorer les modifications dans config.{sub,guess}
|
|
<BR> extend-diff-ignore = "(^|/)(config.sub|config.guess)$"
|
|
<P>
|
|
|
|
Note : les options de <B>format</B> ne sont pas acceptées dans ce fichier. Vous
|
|
devriez utiliser <B>debian/source/format</B> à la place.
|
|
<A NAME="lbBC"> </A>
|
|
<H3>debian/source/local-options</H3>
|
|
|
|
Identique à <B>debian/source/options</B> mais n'est pas enregistré dans le
|
|
paquet source créé. Ce fichier peut être utile pour conserver une préférence
|
|
propre au responsable ou au dépôt de gestionnaire de versions où le paquet
|
|
source est géré.
|
|
<A NAME="lbBD"> </A>
|
|
<H3>debian/source/local-patch-header et debian/source/patch-header</H3>
|
|
|
|
Texte en format libre qui sera ajouté au début du correctif automatique créé
|
|
dans les formats « 2.0 » et « 3.0 (quilt) ». <B>local-patch-header</B> n'est pas
|
|
inclus dans le paquet source créé alors que <B>patch-header</B> l'est.
|
|
<A NAME="lbBE"> </A>
|
|
<H3>debian/patches/<I>distributeur</I>.series</H3>
|
|
|
|
<A NAME="lbBF"> </A>
|
|
<H3>debian/patches/series</H3>
|
|
|
|
Ce fichier comporte la liste de toutes les correctifs qui ont été appliqués
|
|
(dans l'ordre indiqué) aux sources amont. Les espaces situées avant et après
|
|
les noms sont ignorées. L'argument <I>distributeur</I> sera le nom en minuscules
|
|
du distributeur ou <B>debian</B> si aucun distributeur n'est défini. Si le
|
|
fichier de séries propre au distributeur n'existe pas, le fichier de séries
|
|
sans distributeur sera utilisé. Les lignes commençant par « <B>#</B> » sont des
|
|
commentaires et sont ignorées, ainsi que les lignes vides. Les autres lignes
|
|
débutent par le nom du fichier de correctifs (relatif au répertoire
|
|
<B>debian/patches/</B>) et se terminent à la première espace ou à la fin de la
|
|
ligne. Des options facultatives de <B>quilt</B> peuvent être ajoutées jusqu'à la
|
|
fin de la ligne ou jusqu'au premier caractère « <B>#</B> » précédé par une ou
|
|
plusieurs espaces (ce qui indique le début d'un commentaire se terminant à
|
|
la fin de la ligne).
|
|
<A NAME="lbBG"> </A>
|
|
<H2>BOGUES</H2>
|
|
|
|
Le moment où se déroule le remplacement d'un champ par rapport à certaines
|
|
déterminations de champ affichées sur la sortie standard est plutôt
|
|
embrouillé.
|
|
<A NAME="lbBH"> </A>
|
|
<H2>VOIR AUSSI</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).
|
|
<A NAME="lbBI"> </A>
|
|
<H2>TRADUCTION</H2>
|
|
|
|
Ariel VARDI <<A HREF="mailto:ariel.vardi@freesbee.fr">ariel.vardi@freesbee.fr</A>>, 2002.
|
|
Philippe Batailler, 2006.
|
|
Nicolas François, 2006.
|
|
Veuillez signaler toute erreur à <<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="61"><A HREF="#lbAB">NOM</A><DD>
|
|
<DT id="62"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="63"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="64"><A HREF="#lbAE">COMMANDES</A><DD>
|
|
<DT id="65"><A HREF="#lbAF">OPTIONS</A><DD>
|
|
<DL>
|
|
<DT id="66"><A HREF="#lbAG">Options de construction générique</A><DD>
|
|
<DT id="67"><A HREF="#lbAH">Options d'extraction génériques</A><DD>
|
|
</DL>
|
|
<DT id="68"><A HREF="#lbAI">FORMATS DE PAQUET SOURCE</A><DD>
|
|
<DL>
|
|
<DT id="69"><A HREF="#lbAJ">Format : 1.0</A><DD>
|
|
<DT id="70"><A HREF="#lbAK">Format : 2.0</A><DD>
|
|
<DT id="71"><A HREF="#lbAL">Format : 3.0 (native)</A><DD>
|
|
<DT id="72"><A HREF="#lbAM">Format : 3.0 (quilt)</A><DD>
|
|
<DT id="73"><A HREF="#lbAN">Format : 3.0 (custom)</A><DD>
|
|
<DT id="74"><A HREF="#lbAO">Format : 3.0 (git)</A><DD>
|
|
<DT id="75"><A HREF="#lbAP">Format : 3.0 (bzr)</A><DD>
|
|
</DL>
|
|
<DT id="76"><A HREF="#lbAQ">DIAGNOSTICS</A><DD>
|
|
<DL>
|
|
<DT id="77"><A HREF="#lbAR">aucun format source indiqué dans debian/source/format</A><DD>
|
|
<DT id="78"><A HREF="#lbAS">le fichier de différences modifie les fichiers amont suivants</A><DD>
|
|
<DT id="79"><A HREF="#lbAT">impossible d'identifier les changements de <I>fichier</I></A><DD>
|
|
<DT id="80"><A HREF="#lbAU">le fichier <I>fichier</I>, nouvellement créé, ne sera pas représenté dans le fichier de différences</A><DD>
|
|
<DT id="81"><A HREF="#lbAV">le mode exécutable <I>permissions</I> de <I>fichier</I> ne sera pas représenté dans le fichier de différences</A><DD>
|
|
<DT id="82"><A HREF="#lbAW">le mode spécial <I>permissions</I> de <I>fichier</I> ne sera pas représenté dans le fichier de différences</A><DD>
|
|
</DL>
|
|
<DT id="83"><A HREF="#lbAX">ENVIRONNEMENT</A><DD>
|
|
<DT id="84"><A HREF="#lbAY">FICHIERS</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 et debian/source/patch-header</A><DD>
|
|
<DT id="90"><A HREF="#lbBE">debian/patches/<I>distributeur</I>.series</A><DD>
|
|
<DT id="91"><A HREF="#lbBF">debian/patches/series</A><DD>
|
|
</DL>
|
|
<DT id="92"><A HREF="#lbBG">BOGUES</A><DD>
|
|
<DT id="93"><A HREF="#lbBH">VOIR AUSSI</A><DD>
|
|
<DT id="94"><A HREF="#lbBI">TRADUCTION</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:01 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|