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.
Dans le script, l'item #DEBHELPER# est remplacé par les lignes de code générées par les autres commandes debhelper.
Pour que cela fonctionne, le paquet doit dépendre, pour sa construction (build-depend), de po-debconf.
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.
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.
Notez qu'il y a des restrictions sur les noms pouvant être utilisés voir ``Restrictions dans les noms d'item'').
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.
Ce programme fait partie de debhelper.
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> ».