Provided by: debhelper_9.20120115ubuntu3_all bug

NOM

       debhelper - ensemble d'outils regroupés sous le nom de debhelper

SYNOPSIS

       dh_* [-v] [-a] [-i] [-s] [--no-act] [-ppaquet] [-Npaquet] [-Ptmpdir]

DESCRIPTION

       Debhelper facilite la construction des paquets Debian. La philosophie qui sous-tend
       debhelper est de fournir une collection de petits outils simples et facilement
       compréhensibles qui seront exploités dans debian/rules pour automatiser les tâches
       courantes liées à la construction des paquets, d'où un travail allégé pour le responsable.
       Dans une certaine mesure, cela signifie également que ces outils peuvent être adaptés aux
       modifications éventuelles de la Charte Debian. Les paquets qui utiliseront debhelper ne
       nécessiteront qu'une simple reconstruction pour être conformes aux nouvelles règles.

       Un fichier debian/rules typique, exploitant debhelper, appellera séquentiellement
       plusieurs des commandes de debhelper ou bien utilisera dh(1) pour automatiser ce
       processus. Des exemples de fichiers debian/rules qui exploitent debhelper se trouvent dans
       /usr/share/doc/debhelper/examples/

       Pour créer un nouveau paquet Debian en utilisant debhelper, il suffit de copier un des
       fichiers d'exemple et de le modifier manuellement. Il est possible également d'essayer le
       paquet dh-make qui contient une commande dh_make automatisant partiellement le processus.
       Pour se familiariser avec ces concepts, le paquet Debian maint-guide contient un cours sur
       la construction d'un premier paquet avec debhelper.

COMMANDES DE DEBHELPER

       Voici la liste des commandes debhelper disponibles. Consulter leurs pages de manuel
       respectives pour obtenir des informations complémentaires.

       dh_auto_build(1)
           construit automatiquement un paquet

       dh_auto_clean(1)
           fait le ménage automatiquement après une construction de paquet

       dh_auto_configure(1)
           configure automatiquement un paquet préalablement à sa construction

       dh_auto_install(1)
           lance automatiquement make install ou équivalent

       dh_auto_test(1)
           Exécute automatiquement le jeu d'essai d'un paquet

       dh_bugfiles(1)
           installe les fichiers de personnalisation de rapports de bogue dans les répertoires
           des paquets construits

       dh_builddeb(1)
           Construit des paquets binaires Debian

       dh_clean(1)
           nettoie les répertoires de construction du paquet

       dh_compress(1)
           comprime les fichiers dans le répertoire de construction du paquet et modifie les
           liens symboliques en conséquence

       dh_fixperms(1)
           ajuste les droits sur les fichiers du répertoire de construction du paquet

       dh_gconf(1)
           Installe les fichiers par défaut de GConf et inscrit les schémas

       dh_gencontrol(1)
           produit et installe le fichier de contrôle

       dh_icons(1)
           Met à jour les caches des icônes Freedesktop

       dh_install(1)
           installe les fichiers dans le répertoire de construction du paquet

       dh_installcatalogs(1)
           installe et inscrit les catalogues SGML

       dh_installchangelogs(1)
           installe les journaux de suivi des modifications (changelog) dans les répertoires de
           construction du paquet

       dh_installcron(1)
           installe les scripts cron dans etc/cron.*

       dh_installdeb(1)
           installe des fichiers dans le répertoire DEBIAN

       dh_installdebconf(1)
           installe les fichiers utilisés par debconf dans les répertoires de construction du
           paquet

       dh_installdirs(1)
           crée des sous-répertoires dans le répertoire de construction du paquet

       dh_installdocs(1)
           installe la documentation dans le répertoire de construction du paquet

       dh_installemacsen(1)
           inscrit un paquet additionnel Emacs

       dh_installexamples(1)
           installe les fichiers d'exemples dans le répertoire de construction du paquet

       dh_installifupdown(1)
           installe les accroches (hooks) if-up et if-down

       dh_installinfo(1)
           installe les fichiers info

       dh_installinit(1)
           installe les tâches upstart et les scripts init dans le répertoire de construction du
           paquet

       dh_installlogcheck(1)
           installe les fichiers de règles de vérification des journaux (logcheck rulefiles) dans
           etc/logcheck/

       dh_installlogrotate(1)
           installe les fichiers de configuration de la rotation des journaux (logrotate)

       dh_installman(1)
           installe les pages de manuel dans le répertoire de construction du paquet

       dh_installmenu(1)
           installe les fichiers du menu Debian dans le répertoire de construction du paquet

       dh_installmime(1)
           installe les fichiers « mime » dans le répertoire de construction du paquet

       dh_installmodules(1)
           inscrit les modules avec modutils

       dh_installpam(1)
           installe les fichiers de support de PAM

       dh_installppp(1)
           installe les fichiers ppp.ip-up et ppp.ip-down

       dh_installudev(1)
           installe les fichiers de règles udev

       dh_installwm(1)
           inscrit un gestionnaire de fenêtre (window manager)

       dh_installxfonts(1)
           inscrit les polices de caractères graphiques (X fonts)

       dh_link(1)
           crée les liens symboliques dans le répertoire de construction du paquet

       dh_lintian(1)
           installe les fichiers « override » de lintian dans le répertoire de construction du
           paquet

       dh_listpackages(1)
           énumère les paquets binaires que debhelper va traiter

       dh_makeshlibs(1)
           crée automatiquement le fichier shlibs et exécute dpkg-gensymbols

       dh_md5sums(1)
           crée le fichier DEBIAN/md5sums

       dh_movefiles(1)
           déplace des fichiers depuis debian/tmp dans des sous-paquets

       dh_perl(1)
           détermine les dépendances Perl et fait le ménage après MakeMaker

       dh_prep(1)
           fait le ménage en vue de construire un paquet Debian

       dh_shlibdeps(1)
           détermine les dépendances envers les bibliothèques partagées

       dh_strip(1)
           dépouille les exécutables, les bibliothèques partagées, et certaines bibliothèques
           statiques

       dh_testdir(1)
           vérifie le répertoire avant de construire un paquet Debian

       dh_testroot(1)
           vérifie que le paquet est construit par le superutilisateur (root)

       dh_usrlocal(1)
           migre les répertoires usr/local dans les scripts de maintenance du paquet

   Commandes obsolètes
       Quelques commandes debhelper sont obsolètes et ne devraient plus être utilisées.

       dh_desktop(1)
           obsolète. Ne pas l'utiliser

       dh_installmanpages(1)
           ancien programme d'installation des pages de manuel (obsolète)

       dh_python(1)
           détermine les dépendances Python et ajoute des scripts de maintenance Python postinst
           et prerm (obsolète)

       dh_scrollkeeper(1)
           obsolète. Ne pas l'utiliser

       dh_suidregister(1)
           programme d'inscription suid (obsolète)

       dh_undocumented(1)
           programme de création de liens symboliques vers « undocumented.7 » (obsolète)

   Autres commandes
       Si le nom d'un programme commence par dh_ et qu'il n'est pas dans les listes ci-dessus,
       cela signifie qu'il ne fait pas partie de la suite debhelper. Cependant, il devrait tout
       de même fonctionner comme les autres programmes décrits dans cette page.

FICHIERS DE CONFIGURATION DE DEBHELPER

       Beaucoup de commandes de debhelper utilisent des fichiers du répertoire debian/ pour
       piloter leur fonctionnement. Outre les fichiers debian/changelog et debian/control, qui se
       trouvent dans tous les paquets, et pas seulement dans ceux qui emploient debhelper,
       d'autres fichiers peuvent servir à configurer le comportement des commandes spécifiques de
       debhelper. Ces fichiers sont, en principe, nommés debian/paquet.toto (où paquet est, bien
       sûr, à remplacer par le nom du paquet concerné).

       Par exemple, dh_installdocs utilise un fichier appelé debian/package.docs pour énumérer
       les fichiers de documentation qu'il installera. Consulter les pages de manuel des
       différentes commandes pour connaître le détail des noms et des formats des fichiers
       employés. D'une façon générale, ces fichiers de configuration énumèrent les fichiers sur
       lesquels devra porter l'action, à raison d'un fichier par ligne. Quelques programmes de
       debhelper emploient des paires fichier/destination voire des formats légèrement plus
       compliqués.

       Note for the first (or only) binary package listed in debian/control, debhelper will use
       debian/foo when there's no debian/package.foo file.

       Dans quelques rares cas, il peut être utile d'exploiter différentes versions de ces
       fichiers pour des architectures ou des systèmes d'exploitation différents. S'il existe des
       fichiers appelés debian/paquet.toto.ARCH ou debian/paquet.toto.OS, dans lesquels ARCH et
       OS correspondent respectivement au résultat de « dpkg-architecture -qDEB_HOST_ARCH » ou de
       « dpkg-architecture -qDEB_HOST_ARCH_OS », alors ils seront utilisés de préférence aux
       autres fichiers plus généraux.

       Mostly, these config files are used to specify lists of various types of files.
       Documentation or example files to install, files to move, and so on. When appropriate, in
       cases like these, you can use standard shell wildcard characters (? and * and [..]
       character classes) in the files. You can also put comments in these files; lines beginning
       with # are ignored.

       The syntax of these files is intentionally kept very simple to make then easy to read,
       understand, and modify. If you prefer power and complexity, you can make the file
       executable, and write a program that outputs whatever content is appropriate for a given
       situation. When you do so, the output is not further processed to expand wildcards or
       strip comments.

OPTIONS PARTAGÉES DE DEBHELPER

       Tous les programmes de debhelper acceptent les options suivantes :

       -v, --verbose
           Mode verbeux : affiche toutes les commandes qui modifient le répertoire de
           construction du paquet.

       --no-act
           Empêche la construction de s'effectuer réellement. Si cette option est utilisée avec
           -v, le résultat sera l'affichage de ce que la commande aurait fait.

       -a, --arch
           Construit tous les paquets dépendants de l'architecture.

       -i, --indep
           Construit tous les paquets indépendants de l'architecture.

       -ppaquet, --package=paquet
           Construit le paquet nommé « paquet ». Cette option peut être répétée afin de faire
           agir debhelper sur plusieurs paquets.

       -s, --same-arch
           Cette option était plus intelligente de l'option -a, mais l'option -a est maintenant
           tout aussi intelligente.

       -Npaquet, --no-package=paquet
           Exclut le paquet spécifié du processus de construction, même si l'option -a, -i ou -p
           l'impliquait.

       --remaining-packages
           Exclut du processus de construction les paquets qui ont déjà été construit
           préalablement par cette commande debhelper (c'est-à-dire, si la commande est présente
           dans le journal de debhelper du paquet). Par exemple, si vous avez besoin d'invoquer
           la commande avec des options spéciales seulement pour certains paquets binaires,
           utilisez cette option lors de la dernière invocation de la commande pour construire le
           reste des paquets avec les options par défaut.

       --ignore=fichier
           Ignore le fichier spécifié. Ceci peut être utilisé si debian/ contient un fichier de
           configuration debhelper avec une commande qui ne doit pas être pris en compte. Nota :
           debian/compat, debian/control, et debian/changelog ne peuvent pas être ignorés, mais
           il n'existe aucune raison valable de les ignorer.

           Par exemple, si vous récupérez en amont un fichier debian/init que vous ne voulez pas
           que dh_installinit installe, utilisez --ignore=debian/init

       -Ptmpdir, --tmpdir=tmpdir
           Utilise le répertoire tmpdir pour construire les paquets. Sinon, par défaut, le
           répertoire utilisé est « debian/paquet »

       --mainpackage=paquet
           Cette option, peu utilisée, indique à debhelper le nom du « paquet principal » pour
           lequel les fichiers debian/toto peuvent être utilisés à la place des fichiers
           habituels debian/paquet.toto. Par défaut, debhelper considère que le « paquet
           principal » est le premier paquet énuméré dans le fichier debian/control.

       -O=option|ensemble
           Cette option est utilisée par L <dh(1)> pour passer une ou plusieurs options,
           spécifiées par l'utilisateur, à toutes les commandes exécutées. Si la commande prend
           en charge l'option ou l'ensemble d'options, elle prendra effet. Si la commande
           n'accepte pas l'option (ou une partie de l'ensemble d'options), elle sera ignorée.

OPTIONS COURANTES DE DEBHELPER

       Certains programmes de debhelper acceptent les options ci-dessous. Consulter la page de
       manuel de chaque programme pour une explication complète du rôle de ces options.

       -n  Ne pas modifier les scripts de maintenance du paquet (postinst, postrm, etc.).

       -Xélément, --exclude=élément
           Permet d'exclure un élément du traitement. Cette option peut être employée plusieurs
           fois afin d'exclure plusieurs éléments.

       -A, --all
           Précise que les fichiers (ou autres éléments) indiqués dans la ligne de commande
           concernent TOUS les paquets construits et pas seulement le premier.

OPTIONS DU PROCESSUS DE CONSTRUCTION

       The following command line options are supported by all of the dh_auto_* debhelper
       programs. These programs support a variety of build systems, and normally heuristically
       determine which to use, and how to use them. You can use these command line options to
       override the default behavior. Typically these are passed to dh(1), which then passes them
       to all the dh_auto_* programs.

       -Sprocessus de construction, --buildsystem=processus de construction
           Oblige à utiliser le processus de construction spécifié au lieu de tenter de
           déterminer automatiquement celui qui pourrait être utilisable pour le paquet.

       -Drépertoire, --sourcedirectory=répertoire
           Considère que les sources du paquet sont situées dans le répertoire spécifié plutôt
           qu'au plus haut niveau de l'arborescence du paquet source.

       -B[répertoire], --builddirectory=[répertoire]
           Permet de construire le paquet en dehors de la structure source en utilisant le
           répertoire spécifié comme répertoire de construction. Si le paramètre répertoire n'est
           pas spécifié, un répertoire de construction par défaut sera choisi.

           Si cette option n'est pas spécifiée, la construction se fera dans l'arborescence
           source à moins que le processus exige ou préfère le faire en dehors de cette
           structure. Dans ce cas, le répertoire par défaut sera utilisé même si --builddirectory
           n'est pas spécifié.

           Même si le système préfère utiliser, pour la construction, un répertoire situé en
           dehors de l'arborescence source, il autorise quand même la construction dans
           l'arborescence source. Pour cela, il suffit d'utiliser un chemin d'accès au répertoire
           de construction identique au chemin d'accès au répertoire source.

       --parallel
           Cette option active la construction parallèle si le système sous-jacent le permet. Le
           nombre de tâches parallèles est contrôlé, lors de la construction, par la variable
           d'environnement DEB_BUILD_OPTIONS ("Charte Debian, section 4.9.1"). Ce nombre peut
           également être soumis aux limites spécifiques du système.

           Si cette option n'est pas spécifiée, debhelper n'activera pas, par défaut, le
           parallélisme lors de la construction.

       --max-parallel=maximum
           Cette option implique --parallel et permet de limiter le nombre de tâches qui pourront
           être lancées lors d'une compilation parallèle. Si la construction du paquet est connu
           pour ne fonctionner qu'avec un certain niveau de parallélisme, il est possible de le
           régler à la valeur maximum censée fonctionner, ou que vous souhaitez mettre en oeuvre.

       --list, -l
           Liste tous les processus de construction supporté par le système. Cette liste inclut à
           la fois les processus par défaut et les processus tiers (marqués comme tels). Cette
           option montre également le processus de construction automatiquement sélectionné ou
           celui spécifié manuellement avec l'option --buildsystem.

COMPATABILITY LEVELS

       Parfois, des modifications majeures de debhelper doivent être faites et vont briser la
       compatibilité ascendante. Ces modifications sont nécessaires pour conserver à debhelper
       ses qualités de conception et d'écriture, car les besoins changent et le savoir-faire de
       l'auteur s'améliore. Pour éviter que de tels changements ne cassent les paquets existants,
       un concept de niveau de compatibilité debhelper a été introduit. On précisera à debhelper
       le niveau de compatibilité qu'il doit employer ce qui modifiera son comportement de
       diverses manières.

       Tell debhelper what compatibility level to use by writing a number to debian/compat. For
       example, to turn on v9 mode:

         % echo 9 > debian/compat

       Your package will also need a versioned build dependency on a version of debhelper equal
       to (or greater than) the compatibility level your package uses. So for compatibility level
       9, ensure debian/control has:

         Build-Depends: debhelper (>= 9)

       Sauf indication contraire, toute la documentation de debhelper suppose l'utilisation du
       niveau de compatibilité le plus récent, et, dans la plupart des cas ne précise pas si le
       comportement est différent avec les niveaux de compatibilité antérieurs. De ce fait, si le
       niveau de compatibilité le plus récent n'est pas celui utilisé, il est fortement conseillé
       de lire les indications ci-dessous qui exposent les différences dans les niveaux de
       compatibilité antérieurs.

       Les niveaux de compatibilité sont les suivants :

       v1  C'est le niveau initial de compatibilité de debhelper d'où son numéro 1. Dans ce mode,
           debhelper emploiera debian/tmp comme répertoire de l'arborescence du premier paquet
           binaire énuméré dans le fichier control et « debian/paquet » pour tous les autres.

           Ce mode est déconseillé.

       v2  Dans ce mode, debhelper emploiera uniformément « debian/paquet » comme répertoire de
           l'arborescence de chaque paquet construit.

           Ce mode est déconseillé.

       v3  Ce mode fonctionne comme v2 mais avec les ajouts suivants :

           -       Les fichiers de configuration de debhelper acceptent les jokers * et ? lorsque
                   cela a un sens. Pour désactiver cette substitution et utiliser ces caractères
                   tels quels, il suffit de les préfixer avec une barre contre-oblique
                   (backslash).

           -       Les scripts de maintenance du paquet (postinst et postrm) feront appel à
                   ldconfig quand dh_makeshlibs sera lancé.

           -       Chaque fichier de etc/ est automatiquement marqué par dh_installdeb comme un
                   fichier de configuration.

           Ce mode est déconseillé.

       v4  Les changements par rapport à la version 3 sont :

           -       dh_makeshlibs -V n'inclura pas la partie Debian du numéro de version dans la
                   ligne de dépendance produite dans le fichier shlibs.

           -       Il est fortement conseillé de mettre le nouveau ${misc:Depends} dans
                   debian/control pour compléter le champs ${shlibs:Depends}.

           -       dh_fixperms rendra exécutables tous les fichiers des répertoires bin/ et
                   etc/init.d.

           -       dh_link corrigera les liens existants pour les rendre conformes à la Charte
                   Debian.

           Ce mode est déconseillé.

       v5  Les changements par rapport à la version 4 sont :

           -       Les commentaires sont ignorés dans les fichiers de configuration de debhelper.

           -       dh_strip --dbg-package indique maintenant le nom du paquet qui doit recevoir
                   les symboles de mise au point et non plus les paquets d'où proviennent ces
                   symboles.

           -       dh_installdocs saute l'installation des fichiers vides.

           -       dh_install génère des erreurs si les jokers (wildcards) ne correspondent à
                   rien.

       v6  Les changements par rapport à la version 5 sont :

           -       Les commandes qui génèrent des lignes de codes de maintenance les mettront
                   dans l'ordre inverse dans les scripts prerm et postrm.

           -       dh_installwm installera un lien vers une page de manuel esclave pour
                   x-window-manager.1.gz s'il voit la page de manuel dans le répertoire
                   usr/share/man/man1 du répertoire de construction du paquet.

           -       dh_builddeb, préalablement, ne supprimait pas les associations crées avec
                   DH_ALWAYS_EXCLUDE s'il était configuré sur une liste d'éléments tels que
                   CVS:.svn:.git. Maintenant il le fait.

           -       Dh_installman permet d'écraser les pages de man existantes dans le répertoire
                   de construction du paquet. Préalablement, il refusait en silence de le faire.

       v7  Les changements par rapport à la version 6 sont :

           -       dh_install cherchera récursivement les fichiers dans debian/tmp s'il ne les
                   trouve pas dans le répertoire courant (ou dans le répertoire spécifié par
                   --sourcedir). Cela permet à dh_install d'interopérer avec dh_auto_install, qui
                   place les fichiers dans debian/tmp, sans nécessiter de paramètres
                   particuliers.

           -       dh_clean lit le répertoire debian/clean et supprime les fichiers qui y sont
                   mentionnés.

           -       dh_clean supprime les fichiers *-stamp.

           -       dh_installchangelogs déterminera à quel fichier correspond le changelog amont
                   si rien n'est spécifié.

       v8  Les changements par rapport à la version 7 sont :

           -       Les commandes échoueront plutôt que de produire une alerte lorsqu'elles
                   recevront des options inconnues.

           -       dh_makeshlibs va exécuter le programme dpkg-gensymbols sur toutes les
                   bibliothèques partagées qu'il génère pour les fichiers shlibs. -X peut alors
                   être utilisé pour exclure certaines bibliothèques. En outre, les bibliothèques
                   rangées à des emplacements inhabituels que pkg-gensymbols n'aurait pas
                   traitées avant qu'elles ne lui soient transmises, induisent un changement de
                   comportement qui peut causer l'échec de la construction de certains paquets.

           -       dh exige que la séquence à exécuter soit spécifiée en tant que premier
                   paramètre. Tous les commutateurs doivent venir après. C'est à dire qu'il faut
                   écrire « dh $@ --toto », et non « dh --toto $@ »

           -       Dh_auto_* utilise préférentiellement Module::Build de Perl au lieu de
                   Makefile.PL.

       v9  C'est la version dont l'usage est recommandé.

           Changes from v8 are:

           -       Multiarch support. In particular, dh_auto_configure passes multiarch
                   directories to autoconf in --libdir and --libexecdir.

           -       dh is aware of the usual dependencies between targets in debian/rules. So, "dh
                   binary" will run any build, build-arch, build-indep, install, etc targets that
                   exist in the rules file. There's no need to define an explicit binary target
                   with explicit dependencies on the other targets.

           -       dh_strip compresses debugging symbol files to reduce the installed size of
                   -dbg packages.

           -       dh_auto_configure does not include the source package name in --libexecdir
                   when using autoconf.

           -       dh does not default to enabling --with=python-support

           -       All of the dh_auto_* debhelper programs and dh set environment variables
                   listed by dpkg-buildflags, unless they are already set. They support
                   DEB_BUILD_OPTIONS=noopt too.

           -       dh_auto_configure passes CFLAGS to perl Makefile.PL and Build.PL

           -       dh_strip puts separated debug symbols in a location based on their build-id.

           -       Executable debhelper config files are run and their output used as the
                   configuration.

       v10 This compatibility level is still open for development; use with caution.

           Changes from v9 are:

           -       None yet..

REMARQUES

   Prise en charge de plusieurs paquets binaires
       Si le paquet source produit plus d'un paquet binaire, les programmes de debhelper
       construiront tous les paquets binaires. Si le paquet source doit construire un paquet
       dépendant de l'architecture, et un paquet indépendant de l'architecture, ce comportement
       ne conviendra pas. En effet, il convient de construire les paquets dépendants de
       l'architecture dans « binary-arch » de debian/rules, et les paquets indépendants de
       l'architecture dans « binary-indep ».

       Pour résoudre ce problème, et pour un meilleur contrôle sur la construction des paquets
       par debhelper, tous les programmes de debhelper acceptent les options -a, -i, -p, et -s.
       Ces options sont cumulatives. Si aucune n'est précisée, les programmes de debhelper
       construisent tous les paquets énumérés dans le fichier de contrôle.

   Génération automatique des scripts Debian de maintenance du paquet
       Certaines commandes de debhelper produisent automatiquement des lignes de code de
       maintenance du paquet. Pour les inclure dans vos propres scripts de maintenance du paquet,
       il convient d'ajouter #DEBHELPER# à l'endroit où les lignes de code générées devront être
       insérées. #DEBHELPER# sera remplacé, par les lignes de code générées automatiquement, lors
       de l'exécution de dh_installdeb.

       Si un script de maintenance n'existe pas et que debhelper doit y inclure quelque chose,
       alors debhelper créera le script de maintenance complètement.

       Toutes les commandes de debhelper qui produisent automatiquement des lignes de code de
       cette façon peuvent inhiber cette production grâce à l'option -n (voir ci-dessus).

       Nota : Les lignes de code insérées seront écrites dans le langage de l'interpréteur de
       commandes (shell). De ce fait, il est impossible de les placer directement dans un script
       Perl. Pour les insérer dans un script Perl, voici une solution. (S'assurer que $1, $2,
       etc. sont bien définis par la commande set.) :

        my $temp="set -e\nset -- @ARGV\n" . << 'EOF';
        #DEBHELPER#
        EOF
        system ($temp) / 256 == 0
               or die "Problème avec le script de S<debhelper :> $!";

   Génération automatique des diverses dépendances.
       Some debhelper commands may make the generated package need to depend on some other
       packages. For example, if you use dh_installdebconf(1), your package will generally need
       to depend on debconf. Or if you use dh_installxfonts(1), your package will generally need
       to depend on a particular version of xutils. Keeping track of these miscellaneous
       dependencies can be annoying since they are dependent on how debhelper does things, so
       debhelper offers a way to automate it.

       Toutes les commandes de ce type, outre qu'elles documentent, dans leur page de manuel, les
       dépendances qu'elle induisent, généreront automatiquement une variable de substitution
       nommée ${misc:depends}. Si cette variable est exploitée dans le dossier debian/control, il
       sera automatiquement enrichi des dépendances induites par debhelper.

       Ce processus est entièrement indépendant de ${shlibs:Depends} standard, produite par
       dh_makeshlibs(1), et de ${perl:Depends} produite par dh_perl(1). Il est également possible
       de choisir de ne pas les utiliser si les conjectures de debhelper ne correspondent pas à
       la réalité.

   Répertoires de construction du paquet
       Par défaut, tous les programmes de debhelper supposent que le répertoire temporaire
       utilisé pour construire l'arborescence des fichiers d'un paquet est debian/paquet.

       Parfois, il peut être souhaitable d'utiliser un autre répertoire temporaire. Ceci est
       obtenu grâce au paramètre -P. Par exemple, dh_installdocs -Pdebian/tmp utilisera
       debian/tmp comme répertoire temporaire. Nota : L'usage de -P implique que les programmes
       de debhelper ne construisent qu'un seul paquet à la fois. De ce fait, si le paquet source
       génère plusieurs paquets binaires, il faudra employer également le paramètre -p pour
       préciser l'unique paquet binaire à construire.

   udebs
       Debhelper includes support for udebs. To create a udeb with debhelper, add "Package-Type:
       udeb" to the package's stanza in debian/control. Debhelper will try to create udebs that
       comply with debian-installer policy, by making the generated package files end in .udeb,
       not installing any documentation into a udeb, skipping over preinst, postrm, prerm, and
       config scripts, etc.

VARIABLES D'ENVIRONNEMENT

       DH_VERBOSE
           Mettre cette variable à 1 valide le mode verbeux. Debhelper affichera chaque commande
           exécutée qui modifie des fichiers.

       DH_COMPAT
           Indique temporairement le niveau de compatibilité auquel debhelper doit fonctionner.
           Cette valeur supplante la valeur précisée dans debian/compat.

       DH_NO_ACT
           Mettre cette variable à 1 pour activer le mode simulation (no-act).

       DH_OPTIONS
           Anything in this variable will be prepended to the command line arguments of all
           debhelper commands.

           When using dh(1), it can be passed options that will be passed on to each debhelper
           command, which is generally better than using DH_OPTIONS.

       DH_ALWAYS_EXCLUDE
           Si cette variable possède une valeur, elle sera ajoutée à l'option -X de toutes les
           commandes qui admettent cette option. De plus, dh_builddeb fera un rm -rf quelque
           chose, correspondant à la valeur dans l'arbre de construction de paquet.

           Ceci peut être utile pour construire un paquet à partir d'une arborescence CVS. Dans
           ce cas, le réglage de DH_ALWAYS_EXCLUDE=CVS empêchera les répertoires CVS d'interférer
           subrepticement dans le paquet en construction. Ou, si un paquet possède une source
           compressée, (maladroitement) présente dans un répertoire CVS, il peut être utile
           d'exporter DH_ALWAYS_EXCLUDE=CVS dans debian/rules, pour que cette variable soit prise
           en compte quel que soit l'endroit où le paquet est construit.

           Des exclusions multiples peuvent être séparées avec des caractères deux points, comme
           dans DH_ALWAYS_EXCLUDE=CVS:.svn.

VOIR AUSSI

       /usr/share/doc/debhelper/examples/
           Un ensemble d'exemples de fichiers debian/rules qui utilisent debhelper.

       <http://kitenet.net/~joey/code/debhelper/>
           Le site internet 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
       3 avril 2011.

       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 -L en nom_du_man.

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