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> ».

13.14.1ubuntu5                                     2024-03-01                               DH_INSTALLDEBCONF(1)