Provided by: debhelper_7.4.11ubuntu1_all bug

NOM

       dh - automate de commandes debhelper

SYNOPSIS

       dh sequence [--with rajout[,rajout,...]] [--list] [--until commande]
       [--before commande] [--after commande] [--remaining]
       [optionsdedebhelper]

DESCRIPTION

       dh exécute séquentiellement une série de commande debhelper. Les
       séquences acceptées correspondent aux blocs d’un fichier debian/rules:
       «build», «clean», «install», «binary-arch», «binary-indep» et «binary».

       Les commandes de la séquence binary-indep sont appelées avec l’option
       «-i» pour être certain qu’elles ne s’accompliront que sur des paquets
       indépendants de l’architecture. Symétriquement les commandes de la
       séquence binary-arch sont appelées avec l’option «-a» pour être certain
       qu’elles ne s’accompliront que sur des paquets dépendants de
       l’architecture.

       Chaque commande debhelper, qui s’accomplit correctement, est
       journalisée dans debian/package.debhelper.log (que dh_clean
       supprimera). Ainsi dh 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.

       Chaque fois que dh est exécuté, il examine le journal et recherche la
       dernière commande exécutée dans la séquence spécifiée. Puis il exécute
       la commande suivante dans cette séquence. Les options --until,
       --before, --after et --remaining permettent de modifier ce
       comportement.

       If debian/rules contains a target with a name like
       "override_dh_command", then when it would notmally run dh_command, dh
       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. (Note that to use this feature, you should
       Build-Depend on debhelper 7.0.50 or above.)

OPTIONS

       --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
           PROGRAMMING pour obtenir des informations à propos de l’interface
           de ces rajouts.

       --without rajout
           Le contraire de --with. Désactive l’utilisation des rajouts
           indiqués.

       --list, -l
           Liste tous les rajouts disponibles.

       --until commande
           Exécute les commandes de la séquence jusqu’à la commande spécifiée,
           l’exécute puis s’arrête.

       --before commande
           Exécute les commandes de la séquence situées avant la commande
           spécifiée puis s’arrête.

       --after commande
           Exécute les commandes de la séquence situées après la commande
           spécifiée.

       --remaining
           Exécute toutes les commandes de la séquence qui n’ont pas encore
           été exécutées.

       --no-act
           Prints commands that would run for a given sequence, but does not
           run them.

       Toute autre option fournie à dh est passée en paramètre à chaque
       commande exécutée. Cela est utile pour les options comme «-v», «-X»,
       «-N» aussi bien que pour des options plus spécialisées.

       In the above options, cmd can be a full name of a debhelper command, or
       a substring. It’ll first search for a command in the sequence exactly
       matching the name, to avoid any ambiguity. If there are multiple
       substring matches, the last one in the sequence will be used.

EXEMPLES

       Pour voir quelles commandes sont présentes dans une séquence, sans rien
       faire:

               dh binary-arch --no-act

       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.

               #!/usr/bin/make -f
               %:
                       dh $@

       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.         #!/usr/bin/make -f
            %:           dh $@

               override_dh_strip:
                       dh_strip -Xfoo

               override_dh_installdocs:
                       dh_installdocs README TODO

       Parfois les automatismes de dh_auto_configure et de dh_auto_build
       n’arrivent pas à deviner ce qu’il faut faire pour certains paquets
       tordus. Voici comment indiquer vos propres commandes.

               #!/usr/bin/make -f
               %:
                       dh $@

               override_dh_auto_configure:
                       ./mondoconfig

               override_dh_auto_build:
                       make universe-explode-in-delight

       Un autre cas habituel consiste à vouloir faire quelque chose avant ou
       après l’exécution d’une certaine commande debhelper.

               #!/usr/bin/make -f
               %:
                       dh $@

               override_dh_fixperms:
                       dh_fixperms
                       chmod 4755 debian/foo/usr/bin/foo

       Si le paquet est un paquet python, dh utilisera dh_pysupport par
       défaut. Voici comment utiliser dh_pycentral à la place.

               #!/usr/bin/make -f
               %:
                       dh --with python-central $@

       Here is how to force use of perl’s Module::Build build system, which
       can be necessary if debhelper wrongly detects that the package uses
       MakeMaker.

               #!/usr/bin/make -f
               %:
                       dh --buildsystem=perl_build $@

       Pour patcher un paquet en utilisant quilt, il faut demander à dh
       d’utiliser la séquence dh propre à quilt. Voici comment faire:

               #!/usr/bin/make -f
               %:
                       dh --with quilt $@

       Here is an example of overriding where the dh_auto_* commands find the
       package’s source, for a package where the source is located in a
       subdirectory.

               #!/usr/bin/make -f
               %:
                       dh --sourcedirectory=src $@

       Finally, here is a way to prevent dh from running several commands that
       you don’t want it to run, by defining empty override targets for each
       command.

               #!/usr/bin/make -f
               %:
                       dh $@

               # Commands not to run:
               override_dh_auto_test override_dh_compress override_dh_fixperms:

VOIR AUSSI

       debhelper(7)

       Ce programme fait partie de debhelper.

AUTEUR

       Joey Hess <joeyh@debian.org>

TRADUCTION

       Valéry Perrin <valery.perrin.debian@free.fr> le 17 septembre 2005.
       Dernière mise à jour le 29 septembre 2009.

       L’équipe de traduction a fait le maximum pour réaliser une adaptation
       française de qualité.

       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.

       La version originale anglaise de ce document est toujours consultable
       via la commande  man-Lennom_du_man.

       N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas,
       toute erreur dans cette page de manuel.