Também gera automaticamente os comandos postrm necessários para a interface com o debconf. Os comandos são adicionados aos scripts do maintainer pelo dh_installdeb. Veja dh_installdeb(1) para uma explicação de como isso funciona.
Note que se você usar debconf, provavelmente o seu pacote precisa de depender disso (será adicionado a ${misc:Depends} por este programa).
Note que para o seu script de configuração ser chamado pelo <dpkg>, o seu postinst precisa de partir do módulo de configuração do debconf, o dh_installdebconf não instala esta declaração no postinst automaticamente porque é muito difícil de o fazer correctamente.
Dentro do script, o token #DEBHELPER# é substituído por fragmentos de script shell gerados por outros comandos do debhelper.
Para que isto funcione, o seu pacote deve compilar dependendo de po-debconf.
No caso simples, este parâmetro irá causar com que #TOKEN# seja substituído por VALUE. Se VALUE começar com um @-sign literal, então espera-se que VALUE aponte para um ficheiro que contém o valor real a inserir.
Um token declarado explicitamente com este parâmetro irá substituir tokens embutidos.
Exemplos de testes para ajuda na compreensão:
cat >> debian/config <<EOF
#SIMPLE#
#FILEBASED#
EOF
echo -n "Complex value" > some-file
dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file
Neste exemplo, #SIMPLE# irá expandir para direct e #FILEBASED# irá expandir para Complex value.
É também possível definir valores específicos-de-pacote para um dado token. Isto é útil quando dh_installdebconf está a actuar em múltiplos pacotes que precisam de valores diferentes para o mesmo token. Isto é feito ao prefixar o nome do token com pkg.nome-do-pacote..
Isto pode ser usado como no exemplo seguinte:
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 que os tokens #pkg.*# irão ser visíveis em todos os scripts que actuem. Ex, você pode referir a #pkg.bar.TOKEN# dentro de debian/foo.config e ele será substituído por unique-bar-value.
Na melhor das hipóteses, tokens deste padrão que não correspondam a uma variável em dpkg-architecture(1) serão deixá-dos como estão.
Note que existem limites em quais nomes podem ser usados (veja ``Limitações nos nomes dos token'').
Tokens que não correspondam a esse regex serão ignorados em silêncio se encontrados no script modelo. Nomes de token inválidos passados a -D ou --define irão causar que o dh_installdebconf rejeite o comando com um erro na maioria dos casos.
Este programa é parte do debhelper.
Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro a_monteiro@gmx.com ou Equipa Debian de Tradução Portuguesa traduz@debianpt.org.