4
4
.\" This file was generated with po4a. Translate the source file.
6
6
.\"*******************************************************************
7
.TH dpkg\-source 1 2009\-03\-09 "Projet Debian" "Utilitaires de dpkg"
7
.TH dpkg\-source 1 09\-03\-2009 "Projet Debian" "Utilitaires de dpkg"
9
9
dpkg\-source \- outil de manipulation des paquets sources Debian (.dsc).
56
56
\fBdpkg\-source\fP will build the source package with the first format that
57
57
works from this ordered list: the format(s) indicated with the \fI\-\-format\fP
58
58
command\-line option(s), the format indicated in \fBdebian/source/format\fP,
59
"1.0", "3.0 (native)". See below for an extensive description of various
60
source package formats.
59
"1.0", "3.0 (native)". See section \fBSOURCE PACKAGE FORMATS\fP for an
60
extensive description of the various source package formats.
63
63
\fB\-h\fP, \fB\-\-help\fP
86
86
classique \fBdebian\fP.
88
88
\fB\-\-format=\fP\fIvaleur\fP
89
Try first the given format for building the source package. If used multiple
90
times, they are tried in order. It does override any format given in
91
\fBdebian/source/format\fP.
89
Essaie d'abord le format indiqu� pour la construction du paquet source. Si
90
ce param�tre est donn� plusieurs fois, les formats sont essay�s
91
successivment dans l'ordre indiqu�. Ce choix ne remplace le format indiqu�
92
dans \fBdebian/source/format\fP.
93
94
\fB\-V\fP\fInom\fP\fB=\fP\fIvaleur\fP
94
95
Fixe la valeur d'une variable de substitution. Consultez \fBdeb\-substvars\fP(5)
95
96
pour une discussion sur la valeur de substitution.
97
98
\fB\-T\fP\fIfichier/substvars\fP
98
Read substitution variables in \fIsubstvarsfile\fP; the default is to not read
99
Lit les variables de substitution dans \fIfichier\-substvars\fP\ ; par d�faut
100
aucun fichier n'est lu.
101
102
\fB\-D\fP\fIchamp\fP\fB=\fP\fIvaleur\fP
102
103
Remplace ou ajoute en sortie un champ dans le fichier de contr�le.
120
121
\fB\-i\fP[\fIregexp\fP]
121
You may specify a perl regular expression to match files you want filtered
122
out of the list of files for the diff. (This list is generated by a find
123
command.) (If the source package is being built as a version 3 source
124
package using a VCS, this can be used to ignore uncommited changes on
125
specific files. Using \-i.* will ignore all of them.) \fB\-i\fP by itself
126
enables the option, with a default regexp that will filter out control files
127
and directories of the most common revision control systems, backup and swap
128
files and Libtool build output directories. There can only be one active
129
regexp, of multiple \fB\-i\fP options only the last one will take effect.
122
Il est possible de donner une expression rationnelle Perl pour filtrer les
123
fichiers qui doivent �tre �limin�s de la liste des fichiers pour le �\ diff\
124
�. Cette liste est cr��e avec une commande �\ find\ �. Si le fichier source
125
en construction est un fichier source de version 3 utilisant un syst�me de
126
suivi de versions, cette option est utile pour ignorer les modifications non
127
envoy�es. L'option \fB\-i\fP active cette fonction avec une expression r�guli�re
128
qui couvre les fichiers de contr�le des plus usuels syst�mes de gestion de
129
version, les fichiers de sauvegardes, les fichiers d'�change et les
130
r�pertoires utilis�s par Libtool. Il ne peut y avoir qu'une seule expression
131
rationnelle active ; seule la derni�re mentionn�e sera prise en compte.
131
133
C'est tr�s utile pour supprimer des fichiers qui sont inclus dans le diff,
132
134
par exemple, si vous maintenez un source avec un syst�me de contr�le de
172
174
Ne v�rifie pas les signatures et les sommes de contr�le avant de d�paqueter.
174
176
\fB\-\-require\-valid\-signature\fP
175
Refuse to unpack the source package if it doesn't contain an OpenPGP
176
signature that can be verified either with the user's \fItrustedkeys.gpg\fP
177
keyring, one of the vendor\-specific keyrings, or one of the official Debian
178
keyrings (\fI/usr/share/keyrings/debian\-keyring.gpg\fP and
177
Refuse de d�compresser le paquet source s'il ne contient pas de signature
178
OpenPGP pouvant �tre v�rifi�e soit avec le fichier de cl�s
179
\fItrustedkeys.gpg\fP de l'utilisateur, un des fichiers de cl�s propre � un
180
distributeur ou un des fichiers de cl�s officiels de Debian
181
(\fI/usr/share/keyrings/debian\-keyring.gpg\fP et
179
182
\fI/usr/share/keyrings/debian\-maintainers.gpg\fP).
181
184
.SH "FORMATS DE PAQUET SOURCE"
192
195
dans le \fB.diff.gz\fP. La date de tous les fichiers correctifs est celle du
193
196
moment o� a eu lieu l'extraction depuis le paquet source (cela �vite les
194
197
heures fausses menant � des probl�mes lorsque des fichiers g�n�r�s
195
automatiquement sont patch�s). Le diff peut cr�er de nouveaux fichiers (tout
196
le r�pertoire debian est cr�� de cette fa�on) mais ne peut pas supprimer de
197
fichiers (les fichiers vides seront laiss� l�).
198
automatiquement sont modifi�s). Le diff peut cr�er de nouveaux fichiers
199
(tout le r�pertoire debian est cr�� de cette fa�on) mais ne peut pas
200
supprimer de fichiers (les fichiers vides seront laiss� l�).
199
202
\fBConstruction\fP
291
294
plusieurs, seule la derni�re sera prise en compte.
293
296
\fB\-\-skip\-debianization\fP
294
Skips application of the debian diff on top of the upstream sources.
297
Passe l'�tape d'application du fichier de diff�rences Debian aux sources
296
300
.SS "Format: 2.0"
297
301
Aussi connu sous le nom de �\ wig&pen\ �. Ce format n'est pas recommand�
312
316
.SS "Format: 3.0 (native)"
313
317
Ce format est une extension du format de paquet natif tel que d�fini dans le
314
format 1.0. Il accepte toutes les m�thodes de compression et ignore par
315
d�faut tout fichier et r�pertoire VCS ainsi que de nombreux fichiers
316
temporaires (voir la valeur par d�faut associ� � l'option \fB\-I\fP dans la
317
sortie de \fB\-\-help\fP).
318
format 1.0. Il g�re toutes les m�thodes de compression et ignore par d�faut
319
tout fichier et r�pertoire VCS ainsi que de nombreux fichiers temporaires
320
(voir la valeur par d�faut associ� � l'option \fB\-I\fP dans la sortie de
319
323
.SS "Format: 3.0 (quilt)"
320
A source package in this format contains at least an original tarball
321
(\fB.orig.tar.\fP\fIext\fP where \fIext\fP can be \fBgz\fP, \fBbz2\fP and \fBlzma\fP) and a
322
debian tarball (\fB.debian.tar.\fP\fIext\fP). It can also contain additional
323
original tarballs (\fB.orig\-\fP\fIcomponent\fP\fB.tar.\fP\fIext\fP). \fIcomponent\fP can
324
only contain alphanumeric characters and dashes ("\-").
324
Un paquet source dans ce format contient au moins une archive tar d'origine
325
(\fB.orig.tar.\fP\fIext\fP o� \fIext\fP peut �tre \fBgz\fP, \fBbz2\fP et \fBlzma\fP), une
326
archive tar debian (\fB.debian.tar.\fP\fIext\fP). Il peut �galement contenir
327
d'autres archives tar d'origine
328
(\fB.orig\-\fP\fIcomposant\fP\fB.tar.\fP\fIext\fP). \fIcomposant\fP ne peut �tre constitu�
329
que de caract�res alphanum�riques et de tirets (�\ \-\ �).
369
374
si des fichiers binaires sont trouv�s dans le sous\-r�pertoire debian sans
370
375
�tre indiqu� dans la liste blanche de \fBdebian/source/include\-binaries\fP.
372
The updated debian directory and the list of modified binaries is then used
373
to generate the debian tarball.
377
Le r�pertoire debian mis � jour et la liste des binaires modifi�s sont
378
ensuite utilis�s pour recr�er l'archive tar debian.
375
380
Le diff g�n�r� automatiquement n'inclut pas les changements sp�cifiques sur
376
381
les fichiers VCS ainsi sur que de nombreux fichiers temporaires (pour la
378
383
\fB\-\-help\fP). En particulier, le r�pertoire \fB.pc\fP utilis� par �\ quilt\ � est
379
384
ignor� lors de la g�n�ration automatique du patch.
381
Note: \fBdpkg\-source\fP expects the source tree to have all patches listed in
382
the series file applied when you generate the source package. This is not
383
the case when the source tree has been obtained by unpacking a source
384
package using the Format: 1.0 for instance. To mitigate the problem,
385
\fBdpkg\-source\fP will apply the patches by itself if it believes that they
386
have not yet been applied. To detect this situation, it uses the following
387
heuristic: if a \fB.pc\fP subdirectory is detected, it will call \fBquilt
388
unapplied\fP to find out if some patches are not applied. After that, it will
389
take the first patch of the series (or the first unapplied patch returned by
390
\fBquilt unapplied\fP, if any) and verify if it can be applied without
391
errors. If the verification succeeds, it concludes that patches have not
392
been applied and will apply them all. The option \fB\-\-no\-preparation\fP can be
393
used to disable this behaviour.
386
Note\ : \fBdpkg\-source\fP s'attend � ce que l'arbre source ait toutes les
387
corrections d'appliqu�es lorsque vous cr�ez le paquet source. Ce n'est pas
388
le cas lorsque l'arbre source a �t� obtenu par le d�paquetage d'un paquet
389
source utilisant le format\ : 1.0 par exemple. Pour r�duire le probl�me,
390
\fBdpkg\-source\fP appliquera les corrections lui\-m�me s'il d�tecte qu'elles ne
391
l'ont pas �t�. Pour effectuer cette d�tection, il suit le raisonnement
392
suivant\ :\ si un sous\-r�pertoire \fBpc\fP est d�tect�, il lancera la commande
393
\fBquilt unapplied\fP pour contr�ler si toutes les corrections ont �t�
394
appliqu�es. Ensuite, il tente d'appliquer la premi�re correction de la s�rie
395
(ou la premi�re correction retourn�e par la commande \fBquilt unapplied\fP) et
396
contr�le si elle peut �tre appliqu�e sans erreurs. Si ce contr�le r�ussit,
397
il conclut que les corrections n'ont pas �t� appliqu�es et les applique
398
toutes. L'option \fB\-\-no\-preparation\fP peut �tre utilis�e pour d�sactiver ce
395
401
\fBOptions de construction\fP
414
420
\fBOptions d'extraction\fP
416
422
\fB\-\-skip\-debianization\fP
417
Skips extraction of the debian tarball on top of the upstream sources.
423
Passe l'�tape d'extraction de l'archive tar debian par dessus les sources
419
426
\fB\-\-skip\-patches\fP
420
427
Ne pas appliquer des correctifs � la fin de l'extraction.
459
466
r�pertoire temporaire. Avant que ce r�pertoire temporaire ne soit empaquet�
460
467
dans une archive tar, divers nettoyages sont effectu�es pour �conomiser de
469
.SH "FORMATS DE FICHIERS"
463
470
.SS debian/source/format
464
This file contains on a single line the format that should be used to build
465
the source package (possible formats are described above). No leading or
466
trailing spaces are allowed.
471
Ce fichier contient sur une seule ligne le format � utiliser pour construire
472
le paquet source (les formats accept�s sont d�crits plus haut). Il ne doit
473
pas contenir d'espaces avant ou apr�s l'indication du format.
467
474
.SS debian/source/include\-binaries
468
This file contains a list of binary files (one per line) that should be
469
included in the debian tarball. Leading and trailing spaces are stripped.
470
Lines starting with "#" are comments and are skipped. Empty lines are
475
Ce fichier contient une liste de fichiers binaires (un par ligne) qui
476
doivent �tre inclus dans l'archive tar debian. Les espaces plac�s avant ou
477
apr�s ces noms sont supprim�s. Les lignes commen�ant par �\ #\ � sont des
478
commentaires et sont ignor�es, ainsi que les lignes vides.
472
479
.SS debian/patches/series
473
This file lists all patches that have to be applied (in the given order) on
474
top of the upstream source package. Leading and trailing spaces are
475
stripped. Lines starting with "#" are comments and are skipped. Empty lines
476
are ignored. Remaining lines start with a patch filename (relative to the
477
\fBdebian/patches/\fP directory) up to the first space character or the end of
478
line. Optional quilt options can follow up to the end of line or the first
479
"#" preceded by one or more spaces (which marks the start of a comment up to
480
Ce fichier comporte la liste de toutes les corrections qui ont �t�
481
appliqu�es (dans l'ordre indiqu�) aux sources amont. Les espaces situ�s
482
avant et apr�s les noms sont ignor�s. Les lignes commen�ant par �\ #\ � sont
483
des commentaires et sont ignor�es, ainsi que les lignes vides. Les autres
484
lignes d�butent par le nom du fichier de correction (relatif au r�pertoire
485
\fBdebian/patches/\fP) qui se termine au premier espace ou � la fin de la
486
ligne. Des options facultatives de quilt peuvent �tre plac�es jusqu'� la fin
487
de la ligne ou jusqu'au premier caract�re �\ #\ � pr�c�d� par un ou plusieurs
488
espaces (qui indique un commentaire qui se poursuit jusqu'� la fin de la
482
491
Le moment o� a lieu le remplacement d'un champ par rapport � certaines
483
492
d�terminations de champ affich�es sur la sortie standard est plut�t