.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" 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 >0, 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
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "DH 1"
.TH DH 1 "2019-04-08" "12.1.1~bpo9+1" "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
Pour réécrire la commande \fIdh_commande\fR, ajoutez une cible appelée
\&\fBoverride_\fR\fIdh_commande\fR au fichier \fIrules\fR. \fBdh\fR exécutera ce bloc au
lieu d'exécuter \fIdh_commande\fR, comme il l'aurait fait sinon. La commande
exécutée peut être la même commande avec des options supplémentaires ou une
commande entièrement différente. Consultez les exemples ci-dessous.
.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.
.Sp
Une relation \fBBuild-Depends\fR sur le paquet \fBdh\-sequence\-\fR\fIrajout\fR
implique \fB\-\-with\fR \fIrajout\fR. Cela évite un \fB\-\-with\fR explicite dans
\&\fIdebian/rules\fR qui dupliquerait ce qui est écrit dans les dépendances de
construction dans \fIdebian/control\fR. Seules les relations décrites dans le
champ \fBBuild-Depends\fR sont utilisées (\fBBuild-Depends-Indep\fR et
\&\fBBuild-Depends-Arch\fR sont volontairement non pris en charge). Gardez à
l'esprit que \fBdh\fR exige des relations simples (une relation du type
« \fBdh\-sequence\-\fR\fIrajout\fR | \fBun-autre-paquet\fR » n'impliquera \fIpas\fR
\&\fB\-\-with\fR \fIrajout\fR).
.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.
.Sp
Lorsqu'il est appelé uniquement avec cette option, \fBdh\fR peut être invoqué
depuis n'importe quel répertoire (c'est\-à\-dire qu'il ne nécessite aucun
accès à des fichiers d'un paquet source).
.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
Veuillez remarquer que \fBdh\fR élimine les commandes en cours lorsqu'il sait
qu'elles ne font rien. Avec l'option \fB\-\-no\-act\fR, la liste complète des
commandes dans une séquence est affichée.
.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 \fIrules\fR 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 à ajouter une cible pour
surcharger la commande.
.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
Les outils Python ne sont pas exécutés par défaut par \fBdh\fR, à cause des
modifications incessantes dans ce domaine. 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 pourrait ê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, veuillez utiliser le niveau
de compatibilité 10 ou passer l'option \fB\-\-parallel\fR à \fBdh\fR. Dans ce cas
\&\fBdpkg-buildpackage \-j\fR fonctionnera.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@ \-\-parallel
.Ve
.PP
Si votre paquet ne peut être construit de manière fiable en utilisant
plusieurs processus légers, veuillez passer l'option \fB\-\-no\-parallel\fR à dh
(ou la commande adéquate \fBdh_auto_\fR\fI*\fR) :
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@ \-\-no\-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<exécuter :>
\&        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
Dans les niveaux de compatibilité 10 (ou supérieurs), \fBdh\fR crée un fichier
\&\fIdebian/debhelper\-build\-stamp\fR après la construction pour ne pas la
refaire. Il est possible d'éviter la création de ce fichier en passant
l'argument \fB\-\-without=build\-stamp\fR à \fBdh\fR. Cela rend le comportement des
construction « no clean » plus cohérent avec l'usage courant au détriment de
possiblement effectuer la construction et le test deux fois (la seconde en
tant que « root » ou avec \fIfakeroot\fR\|(1)).
.PP
À l'intérieur d'une cible de réécriture, les commandes \fBdh_*\fR écrivent dans
un journal \fIdebian/paquet.debhelper.log\fR pour savoir quelle commande a été
exécutée pour quel paquet. Ces fichiers journaux seront supprimés une fois
la cible de réécriture terminée.
.PP
Dans les niveaux de compatibilité 9 et précédents, 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é (en v9 ou précédente), 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 (mais ont été supprimées dans la v10).
.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. Elles ne sont \fBpas\fR disponibles dans le niveau de
compatibilité 10.
.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 <joeyh@debian.org>
.SH "TRADUCTION"
.IX Header "TRADUCTION"
Cette traduction est maintenue à l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'équipe francophone de traduction
de Debian.
.PP
Veuillez signaler toute erreur de traduction en écrivant à
<debian\-l10n\-french@lists.debian.org> ou par un rapport de bogue sur le paquet
debhelper.
.PP
Vous pouvez toujours avoir accès à la version anglaise de ce document en
utilisant la commande « man \-L C <section> <page_de_man> ».