.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DH 1" .TH DH 1 "2016-07-24" "9.20150101+deb8u2" "Debhelper" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOM" .IX Header "NOM" dh \- Automate de commandes debhelper .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBdh\fR \fIsuite\fR [\fB\-\-with\fR \fIrajout\fR[\fB,\fR\fIrajout\fR ...]] [\fB\-\-list\fR] [\fIoptions de debhelper\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBdh\fR exécute une suite de commandes debhelper. Les \fIsuite\fRs acceptées correspondent aux blocs d'un fichier \fIdebian/rules\fR : \fBbuild-arch\fR, \&\fBbuild-indep\fR, \fBbuild\fR, \fBclean\fR, \fBinstall-indep\fR, \fBinstall-arch\fR, \&\fBinstall\fR, \fBbinary-arch\fR, \fBbinary-indep\fR et \fBbinary\fR. .SH "CIBLES DE RÉÉCRITURE" .IX Header "CIBLES DE RÉÉCRITURE" Un fichier \fIdebian/rules\fR utilisant \fBdh\fR peut réécrire la commande exécutée à n'importe quelle étape d'une séquence, en définissant une cible de réécriture. .PP To override \fIdh_command\fR, add a target named \fBoverride_\fR\fIdh_command\fR to the rules file. When it would normally run \fIdh_command\fR, \fBdh\fR will instead call that target. The override target can then run the command with additional options, or run entirely different commands instead. See examples below. .PP Les cibles de réécriture peuvent aussi être définies pour n'être exécutées que lors de la construction de paquets dépendants ou indépendants de l'architecture. Utilisez des cibles avec des noms comme \&\fBoverride_\fR\fIdh_commande\fR\fB\-arch\fR et \&\fBoverride_\fR\fIdh_commande\fR\fB\-indep\fR. Nota : pour utiliser cette possibilité, il est nécessaire d'ajouter une dépendance de construction (Build-Depends) sur la version 8.9.7 ou supérieure de debhelper. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-with\fR \fIrajout\fR[\fB,\fR\fIrajout\fR ...]" 4 .IX Item "--with rajout[,rajout ...]" Ajoute les commandes debhelper indiquées par les rajouts au bon endroit dans la séquence exécutée. Cette option peut être présente plusieurs fois ou bien plusieurs rajouts peuvent être indiqués en les séparant par des virgules. Cela est utile lorsqu'un paquet tiers fournit des commandes debhelper. Consulter le fichier \fI\s-1PROGRAMMING\s0\fR pour obtenir des informations à propos de l'interface de ces rajouts. .IP "\fB\-\-without\fR \fIrajout\fR" 4 .IX Item "--without rajout" L'inverse de \fB\-\-with\fR, désactive le \fIrajout\fR donné. Cette option peut être présente plusieurs fois ou bien plusieurs rajouts peuvent être indiqués en les séparant par des virgules. .IP "\fB\-\-list\fR, \fB\-l\fR" 4 .IX Item "--list, -l" Liste tous les rajouts disponibles. .IP "\fB\-\-no\-act\fR" 4 .IX Item "--no-act" Affiche les commandes qui seraient utilisées pour une séquence donnée, sans les exécuter. .Sp Note that dh normally skips running commands that it knows will do nothing. With \-\-no\-act, the full list of commands in a sequence is printed. .PP Les autres options fournies à \fBdh\fR sont passées en paramètre à chaque commande exécutée. Cela est utile tant pour les options comme \fB\-v\fR, \fB\-X\fR ou \fB\-N\fR que pour des options plus spécialisées. .SH "EXEMPLES" .IX Header "EXEMPLES" Pour voir quelles commandes sont présentes dans une séquence, sans rien faire : .PP .Vb 1 \& dh binary\-arch \-\-no\-act .Ve .PP C'est un fichier rules très simple, pour les paquets où les séquences de commandes par défaut fonctionnent sans aucune option particulière. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ .Ve .PP Il est fréquent de vouloir passer une option à une commande debhelper. Le moyen le plus simple de le faire consiste à surcharger la commande par défaut par celle que vous désirez. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \& \& override_dh_strip: \& dh_strip \-Xtoto \& \& override_dh_auto_configure: \& dh_auto_configure \-\- \-\-with\-toto \-\-disable\-titi .Ve .PP Parfois les automatismes de \fIdh_auto_configure\fR\|(1) et de \&\fIdh_auto_build\fR\|(1) n'arrivent pas à deviner ce qu'il faut faire pour certains paquets tordus. Voici comment indiquer vos propres commandes plutôt que de laisser faire l'automatisme. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \& \& override_dh_auto_configure: \& ./mondoconfig \& \& override_dh_auto_build: \& make universe\-explode\-in\-delight .Ve .PP Un autre cas habituel consiste à vouloir faire quelque chose avant ou après l'exécution d'une certaine commande debhelper. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \& \& override_dh_fixperms: \& dh_fixperms \& chmod 4755 debian/truc/usr/bin/truc .Ve .PP Si le paquet utilise « autotools » et que vous voulez rafraîchir les \&\fIconfig.sub\fR et les \fIconfig.guess\fR avec les nouvelles versions du paquet \&\fBautotools-dev\fR lors de la compilation, il est possible d'utiliser certaines commandes fournies dans \fBautotools-dev\fR afin d'automatiser cette tâche, comme ci-dessous : .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \-\-with autotools_dev .Ve .PP Les outils Python ne sont pas exécutés par défaut par \fBdh\fR, à cause des modifications incessantes dans ce domaine (avant le niveau de compatibilité 9, \fBdh\fR exécute \fBdh_pysupport\fR). Voici comment utiliser \&\fBdh_python2\fR. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \-\-with python2 .Ve .PP Voici comment forcer l'utilisation du processus de construction \&\fBModule::Build\fR, propre à Perl, qui pourra être indispensable si debhelper détectait, à tort, que le paquet utilise MakeMaker. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh \-\-buildsystem=perl_build $@ .Ve .PP Voici un exemple de remplacement où les commandes \fBdh_auto_\fR\fI*\fR cherchent la source du paquet car elle est située dans un sous\-répertoire. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \-\-sourcedirectory=src .Ve .PP Voici un exemple d'utilisation des commandes \fBdh_auto_\fR\fI*\fR pour réaliser la construction dans un sous\-répertoire, qui sera ensuite supprimé lors du \&\fBclean\fR : .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \-\-builddirectory=build .Ve .PP Si le paquet peut être construit en parallèle, vous pouvez activer le parallélisme comme ci-dessous. Alors \fBdpkg-buildpackage \-j\fR fonctionnera. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \-\-parallel .Ve .PP Voici un moyen d'empêcher \fBdh\fR d'exécuter plusieurs commandes, en définissant des blocs de substitution vides pour chaque commande que vous ne voulez pas lancer. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \& \& # Commandes que l\*(Aqon ne veut pas S \& override_dh_auto_test override_dh_compress override_dh_fixperms: .Ve .PP Un long processus de construction pour un paquet de documentation à part peut être séparé en utilisant des réécritures pour les paquets indépendants de l'architecture. Elles seront ignorées lors de l'exécution des suites build-arch et binary-arch. .PP .Vb 3 \& #!/usr/bin/make \-f \& %: \& dh $@ \& \& override_dh_auto_build\-indep: \& $(MAKE) \-C docs \& \& # Aucun test nécessaire pour la documentation \& override_dh_auto_test\-indep: \& \& override_dh_auto_install\-indep: \& $(MAKE) \-C docs install .Ve .PP En plus de l'exemple précédent, il peut être nécessaire de modifier les droits d'un fichier, mais seulement lors de la construction du paquet dépendant de l'architecture, puisqu'il n'est pas présent lors de la construction de la documentation toute seule. .PP .Vb 3 \& override_dh_fixperms\-arch: \& dh_fixperms \& chmod 4755 debian/truc/usr/bin/truc .Ve .SH "FONCTIONNEMENT INTERNE" .IX Header "FONCTIONNEMENT INTERNE" Si vous êtes curieux de connaître le fonctionnement interne de \fBdh\fR, voici ce qu'il y a sous le capot. .PP Chaque commande debhelper, qui s'accomplit correctement, est journalisée dans \fIdebian/package.debhelper.log\fR (que \fBdh_clean\fR supprimera). Ainsi \&\fBdh\fR peut déterminer quelles commandes ont déjà été exécutées et pour quels paquets. De cette manière il pourra passer outre l'exécution de ces commandes ultérieurement. .PP Chaque fois que \fBdh\fR est exécuté, il examine le journal et recherche la dernière commande exécutée dans la séquence indiquée. Puis il exécute la commande suivante dans cette séquence. Les options \fB\-\-until\fR, \fB\-\-before\fR, \&\fB\-\-after\fR et \fB\-\-remaining\fR permettent de modifier ce comportement. .PP Une suite peut aussi exécuter des cibles dépendantes dans \&\fIdebian/rules\fR. Par exemple, la suite « binary » exécute la cible « install ». .PP \&\fBdh\fR utilise la variable d'environnement \fB\s-1DH_INTERNAL_OPTIONS\s0\fR pour transmettre des informations aux commandes debhelper exécutées au sein des blocs surchargés. Le contenu (et l'existence même) de cette variable d'environnement, comme son nom l'indique, est sujet à des modifications permanentes. .PP Les commandes des séquences \fBbuild-indep\fR, \fBinstall-indep\fR et \&\fBbinary-indep\fR sont appelées avec l'option \fB\-i\fR pour être certain qu'elles ne s'accompliront que sur des paquets indépendants de l'architecture. Symétriquement les commandes des séquences \fBbuild-arch\fR, \&\fBinstall-arch\fR et \fBbinary-arch\fR sont appelées avec l'option \fB\-a\fR pour être certain qu'elles ne s'accompliront que sur des paquets dépendants de l'architecture. .SH "OPTIONS OBSOLÈTES" .IX Header "OPTIONS OBSOLÈTES" Les options suivantes sont obsolètes. Il vaut mieux utiliser les cibles de réécritures à la place. .IP "\fB\-\-until\fR \fIcommande\fR" 4 .IX Item "--until commande" Exécute les commandes de la suite jusqu'à la \fIcommande\fR indiquée, l'exécute puis s'arrête. .IP "\fB\-\-before\fR \fIcommande\fR" 4 .IX Item "--before commande" Exécute les commandes de la suite situées avant la \fIcommande\fR indiquée puis s'arrête. .IP "\fB\-\-after\fR \fIcommande\fR" 4 .IX Item "--after commande" Exécute les commandes de la suite situées après la \fIcommande\fR indiquée. .IP "\fB\-\-remaining\fR" 4 .IX Item "--remaining" Exécute toutes les commandes de la suite qui n'ont pas encore été exécutées. .PP Dans les options ci-dessus, \fIcommande\fR peut être soit le nom complet de la commande debhelper, soit une sous\-chaîne de ce nom. \fBdh\fR cherchera d'abord, dans la séquence, une commande portant le nom exact pour éviter toute ambiguïté. Si plusieurs commandes correspondent à la sous\-chaîne la dernière de la séquence sera prise en compte. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fIdebhelper\fR\|(7) .PP Ce programme fait partie de debhelper. .SH "AUTEUR" .IX Header "AUTEUR" Joey Hess .SH "TRADUCTION" .IX Header "TRADUCTION" Valéry Perrin le 17 septembre 2005. Dernière mise à jour le 3 avril 2011. .PP L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. .PP Cette traduction est gérée dynamiquement par po4a. Certains paragraphes peuvent, éventuellement, apparaître en anglais. Ils correspondent à des modifications ou des ajouts récents du mainteneur, non encore incorporés dans la traduction française. .PP La version originale anglaise de ce document est toujours consultable via la commande man \-L en nom_du_man. .PP N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.