Provided by: debhelper_8.0.0ubuntu1_all bug

NOM

       debhelper - ensemble d'outils regroups 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 comprhensibles qui seront exploits dans
       debian/rules pour automatiser les tches courantes lies  la construction
       des paquets, d'o un travail allg pour le responsable. Dans une certaine
       mesure, cela signifie galement que ces outils peuvent tre adapts aux
       modifications ventuelles de la Charte Debian. Les paquets qui
       utiliseront debhelper ne ncessiteront qu'une simple reconstruction pour
       tre conformes aux nouvelles rgles.

       Un fichier debian/rules typique, exploitant debhelper, appellera
       squentiellement 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 crer 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
       complmentaires.

       dh_auto_build(1)
           construit automatiquement un paquet

       dh_auto_clean(1)
           fait le mnage automatiquement aprs une construction de paquet

       dh_auto_configure(1)
           configure automatiquement un paquet pralablement  sa construction

       dh_auto_install(1)
           lance automatiquement make install ou quivalent

       dh_auto_test(1)
           Excute automatiquement le jeu d'essai d'un paquet

       dh_bugfiles(1)
           installe les fichiers de personnalisation de rapports de bogue dans
           les rpertoires des paquets construits

       dh_builddeb(1)
           Construit des paquets binaires Debian

       dh_clean(1)
           nettoie les rpertoires de construction du paquet

       dh_compress(1)
           comprime les fichiers dans le rpertoire de construction du paquet
           et modifie les liens symboliques en consquence

       dh_desktop(1)
           obsolte. Ne pas l'utiliser

       dh_fixperms(1)
           ajuste les droits sur les fichiers du rpertoire de construction du
           paquet

       dh_gconf(1)
           install GConf defaults files and register schemas

       dh_gencontrol(1)
           produit et installe le fichier de contrle

       dh_icons(1)
           Met  jour les caches des icnes Freedesktop

       dh_install(1)
           installe les fichiers dans le rpertoire 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 rpertoires de construction du paquet

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

       dh_installdeb(1)
           installe des fichiers dans le rpertoire DEBIAN

       dh_installdebconf(1)
           installe les fichiers utiliss par debconf dans les rpertoires de
           construction du paquet

       dh_installdirs(1)
           cre des sous-rpertoires dans le rpertoire de construction du paquet

       dh_installdocs(1)
           installe la documentation dans le rpertoire de construction du
           paquet

       dh_installemacsen(1)
           inscrit un paquet additionnel emacs

       dh_installexamples(1)
           installe les fichiers d'exemples dans le rpertoire 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 tches upstart et les scripts init dans le rpertoire de
           construction du paquet

       dh_installlogcheck(1)
           installe les fichiers de rgles de vrification 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 rpertoire de construction du
           paquet

       dh_installmanpages(1)
           ancien programme d'installation des pages de manuel (obsolte)

       dh_installmenu(1)
           installe les fichiers du menu Debian dans le rpertoire de
           construction du paquet

       dh_installmime(1)
           installe les fichiers mime dans le rpertoire 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 rgles udev

       dh_installwm(1)
           inscrit un gestionnaire de fentre (window manager)

       dh_installxfonts(1)
           inscrit les polices de caractres graphiques (X fonts)

       dh_link(1)
           cre les liens symboliques dans le rpertoire de construction du
           paquet

       dh_lintian(1)
           installe les fichiers override de lintian dans le rpertoire de
           construction du paquet

       dh_listpackages(1)
           numre les paquets binaires que debhelper va traiter

       dh_makeshlibs(1)
           cre automatiquement le fichier shlibs et excute dpkg-gensymbols

       dh_md5sums(1)
           cre le fichier DEBIAN/md5sums

       dh_movefiles(1)
           dplace des fichiers depuis debian/tmp dans des sous-paquets

       dh_perl(1)
           dtermine les dpendances Perl et fait le mnage aprs MakeMaker

       dh_prep(1)
           fait le mnage en vue de construire un paquet Debian

       dh_python(1)
           dtermine les dpendances Python et ajoute des scripts de maintenance
           Python postinst et prerm (obsolte)

       dh_scrollkeeper(1)
           obsolte. Ne pas l'utiliser

       dh_shlibdeps(1)
           dtermine les dpendances envers les bibliothques partages

       dh_strip(1)
           dpouille les excutables, les bibliothques partages, et certaines
           bibliothques statiques

       dh_suidregister(1)
           programme d'inscription suid (obsolte)

       dh_testdir(1)
           vrifie le rpertoire avant de construire un paquet Debian

       dh_testroot(1)
           vrifie que le paquet est construit par le superutilisateur (root)

       dh_undocumented(1)
           programme de cration de liens symboliques vers undocumented.7
           (obsolte)

       dh_usrlocal(1)
           migre les rpertoires usr/local dans les scripts de maintenance du
           paquet

   Commandes obsoltes
       Quelques commandes debhelper sont obsoltes et ne devraient plus tre
       utilises.

   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 mme fonctionner comme les
       autres programmes dcrits dans cette page.

FICHIERS DE CONFIGURATION DE DEBHELPER

       Beaucoup de commandes de debhelper utilisent des fichiers du rpertoire
       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
       spcifiques de debhelper. Ces fichiers sont, en principe, nomms
       debian/paquet.toto (o paquet est, bien sr,  remplacer par le nom du
       paquet concern).

       Par exemple, dh_installdocs utilise un fichier appel
       debian/package.docs pour numrer les fichiers de documentation qu'il
       installera. Consulter les pages de manuel des diffrentes commandes pour
       connatre le dtail des noms et des formats des fichiers employs. D'une
       faon gnrale, ces fichiers de configuration numrent 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 lgrement plus compliqus.

       Nota: Lorsqu'un paquet est le premier (ou le seul) paquet binaire numr
       dans le fichier debian/control, debhelper exploitera debian/toto si
       aucun fichier debian/paquet.toto n'est prsent.

       Dans quelques rares cas, il peut tre utile d'exploiter diffrentes
       versions de ces fichiers pour des architectures ou des systmes
       d'exploitation diffrents. S'il existe des fichiers appels
       debian/paquet.toto.ARCH ou debian/paquet.toto.OS, dans lesquels ARCH et
       OS correspondent respectivement au rsultat de dpkg-architecture
       -qDEB_HOST_ARCH ou de dpkg-architecture -qDEB_HOST_ARCH_OS, alors ils
       seront utiliss de prfrence aux autres fichiers plus gnraux.

       Dans beaucoup de cas, ces fichiers de configuration sont employs pour
       indiquer divers types de fichiers. Documentation, fichiers d'exemples
       installer, fichiers  dplacer et ainsi de suite. Lorsque cela se
       justifie, dans des cas comme ceux-ci, il est possible d'employer, dans
       ces fichiers, les jokers (wildcard) standard de l'interprteur de
       commandes (shell) (?, * et [..]).

       Il est galement possible de placer des commentaires dans ces fichiers.
       Les lignes dbutant par # sont ignores.

OPTIONS PARTAGES DE DEBHELPER

       Tous les programmes de debhelper acceptent les options suivantes:

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

       --no-act
           Empche la construction de s'effectuer rellement. Si cette option
           est utilise avec -v, le rsultat sera l'affichage de ce que la
           commande aurait fait.

       -a, --arch
           Construit tous les paquets dpendants de l'architecture.

       -i, --indep
           Construit tous les paquets indpendants de l'architecture.

       -ppaquet, --package=paquet
           Construit le paquet nomm paquet. Cette option peut tre rpte 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 spcifi du processus de construction, mme si
           l'option -a, -i ou -p l'impliquait.

       --remaining-packages
           Exclut du processus de construction les paquets qui ont dj t
           construit pralablement par cette commande debhelper (c'est--dire,
           si la commande est prsente dans le journal de debhelper du paquet).
           Par exemple, si vous avez besoin d'invoquer la commande avec des
           options spciales seulement pour certains paquets binaires, utilisez
           cette option lors de la dernire invocation de la commande pour
           construire le reste des paquets avec les options par dfaut.

       --ignore=fichier
           Ignore le fichier spcifi. 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 ignors, mais il n'existe aucune
           raison valable de les ignorer.

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

       -Ptmpdir, --tmpdir=tmpdir
           Utilise le rpertoire tmpdir pour construire les paquets. Sinon, par
           dfaut, le rpertoire utilis est debian/paquet

       --mainpackage=paquet
           Cette option, peu utilise, indique  debhelper le nom du paquet
           principal pour lequel les fichiers debian/toto peuvent tre utiliss
           la place des fichiers habituels debian/paquet.toto. Par dfaut,
           debhelper considre que le paquet principal est le premier paquet
           numr dans le fichier debian/control.

       -O=option|bundle
           This is used by dh(1) when passing user-specified options to all
           the commands it runs. If the command supports the specified option
           or option bundle, it will take effect. If the command does not
           support the option (or any part of an option bundle), it will be
           ignored.

OPTIONS COURANTES DE DEBHELPER

       Certains programmes de debhelper acceptent les options ci-dessous.
       Consulter la page de manuel de chaque programme pour une explication
       complte du rle de ces options.

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

       -Xlment, --exclude=lment
           Permet d'exclure un lment du traitement. Cette option peut tre
           employe plusieurs fois afin d'exclure plusieurs lments.

       -A, --all
           Prcise que les fichiers (ou autres lments) indiqus dans la ligne de
           commande concernent TOUS les paquets construits et pas seulement le
           premier.

OPTIONS DU PROCESSUS DE CONSTRUCTION

       Les programmes debhelper dh_auto_* comportent plusieurs processus de
       construction et dterminent, de manire heuristique, lequel utiliser et
       comment. Il peut tre utile de modifier ce comportement par dfaut. Tous
       ces programmes dh_auto_* acceptent les options suivantes:

       -Sprocessus de construction, --buildsystem=processus de construction
           Oblige  utiliser le processus de construction spcifi au lieu de
           tenter de dterminer automatiquement celui qui pourrait tre
           utilisable pour le paquet.

       -Drpertoire, --sourcedirectory=rpertoire
           Considre que les sources du paquet sont situes dans le rpertoire
           spcifi plutt qu'au plus haut niveau de l'arborescence du paquet
           source.

       -B[rpertoire], --builddirectory=[rpertoire]
           Permet de construire le paquet en dehors de la structure source en
           utilisant le rpertoire spcifi comme rpertoire de construction. Si
           le paramtre rpertoire n'est pas spcifi, un rpertoire de
           construction par dfaut sera choisi.

           Si cette option n'est pas spcifie, la construction se fera dans
           l'arborescence source  moins que le processus exige ou prfre le
           faire en dehors de cette structure. Dans ce cas, le rpertoire par
           dfaut sera utilis mme si --builddirectory n'est pas spcifi.

           Mme si le systme prfre utiliser, pour la construction, un rpertoire
           situ en dehors de l'arborescence source, il autorise quand mme la
           construction dans l'arborescence source. Pour cela, il suffit
           d'utiliser un chemin d'accs au rpertoire de construction identique
           au chemin d'accs au rpertoire source.

       --parallel
           Enable parallel builds if underlying build system supports them.
           The number of parallel jobs is controlled by the DEB_BUILD_OPTIONS
           environment variable ("Debian Policy, section 4.9.1") at build
           time. It might also be subject to a build system specific limit.

           If this option is not specified, debhelper currently defaults to
           not allowing parallel package builds.

       --max-parallel=maximum
           This option implies --parallel and allows further limiting the
           number of jobs that can be used in a parallel build. If the package
           build is known to only work with certain levels of concurrency, you
           can set this to the maximum level that is known to work, or that
           you wish to support.

       --list, -l
           Liste tous les processus de construction support par le systme.
           Cette liste inclut  la fois les processus par dfaut et les
           processus tiers (marqus comme tels). Cette option montre galement
           le processus de construction automatiquement slectionn ou celui
           spcifi manuellement avec l'option --buildsystem.

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 dpendant de l'architecture, et un paquet
       indpendant de l'architecture, ce comportement ne conviendra pas. En
       effet, il convient de construire les paquets dpendants de
       l'architecture dans binary-arch de debian/rules, et les paquets
       indpendants de l'architecture dans binary-indep.

       Pour rsoudre ce problme, et pour un meilleur contrle 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 prcise, les programmes de debhelper
       construisent tous les paquets numrs dans le fichier de contrle.

   Gnration 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 gnres devront tre insres. #DEBHELPER#
       sera remplac, par les lignes de code gnres automatiquement, lors de
       l'excution de dh_installdeb.

       Si un script de maintenance n'existe pas et que debhelper doit y
       inclure quelque chose, alors debhelper crera le script de maintenance
       compltement.

       Toutes les commandes de debhelper qui produisent automatiquement des
       lignes de code de cette faon peuvent inhiber cette production grce
       l'option -n (voir ci-dessus).

       Nota: Les lignes de code insres seront crites dans le langage de
       l'interprteur de commandes (shell). De ce fait, il est impossible de
       les placer directement dans un script Perl. Pour les insrer dans un
       script Perl, voici une solution. (S'assurer que $1, $2, etc. sont bien
       dfinis par la commande set.)

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

   Gnration automatique des diverses dpendances.
       Certaines commandes de debhelper peuvent ncessiter des dpendances entre
       le paquet construit et d'autres paquets. Par exemple, si
       dh_installdebconf(1) est employ, le paquet devra dpendre de debconf. Si
       dh_installxfonts(1) est employ, le paquet deviendra dpendant d'une
       version particulire de xutils. Maintenir ces dpendances induites peut
       tre pnible puisqu'elles dcoulent de la faon dont debhelper travaille.
       C'est pourquoi debhelper offre une solution d'automatisation.

       Toutes les commandes de ce type, outre qu'elles documentent, dans leur
       page de manuel, les dpendances qu'elle induisent, gnreront
       automatiquement une variable de substitution nomme ${misc:depends}. Si
       cette variable est exploite dans le dossier debian/control, il sera
       automatiquement enrichi des dpendances induites par debhelper.

       Ce processus est entirement indpendant 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 ralit.

   Rpertoires de construction du paquet
       Par dfaut, tous les programmes de debhelper supposent que le rpertoire
       temporaire utilis pour construire l'arborescence des fichiers d'un
       paquet est debian/paquet.

       Parfois, il peut tre souhaitable d'utiliser un autre rpertoire
       temporaire. Ceci est obtenu grce au paramtre -P. Par exemple,
       dh_installdocs-Pdebian/tmp utilisera debian/tmp comme rpertoire
       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 gnre plusieurs paquets binaires, il faudra employer
       galement le paramtre -p pour prciser l'unique paquet binaire
       construire.

   Niveaux de compatibilit de debhelper
       Parfois, des modifications majeures de debhelper doivent tre faites et
       vont briser la compatibilit ascendante. Ces modifications sont
       ncessaires pour conserver  debhelper ses qualits de conception et
       d'criture, car les besoins changent et le savoir-faire de l'auteur
       s'amliore. Pour viter que de tels changements ne cassent les paquets
       existants, un concept de niveau de compatibilit debhelper a t
       introduit. On prcisera  debhelper le niveau de compatibilit qu'il doit
       employer ce qui modifiera son comportement de diverses manires.

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

         % echo 8 > debian/compat

       Sauf indication contraire, toute la documentation de debhelper suppose
       l'utilisation du niveau de compatibilit le plus rcent, et, dans la
       plupart des cas ne prcise pas si le comportement est diffrent avec les
       niveaux de compatibilit antrieurs. De ce fait, si le niveau de
       compatibilit le plus rcent n'est pas celui utilis, il est fortement
       conseill de lire les indications ci-dessous qui exposent les diffrences
       dans les niveaux de compatibilit antrieurs.

       Les niveaux de compatibilit sont les suivants:

       v1  C'est le niveau initial de compatibilit de debhelper d'o son numro
           1. Dans ce mode, debhelper emploiera debian/tmp comme rpertoire de
           l'arborescence du premier paquet binaire numr dans le fichier de
           contrle et debian/paquet pour tous les autres.

           Ce mode est dconseill.

       v2  Dans ce mode, debhelper emploiera uniformment debian/paquet comme
           rpertoire de l'arborescence de chaque paquet construit.

           Ce mode est dconseill.

       v3  This mode works like v2, with the following additions:

           -       Les fichiers de configuration de debhelper acceptent les
                   jokers * et ?  lorsque cela a un sens. Pour dsactiver cette
                   substitution et utiliser ces caractres tels quels, il
                   suffit de les prfixer 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 dconseill.

       v4  Changes from v3 are:

           -       dh_makeshlibs -V n'inclura pas la partie Debian du numro de
                   version dans la ligne de dpendance produite dans le fichier
                   shlibs.

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

           -       dh_fixperms rendra excutables tous les fichiers des
                   rpertoires bin/ et etc/init.d.

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

           Ce mode est dconseill.

       v5  Changes from v4 are:

           -       Les commentaires sont ignors 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 gnre des erreurs si les jokers (wildcards) ne
                   correspondent rien.

       v6  Changes from v5 are:

           -       Les commandes qui gnrent des lignes de codes de maintenance
                   les mettront dans l'ordre inverse dans les scripts postrm
                   et prerm.

           -       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 rpertoire usr/share/man/man1 du rpertoire de
                   construction du paquet.

           -       dh_builddeb, pralablement, ne supprimait pas les
                   associations cres avec DH_ALWAYS_EXCLUDE s'il tait configur
                   sur une liste d'lments tels que CVS:.svn:.git. Maintenant
                   il le fait.

           -       Dh_installman permet d'craser les pages de man existantes
                   dans le rpertoire de construction du paquet. Pralablement,
                   il refusait en silence de le faire.

       v7  Changes from v6 are:

           -       dh_install cherchera rcursivement les fichiers dans
                   debian/tmp s'il ne les trouve pas dans le rpertoire courant
                   (ou dans le rpertoire spcifi par --sourcedir). Cela permet
                   dh_install d'interoprer avec dh_auto_install, qui place les
                   fichiers dans debian/tmp, sans ncessiter de paramtres
                   particuliers.

           -       dh_clean lit le rpertoire debian/clean et supprime les
                   fichiers qui y sont mentionns.

           -       dh_clean supprime les fichiers *-stamp.

           -       dh_installchangelogs dterminera  quel fichier correspond le
                   changelog amont si rien n'est spcifi.

       v8  C'est la version dont l'usage est recommand.

           Changes from v7 are:

           -       Commands will fail rather than warning when they are passed
                   unknown options.

           -       dh_makeshlibs will run dpkg-gensymbols on all shared
                   libraries that it generates shlibs files for. So -X can be
                   used to exclude libraries.  Also, libraries in unusual
                   locations that dpkg-gensymbols would not have processed
                   before will be passed to it, a behavior change that can
                   cause some packages to fail to build.

           -       dh requires the sequence to run be specified as the first
                   parameter, and any switches come after it. Ie, use "dh $@
                   --foo", not "dh --foo $@"

                   dh_auto_* prefer to use perl's Module::Build in preference
                   to Makefile.PL.

   udebs
       Debhelper includes support for udebs. To create a udeb with debhelper,
       add "Package-Type: udeb" to the package's stanza in debian/control, and
       build-depend on debhelper (>= 4.2). 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.

   Autres remarques
       Gnralement, si un programme de debhelper a besoin qu'un rpertoire
       existe dans debian/, il le crera. Ce comportement n'est pas document
       dans toutes les pages de manuel, mais, par exemple, le dh_installdeb
       sait qu'il doit crer le rpertoire debian/paquet/DEBIAN/ avant de tenter
       de mettre des fichiers dedans. De mme, dh_installmenu sait qu'il est
       ncessaire d'avoir un rpertoire debian/paquet/usr/share/menu/ avant
       d'installer les fichiers menu, etc.

       Ds qu'un paquet emploie debhelper pour sa construction, il faut vrifier
       que debhelper a bien t ajout  la ligne Build-Depends dans le fichier
       debian/control. Il convient galement de s'assurer que la version de
       debhelper indique dans build-depend est au moins gale au niveau de
       compatibilit de debhelper utilise pour la construction du paquet. Ainsi
       si le paquet emploie le niveau 7 de compatibilit:

        Build-Depends: debhelper (>= 7)

VARIABLES D'ENVIRONNEMENT

       DH_VERBOSE
           Mettre cette variable  1 valide le mode verbeux. Debhelper
           affichera chaque commande excute qui modifie des fichiers.

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

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

       DH_OPTIONS
           Tout ce qui est indiqu dans cette variable sera pass en argument
           toutes les commandes debhelper. Les options spcifiques  une
           commande seront ignores par les commandes qui n'exploitent pas
           cette option.

           Ce comportement est utile dans quelques situations, par exemple,
           pour passer -p  toutes les commandes de debhelper qui seront
           excutes. Une bonne faon d'employer DH_OPTIONS est d'utiliser des
           triplets Cible-spcifiqueVariableValeurs dans le fichier
           debian/rules. Consulter la documentation de make pour obtenir des
           prcisions sur cette mthode.

       DH_ALWAYS_EXCLUDE
           Si cette variable possde une valeur, elle sera ajoute  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 rglage de DH_ALWAYS_EXCLUDE=CVS
           empchera les rpertoires CVS d'interfrer subrepticement dans le
           paquet en construction. Ou, si un paquet possde une source
           compresse, (maladroitement) prsente dans un rpertoire 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 spares avec des caractres 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

       Valry Perrin <valery.perrin.debian@free.fr> le 17 septembre 2005.
       Dernire mise  jour le 29 septembre 2009.

       L'quipe de traduction a fait le maximum pour raliser une adaptation
       franaise de qualit.

       Cette traduction est gre dynamiquement par po4a. Certains paragraphes
       peuvent, ventuellement, apparatre en anglais. Ils correspondent  des
       modifications ou des ajouts rcents du mainteneur, non encore incorpors
       dans la traduction franaise.

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

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