NOM

       dh_installdebconf - Installer les fichiers utilisés par debconf dans les répertoires de
       construction du paquet

SYNOPSIS

       dh_installdebconf [options_de_debhelper] [-n] [-- paramètres]

DESCRIPTION

       dh_installdebconf est le programme de la suite debhelper chargé d'installer les fichiers
       utilisés par debconf dans les répertoires de construction du paquet.

       Il génère également automatiquement les lignes de code du script de maintenance postrm
       nécessaires à l'interfaçage avec debconf. Les commandes sont ajoutées aux scripts de
       maintenance par dh_installdeb. Consulter dh_installdeb(1) pour obtenir une explication sur
       le mécanisme d'insertion de lignes de code.

       Nota : Comme un paquet qui utilise debconf a probablement besoin d'en dépendre, ce
       programme ajoute cette dépendance à ${misc:Depends}.

       Nota : Étant donné que le script de configuration est invoqué par dpkg, postinst doit
       comporter le module de configuration (confmodule) de debconf. dh_installdebconf
       n'implémente pas automatiquement ce traitement dans le script de maintenance postinst car
       ce serait trop difficile à faire correctement.

FICHIERS

       debian/paquet.config
           C'est le script config de debconf. Il est installé dans le répertoire DEBIAN du
           répertoire de construction du paquet.

           Dans le script, l'item #DEBHELPER# est remplacé par les lignes de code générées par
           les autres commandes debhelper.

       debian/paquet.templates
           C'est le fichier templates de debconf. Il est installé dans le répertoire DEBIAN du
           répertoire de construction du paquet.

       debian/po/
           Si ce répertoire existe, ce programme utilisera po2debconf(1) pour produire un fichier
           multilingue de modèles.

           Pour que cela fonctionne, le paquet doit dépendre, pour sa construction (build-
           depend), de po-debconf.

OPTIONS

       -n, --no-scripts
           Empêche la modification du script de maintenance postrm.

       -- paramètres
           Passe les paramètres à po2debconf.

       -DITEM=VALEUR, --define ITEM=VALEUR
           Définit les items qui doivent être remplacés dans les scripts du responsable quand ils
           sont créés. Veuillez noter que les contraintes décrites dans "Restrictions dans les
           noms d'item" s'appliquent aussi aux items définis en ligne de commande. Les noms
           d'item non valables déclencheront une erreur.

           Dans un cas simple, ce paramètre fera que #ITEM# sera remplacé par VALEUR. Si VALEUR
           commence par un signe @ littéral, alors VALEUR est censé pointer vers un fichier
           contenant la valeur réelle à insérer.

           Un item déclaré de façon explicite avec ce paramètre remplacera les items internes.

           Exemples de tests pour aider à mieux comprendre :

                   cat >> debian/config <<EOF
                   #SIMPLE#
                   #FILEBASED#
                   EOF
                   echo -n "Complex value" > some-file
               dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file

           Dans cet exemple, #SIMPLE# sera développé en direct et #FILEBASED# sera développé en
           valeur_complexe.

           It is also possible to set package-specific values for a given token. This is useful
           when dh_installdebconf is acting on multiple packages that need different values for
           the same token. This is done by prefixing the token name with pkg.package-name..

           Cela peut être utilisé comme dans l'exemple suivant :

                   cat >> debian/foo.config <<EOF
                   # Script for #PACKAGE#
                   #TOKEN#
                   EOF
                   cat >> debian/bar.config <<EOF
                   # Script for #PACKAGE#
                   #TOKEN#
                   EOF
                   cat >> debian/baz.config <<EOF
                   # Script for #PACKAGE#
                   #TOKEN#
                   EOF
               dh_installdebconf -pfoo -pbar -pbaz  --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \
                 --define pkg.baz.TOKEN=unique-baz-value

           In this example, #TOKEN# will expand to default in debian/foo.config, to unique-bar-
           value in debian/bar.config and to unique-baz-value in debian/baz.config.

           Note that the #pkg.*# tokens will be visible in all scripts acted on. E.g. you can
           refer to #pkg.bar.TOKEN# inside debian/foo.config and it will be replaced by unique-
           bar-value.

SUBSTITUTION DANS LES SCRIPTS DU RESPONSABLE

       The dh_installdebconf will automatically replace the following tokens inside a provided
       maintainer script (if not replaced via -D/--define):

       #DEB_HOST_NOM#, #DEB_BUILD_NOM#, #DEB_TARGET_NOM#
           Ces items sont remplacés par leur variable respective venant de dpkg-architecture(1).
           Dans presque tous les cas, vous voudrez utiliser la variante #DEB_HOST_NOM dans un
           script pour vous assurer d'obtenir la valeur correcte lors d'une construction croisée.

           Dans un souci de qualité, les items avec ce motif qui ne correspondent pas à une
           variable de dpkg-architecture(1) seront laissés tels quels.

       #ENV.NOM#
           Les items de cette forme seront remplacés par la valeur de la variable d'environnement
           correspondante. Si la variable d'environnement n'est pas définie, l'item est remplacé
           par une chaîne vide.

           Notez qu'il y a des restrictions sur les noms pouvant être utilisés voir "Restrictions
           dans les noms d'item").

       #PACKAGE#
           Cet item est remplacé par défaut par le nom du paquet qui contiendra le script réel.

   Restrictions dans les noms d'item
       Tous les items destinés à être remplacés doivent correspondre à l'expression rationnelle :
       #[A-Za-z0-9_.+]+#

       Tokens that do not match that regex will be silently ignored if found in the script
       template. Invalid token names passed to -D or --define will cause dh_installdebconf to
       reject the command with an error in most cases.

VOIR AUSSI

       debhelper(7)

       Ce programme fait partie de debhelper.

AUTEUR

       Joey Hess <joeyh@debian.org>

TRADUCTION

       Cette traduction est maintenue à l'aide de l'outil po4a
       <URL:http://po4a.alioth.debian.org/> par l'équipe francophone de traduction de Debian.

       Veuillez signaler toute erreur de traduction en écrivant à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet debhelper.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».