Provided by: debhelper_9.20120115ubuntu3_all bug

NOM

       debhelper - ensemble d'outils regroupes 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 comprehensibles qui seront exploites dans
       debian/rules pour automatiser les taches courantes liees a la
       construction des paquets, d'ou un travail allege pour le responsable.
       Dans une certaine mesure, cela signifie egalement que ces outils
       peuvent etre adaptes aux modifications eventuelles de la Charte Debian.
       Les paquets qui utiliseront debhelper ne necessiteront qu'une simple
       reconstruction pour etre conformes aux nouvelles regles.

       Un fichier debian/rules typique, exploitant debhelper, appellera
       sequentiellement 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 creer un nouveau paquet Debian en utilisant debhelper, il suffit
       de copier un des fichiers d'exemple et de le modifier manuellement. Il
       est possible egalement 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
       complementaires.

       dh_auto_build(1)
           construit automatiquement un paquet

       dh_auto_clean(1)
           fait le menage automatiquement apres une construction de paquet

       dh_auto_configure(1)
           configure automatiquement un paquet prealablement a sa construction

       dh_auto_install(1)
           lance automatiquement make install ou equivalent

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

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

       dh_builddeb(1)
           Construit des paquets binaires Debian

       dh_clean(1)
           nettoie les repertoires de construction du paquet

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

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

       dh_gconf(1)
           Installe les fichiers par defaut de GConf et inscrit les schemas

       dh_gencontrol(1)
           produit et installe le fichier de controle

       dh_icons(1)
           Met a jour les caches des icones Freedesktop

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

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

       dh_installdeb(1)
           installe des fichiers dans le repertoire DEBIAN

       dh_installdebconf(1)
           installe les fichiers utilises par debconf dans les repertoires de
           construction du paquet

       dh_installdirs(1)
           cree des sous-repertoires dans le repertoire de construction du
           paquet

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

       dh_installemacsen(1)
           inscrit un paquet additionnel Emacs

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

       dh_installlogcheck(1)
           installe les fichiers de regles de verification 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 repertoire de construction du
           paquet

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

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

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

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

       dh_link(1)
           cree les liens symboliques dans le repertoire de construction du
           paquet

       dh_lintian(1)
           installe les fichiers <<override>> de lintian dans le repertoire de
           construction du paquet

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

       dh_makeshlibs(1)
           cree automatiquement le fichier shlibs et execute dpkg-gensymbols

       dh_md5sums(1)
           cree le fichier DEBIAN/md5sums

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

       dh_perl(1)
           determine les dependances Perl et fait le menage apres MakeMaker

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

       dh_shlibdeps(1)
           determine les dependances envers les bibliotheques partagees

       dh_strip(1)
           depouille les executables, les bibliotheques partagees, et
           certaines bibliotheques statiques

       dh_testdir(1)
           verifie le repertoire avant de construire un paquet Debian

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

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

   Commandes obsol`etes
       Quelques commandes debhelper sont obsoletes et ne devraient plus etre
       utilisees.

       dh_desktop(1)
           obsolete. Ne pas l'utiliser

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

       dh_python(1)
           determine les dependances Python et ajoute des scripts de
           maintenance Python postinst et prerm (obsolete)

       dh_scrollkeeper(1)
           obsolete. Ne pas l'utiliser

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

       dh_undocumented(1)
           programme de creation de liens symboliques vers <<undocumented.7>>
           (obsolete)

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

FICHIERS DE CONFIGURATION DE DEBHELPER

       Beaucoup de commandes de debhelper utilisent des fichiers du repertoire
       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 a configurer le comportement des commandes
       specifiques de debhelper. Ces fichiers sont, en principe, nommes
       debian/paquet.toto (ou paquet est, bien sur, a remplacer par le nom du
       paquet concerne).

       Par exemple, dh_installdocs utilise un fichier appele
       debian/package.docs pour enumerer les fichiers de documentation qu'il
       installera. Consulter les pages de manuel des differentes commandes
       pour connaitre le detail des noms et des formats des fichiers employes.
       D'une facon generale, ces fichiers de configuration enumerent les
       fichiers sur lesquels devra porter l'action, a raison d'un fichier par
       ligne. Quelques programmes de debhelper emploient des paires
       fichier/destination voire des formats legerement plus compliques.

       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 etre utile d'exploiter differentes
       versions de ces fichiers pour des architectures ou des systemes
       d'exploitation differents. S'il existe des fichiers appeles
       debian/paquet.toto.ARCH ou debian/paquet.toto.OS, dans lesquels ARCH et
       OS correspondent respectivement au resultat de <<dpkg-
       architecture-qDEB_HOST_ARCH>> ou de <<dpkg-
       architecture-qDEB_HOST_ARCH_OS>>, alors ils seront utilises de
       preference aux autres fichiers plus generaux.

       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'EES DE DEBHELPER

       Tous les programmes de debhelper acceptent les options suivantes:

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

       --no-act
           Empeche la construction de s'effectuer reellement. Si cette option
           est utilisee avec -v, le resultat sera l'affichage de ce que la
           commande aurait fait.

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

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

       -ppaquet, --package=paquet
           Construit le paquet nomme <<paquet>>. Cette option peut etre
           repetee afin de faire agir debhelper sur plusieurs paquets.

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

       -Npaquet, --no-package=paquet
           Exclut le paquet specifie du processus de construction, meme si
           l'option -a, -i ou -p l'impliquait.

       --remaining-packages
           Exclut du processus de construction les paquets qui ont deja ete
           construit prealablement par cette commande debhelper (c'est-a-dire,
           si la commande est presente dans le journal de debhelper du
           paquet). Par exemple, si vous avez besoin d'invoquer la commande
           avec des options speciales seulement pour certains paquets
           binaires, utilisez cette option lors de la derniere invocation de
           la commande pour construire le reste des paquets avec les options
           par defaut.

       --ignore=fichier
           Ignore le fichier specifie. Ceci peut etre utilise si debian/
           contient un fichier de configuration debhelper avec une commande
           qui ne doit pas etre pris en compte. Nota: debian/compat,
           debian/control, et debian/changelog ne peuvent pas etre ignores,
           mais il n'existe aucune raison valable de les ignorer.

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

       -Ptmpdir, --tmpdir=tmpdir
           Utilise le repertoire tmpdir pour construire les paquets. Sinon,
           par defaut, le repertoire utilise est <<debian/paquet>>

       --mainpackage=paquet
           Cette option, peu utilisee, indique a debhelper le nom du << paquet
           principal >> pour lequel les fichiers debian/toto peuvent etre
           utilises a la place des fichiers habituels debian/paquet.toto. Par
           defaut, debhelper considere que le << paquet principal >> est le
           premier paquet enumere dans le fichier debian/control.

       -O=option|ensemble
           Cette option est utilisee par L <dh(1)> pour passer une ou
           plusieurs options, specifiees par l'utilisateur, a toutes les
           commandes executees. 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
           ignoree.

OPTIONS COURANTES DE DEBHELPER

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

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

       -X'el'ement, --exclude='el'ement
           Permet d'exclure un element du traitement. Cette option peut etre
           employee plusieurs fois afin d'exclure plusieurs elements.

       -A, --all
           Precise que les fichiers (ou autres elements) indiques 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 a utiliser le processus de construction specifie au lieu de
           tenter de determiner automatiquement celui qui pourrait etre
           utilisable pour le paquet.

       -Dr'epertoire, --sourcedirectory=r'epertoire
           Considere que les sources du paquet sont situees dans le r'epertoire
           specifie plutot qu'au plus haut niveau de l'arborescence du paquet
           source.

       -B[r'epertoire], --builddirectory=[r'epertoire]
           Permet de construire le paquet en dehors de la structure source en
           utilisant le r'epertoire specifie comme repertoire de construction.
           Si le parametre r'epertoire n'est pas specifie, un repertoire de
           construction par defaut sera choisi.

           Si cette option n'est pas specifiee, la construction se fera dans
           l'arborescence source a moins que le processus exige ou prefere le
           faire en dehors de cette structure. Dans ce cas, le repertoire par
           defaut sera utilise meme si --builddirectory n'est pas specifie.

           Meme si le systeme prefere utiliser, pour la construction, un
           repertoire situe en dehors de l'arborescence source, il autorise
           quand meme la construction dans l'arborescence source. Pour cela,
           il suffit d'utiliser un chemin d'acces au repertoire de
           construction identique au chemin d'acces au repertoire source.

       --parallel
           Cette option active la construction parallele si le systeme sous-
           jacent le permet. Le nombre de taches paralleles est controle, lors
           de la construction, par la variable d'environnement
           DEB_BUILD_OPTIONS ("Charte Debian, section 4.9.1"). Ce nombre peut
           egalement etre soumis aux limites specifiques du systeme.

           Si cette option n'est pas specifiee, debhelper n'activera pas, par
           defaut, le parallelisme lors de la construction.

       --max-parallel=maximum
           Cette option implique --parallel et permet de limiter le nombre de
           taches qui pourront etre lancees lors d'une compilation parallele.
           Si la construction du paquet est connu pour ne fonctionner qu'avec
           un certain niveau de parallelisme, il est possible de le regler a
           la valeur maximum censee fonctionner, ou que vous souhaitez mettre
           en oeuvre.

       --list, -l
           Liste tous les processus de construction supporte par le systeme.
           Cette liste inclut a la fois les processus par defaut et les
           processus tiers (marques comme tels). Cette option montre egalement
           le processus de construction automatiquement selectionne ou celui
           specifie manuellement avec l'option --buildsystem.

COMPATABILITY LEVELS

       Parfois, des modifications majeures de debhelper doivent etre faites et
       vont briser la compatibilite ascendante. Ces modifications sont
       necessaires pour conserver a debhelper ses qualites de conception et
       d'ecriture, car les besoins changent et le savoir-faire de l'auteur
       s'ameliore. Pour eviter que de tels changements ne cassent les paquets
       existants, un concept de niveau de compatibilite debhelper a ete
       introduit. On precisera a debhelper le niveau de compatibilite qu'il
       doit employer ce qui modifiera son comportement de diverses manieres.

       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 compatibilite le plus recent, et, dans la
       plupart des cas ne precise pas si le comportement est different avec
       les niveaux de compatibilite anterieurs. De ce fait, si le niveau de
       compatibilite le plus recent n'est pas celui utilise, il est fortement
       conseille de lire les indications ci-dessous qui exposent les
       differences dans les niveaux de compatibilite anterieurs.

       Les niveaux de compatibilite sont les suivants:

       v1  C'est le niveau initial de compatibilite de debhelper d'ou son
           numero 1. Dans ce mode, debhelper emploiera debian/tmp comme
           repertoire de l'arborescence du premier paquet binaire enumere dans
           le fichier control et << debian/paquet >> pour tous les autres.

           Ce mode est deconseille.

       v2  Dans ce mode, debhelper emploiera uniformement << debian/paquet >>
           comme repertoire de l'arborescence de chaque paquet construit.

           Ce mode est deconseille.

       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 desactiver cette
                   substitution et utiliser ces caracteres tels quels, il
                   suffit de les prefixer avec une barre contre-oblique
                   (backslash).

           -       Les scripts de maintenance du paquet (postinst et postrm)
                   feront appel a ldconfig quand dh_makeshlibs sera lance.

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

           Ce mode est deconseille.

       v4  Les changements par rapport a la version 3 sont:

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

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

           -       dh_fixperms rendra executables tous les fichiers des
                   repertoires bin/ et etc/init.d.

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

           Ce mode est deconseille.

       v5  Les changements par rapport a la version 4 sont:

           -       Les commentaires sont ignores 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'ou proviennent ces symboles.

           -       dh_installdocs saute l'installation des fichiers vides.

           -       dh_install genere des erreurs si les jokers (wildcards) ne
                   correspondent a rien.

       v6  Les changements par rapport a la version 5 sont:

           -       Les commandes qui generent 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 repertoire usr/share/man/man1 du repertoire
                   de construction du paquet.

           -       dh_builddeb, prealablement, ne supprimait pas les
                   associations crees avec DH_ALWAYS_EXCLUDE s'il etait
                   configure sur une liste d'elements tels que CVS:.svn:.git.
                   Maintenant il le fait.

           -       Dh_installman permet d'ecraser les pages de man existantes
                   dans le repertoire de construction du paquet.
                   Prealablement, il refusait en silence de le faire.

       v7  Les changements par rapport a la version 6 sont:

           -       dh_install cherchera recursivement les fichiers dans
                   debian/tmp s'il ne les trouve pas dans le repertoire
                   courant (ou dans le repertoire specifie par --sourcedir).
                   Cela permet a dh_install d'interoperer avec
                   dh_auto_install, qui place les fichiers dans debian/tmp,
                   sans necessiter de parametres particuliers.

           -       dh_clean lit le repertoire debian/clean et supprime les
                   fichiers qui y sont mentionnes.

           -       dh_clean supprime les fichiers *-stamp.

           -       dh_installchangelogs determinera a quel fichier correspond
                   le changelog amont si rien n'est specifie.

       v8  Les changements par rapport a la version 7 sont:

           -       Les commandes echoueront plutot que de produire une alerte
                   lorsqu'elles recevront des options inconnues.

           -       dh_makeshlibs va executer le programme dpkg-gensymbols sur
                   toutes les bibliotheques partagees qu'il genere pour les
                   fichiers shlibs. -X peut alors etre utilise pour exclure
                   certaines bibliotheques. En outre, les bibliotheques
                   rangees a des emplacements inhabituels que pkg-gensymbols
                   n'aurait pas traitees avant qu'elles ne lui soient
                   transmises, induisent un changement de comportement qui
                   peut causer l'echec de la construction de certains paquets.

           -       dh exige que la sequence a executer soit specifiee en tant
                   que premier parametre. Tous les commutateurs doivent venir
                   apres. C'est a dire qu'il faut ecrire <<dh$@--toto>>, et
                   non <<dh--toto$@>>

           -       Dh_auto_* utilise preferentiellement Module::Build de Perl
                   au lieu de Makefile.PL.

       v9  C'est la version dont l'usage est recommande.

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

       Pour resoudre ce probleme, et pour un meilleur controle 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 precisee, les programmes de debhelper
       construisent tous les paquets enumeres dans le fichier de controle.

   G'en'eration 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# a
       l'endroit ou les lignes de code generees devront etre inserees.
       #DEBHELPER# sera remplace, par les lignes de code generees
       automatiquement, lors de l'execution de dh_installdeb.

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

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

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

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

   G'en'eration automatique des diverses d'ependances.
       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 dependances qu'elle induisent, genereront
       automatiquement une variable de substitution nommee ${misc:depends}. Si
       cette variable est exploitee dans le dossier debian/control, il sera
       automatiquement enrichi des dependances induites par debhelper.

       Ce processus est entierement independant de ${shlibs:Depends} standard,
       produite par dh_makeshlibs(1), et de ${perl:Depends} produite par
       dh_perl(1). Il est egalement possible de choisir de ne pas les utiliser
       si les conjectures de debhelper ne correspondent pas a la realite.

   R'epertoires de construction du paquet
       Par defaut, tous les programmes de debhelper supposent que le
       repertoire temporaire utilise pour construire l'arborescence des
       fichiers d'un paquet est debian/paquet.

       Parfois, il peut etre souhaitable d'utiliser un autre repertoire
       temporaire. Ceci est obtenu grace au parametre -P. Par exemple,
       dh_installdocs-Pdebian/tmp utilisera debian/tmp comme repertoire
       temporaire. Nota: L'usage de -P implique que les programmes de
       debhelper ne construisent qu'un seul paquet a la fois. De ce fait, si
       le paquet source genere plusieurs paquets binaires, il faudra employer
       egalement le parametre -p pour preciser l'unique paquet binaire a
       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 a 1 valide le mode verbeux. Debhelper
           affichera chaque commande executee qui modifie des fichiers.

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

       DH_NO_ACT
           Mettre cette variable a 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 possede une valeur, elle sera ajoutee a l'option
           -X de toutes les commandes qui admettent cette option. De plus,
           dh_builddeb fera un rm -rf quelque chose, correspondant a la valeur
           dans l'arbre de construction de paquet.

           Ceci peut etre utile pour construire un paquet a partir d'une
           arborescence CVS. Dans ce cas, le reglage de DH_ALWAYS_EXCLUDE=CVS
           empechera les repertoires CVS d'interferer subrepticement dans le
           paquet en construction. Ou, si un paquet possede une source
           compressee, (maladroitement) presente dans un repertoire CVS, il
           peut etre utile d'exporter DH_ALWAYS_EXCLUDE=CVS dans debian/rules,
           pour que cette variable soit prise en compte quel que soit
           l'endroit ou le paquet est construit.

           Des exclusions multiples peuvent etre separees avec des caracteres
           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

       Valery Perrin <valery.perrin.debian@free.fr> le 17 septembre 2005.
       Derniere mise a jour le 3 avril 2011.

       L'equipe de traduction a fait le maximum pour realiser une adaptation
       francaise de qualite.

       Cette traduction est geree dynamiquement par po4a. Certains paragraphes
       peuvent, eventuellement, apparaitre en anglais. Ils correspondent a des
       modifications ou des ajouts recents du mainteneur, non encore
       incorpores dans la traduction francaise.

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

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