33
33
\fBdpkg\-source\fP [\fIoption\fP...] \fIcommande\fP
36
\fBdpkg\-source\fP empaquete ou d�paquete une archive source Debian.
36
\fBdpkg\-source\fP empaquette ou d�paquette une archive source Debian.
38
38
Aucune de ces commandes ne permet la combinaison de plusieurs options en une
39
39
seule et elles ne permettent pas d'indiquer la valeur d'une option dans un
44
44
\fB\-x \fP\fIfichier\fP\fB.dsc\fP [\fIr�pertoire\-de\-sortie\fP]
45
45
Cette option sert � extraire un paquet source. On doit donner un seul
46
46
argument sans option\ : le nom du fichier de contr�le des sources Debian
47
(\fB.dsc\fP). Un deuxi�me argument sans option peut �tre donn� pour indiquer
48
le r�pertoire o� extraire le paquet source, cela ne doit pas exister. Quand
47
(\fB.dsc\fP). Un deuxi�me argument sans option peut �tre donn� pour indiquer le
48
r�pertoire o� extraire le paquet source, cela ne doit pas exister. Quand
49
49
aucun r�pertoire n'est indiqu�, le paquet source est extrait dans un
50
50
r�pertoire \fIsource\fP\-\fIversion\fP du r�pertoire courant.
103
103
\fB\-\-after\-build\fP \fIr�pertoire\fP
104
Ex�cute le point d'entr�e correspondant du format de paquet source.Ce point
104
Ex�cute le point d'entr�e correspondant du format de paquet source. Ce point
105
105
d'entr�e doit �tre utilis� apr�s toute construction du paquet
106
106
(\fBdpkg\-buildpackage\fP l'utilise en dernier). Il doit �tre autonome et doit
107
pouvoir �tre lanc�e plusieurs fois. Tous les formats source ne mettent pas
108
en oeuvre ce branchement et ceux qui le font s'en servent pour d�faire ce
109
qui a �t� fait par \fB\-\-before\-build\fP.
107
pouvoir �tre lanc� plusieurs fois. Tous les formats source ne mettent pas en
108
?uvre ce branchement et ceux qui le font s'en servent pour d�faire ce qui a
109
�t� fait par \fB\-\-before\-build\fP.
112
112
\fB\-\-commit\fP [\fIr�pertoire\fP] ...
190
190
par exemple, si vous maintenez un source avec un syst�me de contr�le de
191
191
r�vision et que voulez construire un paquet source sans inclure des fichiers
192
192
et r�pertoires additionnels qu'il contient g�n�ralement (par exemple CVS/,
193
\&.cvsignore, .svn/). L'expression rationnelle par d�faut est d�j� tr�s
193
\&.cvsignore, .svn/). L'expression rationnelle par d�faut est d�j� tr�s
194
194
exhaustive, mais si avez besoin de la remplacer, veuillez noter que par
195
195
d�faut, il sait v�rifier n'importe quelle partie d'un chemin, donc si vous
196
196
voulez trouver le d�but d'un nom de fichier ou des noms de fichiers
200
200
\fB\-\-extend\-diff\-ignore\fP=\fIexpr.rat.\fP
201
201
L'expression rationnelle Perl indiqu�e compl�tera la valeur par d�faut que
202
\fB\-\-diff\-ignore\fP et sa valeur courante (si d�finie). Cela est effectu� en
202
\fB\-\-diff\-ignore\fP et sa valeur courante (si d�finie). Cela est effectu� en
203
203
concat�nant "\fB|\fP\fIexpr.rat.\fP � la valeur existante. Cette option est
204
pratique das \fBdebian/source/options\fP pour exclure certains fichiers
204
pratique dans \fBdebian/source/options\fP pour exclure certains fichiers
205
205
auto\-cr��s de la cr�ation automatique de correctifs.
207
207
\fB\-I\fP[\fImotif\-fichier\fP], \fB\-\-tar\-ignore\fP[=\fImotif\-fichier\fP]
248
248
Si vous ne savez pas quel format source utiliser, il est conseill� de
249
249
choisir soit �\ 3.0 (quilt)" soit "3.0 (native)". Voir
250
250
http://wiki.debian.org/Projects/DebSrc3.0 pour plus d'informations sur la
251
mise en oeuvre de ces formats dans Debian.
251
mise en ?uvre de ces formats dans Debian.
253
253
.SS "Format: 1.0"
254
254
Un paquet source dans ce format se compose soit d'un \fB.orig.tar.gz\fP associ�
260
260
Extraire un paquet natif revient � une simple extraction de l'archive TAR
261
261
dans le r�pertoire cible. L'extraction d'un paquet non\-natif consiste au
262
d�paquetage du \fB.orig.tar.gz\fP puis l'application des correctifs contenues
262
d�paquetage du \fB.orig.tar.gz\fP puis l'application des correctifs contenus
263
263
dans le \fB.diff.gz\fP. La date de tous les fichiers correctifs est celle du
264
264
moment o� a eu lieu l'extraction depuis le paquet source (cela �vite les
265
265
heures fausses menant � des probl�mes lorsque des fichiers g�n�r�s
266
266
automatiquement sont modifi�s). Le diff peut cr�er de nouveaux fichiers
267
267
(tout le r�pertoire debian est cr�� de cette fa�on) mais ne peut pas
268
supprimer de fichiers (les fichiers vides seront laiss� l�).
268
supprimer de fichiers (les fichiers vides seront laiss�s l�).
270
270
\fBConstruction\fP
386
386
moment de l'extraction.
388
388
Lors de la construction d'un nouveau paquet source, toute modification
389
apport�e � la source amont est enregistr� dans un correctif nomm�
389
apport�e � la source amont est enregistr�e dans un correctif nomm�
390
390
\fBzz_debian\-diff\-auto\fP.
392
392
.SS "Format: 3.0 (native)"
418
418
Toutes les modifications figurant dans \fBdebian/patches/debian.series\fP ou
419
419
\fBdebian/patches/series\fP sont alors appliqu�es. Si l'ancien fichier est
420
utilis� et qu'il n'y a pas de plus r�cent (ou que c'est un lien symbolique),
421
alors celui\-ci est remplac� par un lien symbolique vers l'ancien. Cette
422
disposition vise � simplifier l'utilisation de �\ quilt\ � pour g�rer
423
l'ensemble des patches. Notez toutefois que si \fBdpkg\-source\fP analyse
424
correctement une s�rie de fichiers avec les options utilis�es pour
420
utilis� et qu'il n'y en a pas de plus r�cent (ou que c'est un lien
421
symbolique), alors celui\-ci est remplac� par un lien symbolique vers
422
l'ancien. Cette disposition vise � simplifier l'utilisation de �\ quilt\ �
423
pour g�rer l'ensemble des patches. Notez toutefois que si \fBdpkg\-source\fP
424
analyse correctement une s�rie de fichiers avec les options utilis�es pour
425
425
l'application du correctif (stock�es sur chaque ligne apr�s le nom du patch
426
et d'un ou plusieurs espaces), il n'ignore pas cesoptions et s'attendra
427
toujours que les correctifs puissent �tre appliqu�s avec l'option \fB\-p1\fP de
428
\fBpatch\fP. Il va donc �mettre un avertissement lorsqu'il rencontre ces
429
options, et la construction est susceptible d'�chouer.
426
et d'un ou plusieurs espaces), il n'ignore pas ces options et s'attendra
427
toujours � ce que les correctifs puissent �tre appliqu�s avec l'option
428
\fB\-p1\fP de \fBpatch\fP. Il va donc �mettre un avertissement lorsqu'il
429
rencontrera ces options, et la construction est susceptible d'�chouer.
431
431
Au contraire du comportement par d�faut de quilt, les rustines doivent
432
432
s'appliquer sans d�calage (�\ fuzz\ �). Quand cela n'est pas le cas, il est
470
470
Note\ : \fBdpkg\-source\fP \fB\-\-before\-build\fP (et \fB\-b\fP) prendra soin d'appliquer
471
471
les corrections indiqu�es dans le fichier series afin q'un paquet soit
472
toujours consutruit avec toutes les corrections appliqu�es. Pour effectuer
472
toujours construit avec toutes les corrections appliqu�es. Pour effectuer
473
473
cette d�tection, il recherche la liste des correctifs non appliqu�s (ils
474
474
sont mentionn�s dans le fichier \fBseries\fP mais pas dans
475
475
\&\fB.pc/applied\-patches\fP) et si le premier de cette liste peut �tre appliqu�
496
496
ne doivent pas comporter de modifications suppl�mentaires.
498
498
Si la cr�ation de correctif d�tecte des fichiers binaires modifi�s, ils
499
seront ajout�s automatiquement � \fBdebian/source/include\-binaries\fP afin de
500
pouvoir �tr einclus dans l'archive debian (de fa�on analogue � ce que ferait
499
seront ajout�s automatiquement � \fBdebian/source/include\-binaries\fP afin de
500
pouvoir �tre inclus dans l'archive debian (de fa�on analogue � ce que ferait
501
501
\fBdpkg\-source \-\-include\-binaries \-b\fP).
503
503
\fBOptions de construction\fP
616
616
s'assurer qu'il n'existe aucun changement non\-soumis et � ne pas ignorer.
618
618
\fBgit\-bundle\fP(1) permet de cr�er un ensemble � partir du d�p�t git. Par
619
d�faut, toutes les branches et �tiquettes du d�p�t sont inclus dans cet
619
d�faut, toutes les branches et �tiquettes du d�p�t sont incluses dans cet
622
622
\fBOptions de construction\fP
624
624
\fB\-\-git\-ref=\fP\fIr�f\fP
625
625
Permet d'indiquer une r�f�rence git � inclure dans l'ensemble
626
626
git. L'utilisation de cette option d�sactive le comportement par d�faut qui
627
est d'inclure toutes les branches et �tiquettes. Cette option peut\-�tre
627
est d'inclure toutes les branches et �tiquettes. Cette option peut �tre
628
628
utilis�e plusieurs fois. Le param�tre \fIr�f\fP peut �tre le nom d'une branche
629
629
ou une �tiquette � inclure. Il peut �galement �tre tout param�tre que l'on
630
peut passer � \fBgit\-rev\-list\fP(1). Par exemple, pour n'inclure que la
630
peut passer � \fBgit\-rev\-list\fP(1). Par exemple, pour n'inclure que la branche
631
631
�\ master\ �, on peut utiliser \-\-git\-ref=master. Pour inclure toutes les
632
632
�tiquettes et toutes les branches, sauf la branche priv�e, on peut utiliser
633
633
\-git\-ref=\-\-all \-\- git\-ref=^private.
671
671
.SS "le fichier de diff�rences modifie les fichiers amont suivants"
672
672
Lors de l'utilisation du format source �\ 1.0\ �, il est d�conseill� de
673
673
modifier directement les fichiers amont car les modifications restent alors
674
cach�es et souvent non document�es dans le fichier diff.gz. AU contraire, il
674
cach�es et souvent non document�es dans le fichier diff.gz. Au contraire, il
675
675
est conseill� de conserver les modifications sous forme de correctifs dans
676
676
le r�pertoire debian et de les appliquer au moment de la construction. Pour
677
677
�viter ces op�rations plus complexes, vous pouvez �galement choisir le
736
736
formats �\ 2.0\ � et �\ 3.0 (quilt)\ �. \fBlocal\-patch\-header\fP n'est pas inclus
737
737
dans le paquet source cr�� alors que \fBpatch\-header\fP l'est.
738
738
.SS debian/patches/series
739
Ce fichier comporte la liste de toutes les corrections qui ont �t�
740
appliqu�es (dans l'ordre indiqu�) aux sources amont. Les espaces situ�s
741
avant et apr�s les noms sont ignor�s. Les lignes commen�ant par �\ #\ � sont
742
des commentaires et sont ignor�es, ainsi que les lignes vides. Les autres
743
lignes d�butent par le nom du fichier de correction (relatif au r�pertoire
744
\fBdebian/patches/\fP) qui se termine au premier espace ou � la fin de la
745
ligne. Des options facultatives de quilt peuvent �tre plac�es jusqu'� la fin
746
de la ligne ou jusqu'au premier caract�re �\ #\ � pr�c�d� par un ou plusieurs
747
espaces (qui indique un commentaire qui se poursuit jusqu'� la fin de la
739
Ce fichier comporte la liste de toutes les corrections qui ont �t� appliqu�s
740
(dans l'ordre indiqu�) aux sources amont. Les espaces situ�s avant et apr�s
741
les noms sont ignor�s. Les lignes commen�ant par �\ #\ � sont des commentaires
742
et sont ignor�es, ainsi que les lignes vides. Les autres lignes d�butent par
743
le nom du fichier de correction (relatif au r�pertoire \fBdebian/patches/\fP)
744
qui se termine au premier espace ou � la fin de la ligne. Des options
745
facultatives de quilt peuvent �tre plac�es jusqu'� la fin de la ligne ou
746
jusqu'au premier caract�re �\ #\ � pr�c�d� par un ou plusieurs espaces (qui
747
indique un commentaire qui se poursuit jusqu'� la fin de la ligne).
750
749
Le moment o� a lieu le remplacement d'un champ par rapport � certaines
751
750
d�terminations de champ affich�es sur la sortie standard est plut�t