debconf 1.5.71 - en to pt translation catalogue (496 entries)

note: type: SH
en: NAME
pt: NOME

note: type: textblock
en: debconf - run a debconf-using program
pt: debconf - executa um programa usando debconf

note: type: SH
en: SYNOPSIS
pt: SINOPSE

note: type: verbatim
en:  debconf [options] command [args]
pt:  debconf [opções] comando [argumentos]

note: type: SH
en: DESCRIPTION
pt: DESCRIÇÃO

note: type: textblock
en: Debconf is a configuration system for Debian packages. For a debconf overview and documentation for sysadmins, see L<debconf(7)> (in the debconf-doc package).
pt: Debconf é um sistema de configuração para pacotes Debian. Para uma visão geral do debconf e documentação para administradores de sistemas, veja L<debconf(7)> (no pacote debconf-doc).

note: type: textblock
en: The B<debconf> program runs a program under debconf's control, setting it up to talk with debconf on stdio. The program's output is expected to be debconf protocol commands, and it is expected to read result codes on stdin. See L<debconf-devel(7)> for details about the debconf protocol.
pt: O programa B<debconf> executa um programa sob o controle do debconf, configurando-o para falar com o debconf em stdio. Espera-se que os resultados de saída do programa estejam em protocolo debconf, e espera-se ler códigos dos resultados no stdin. Veja L<debconf-devel(7)> para detalhes acerca do protocolo debconf.

note: type: textblock
en: The command to be run under debconf must be specified in a way that will let your PATH find it.
pt: O comando a executar sob debconf tem de ser especificado de modo que permita que a sua PATH o encontre.

note: type: textblock
en: This command is not the usual way that debconf is used. It's more typical for debconf to be used via L<dpkg-preconfigure(8)> or L<dpkg-reconfigure(8)>.
pt: Este comando não é o modo habitual de utilização do debconf. Tipicamente, é mais comum usar o debconf via L<dpkg-preconfigure(8)> ou L<dpkg-reconfigure(8)>.

note: type: =head1
en: OPTIONS
pt: OPÇÕES

note: type: textblock
en: Tell debconf what package the command it is running is a part of. This is necessary to get ownership of registered questions right, and to support unregister and purge commands properly.
pt: Diz ao debconf a qual pacote pertence o comando que está a executar. Isto é necessário para obter direitos de dono das questões registadas, e para suportar propriamente comandos não registados e purgados.

note: type: textblock
en: Select the frontend to use.
pt: Selecciona o frontend a usar.

note: type: textblock
en: Specify the minimum priority of question that will be displayed.
pt: Especifica a prioridade mínima da questão que vai ser mostrada.

note: type: textblock
en: Enables terse output mode. This affects only some frontends.
pt: Activa o modo de saída terse. Isto afecta apenas alguns frontends.

note: type: =head1
en: EXAMPLES
pt: EXEMPLOS

note: type: textblock
en: To debug a shell script that uses debconf, you might use:
pt: Para depurar um script shell que usa debconf, você pode usar:

note: type: verbatim
en:  DEBCONF_DEBUG=developer debconf my-shell-prog
pt:  DEBCONF_DEBUG=developer debconf meu-prog-shell

note: type: textblock
en: Or, you might use this:
pt: Ou, você pode usar isto:

note: type: verbatim
en:  debconf --frontend=readline sh -x my-shell-prog
pt:  debconf --frontend=readline sh -x meu-prog-shell

note: type: SH
en: SEE ALSO
pt: VEJA TAMBÉM

note: type: SH
en: AUTHOR
pt: AUTOR

note: type: textblock
en: Debconf::Client::ConfModule - client module for ConfModules
pt: Debconf::Client::ConfModule - módulo cliente para ConfModules

note: type: verbatim
en:  use Debconf::Client::ConfModule ':all';
     version('2.0');
     my $capb=capb('backup');
     input("medium", "foo/bar");
     my @ret=go();
     if ($ret[0] == 30) {
     	# Back button pressed.
     	...
     }
     ...
pt:  use Debconf::Client::ConfModule ':all';
     version('2.0');
     my $capb=capb('backup');
     input("medium", "foo/bar");
     my @ret=go();
     if ($ret[0] == 30) {
     	# Botão de retrocesso premido.
     	...
     }
     ...

note: type: textblock
en: This is a module to ease writing ConfModules for Debian's configuration management system. It can communicate with a FrontEnd via the debconf protocol (which is documented in full in the debconf_specification in Debian policy).
pt: Isto é um módulo para facilitar a escrita de ConfModules para o sistema de gestão de configuração de Debian. Pode comunicar com um FrontEnd através do protocolo debconf (que está documentado em completo na debconf_specification na política Debian).

note: type: textblock
en: The design is that each command in the protocol is represented by one function in this module (with the name lower-cased).  Call the function and pass in any parameters you want to follow the command. If the function is called in scalar context, it will return any textual return code. If it is called in list context, an array consisting of the numeric return code and the textual return code will be returned.
pt: É desenhado para que cada comando no protocolo seja representado por uma função neste módulo (com o nome em minúsculas). Chame a função e passe quaisquer parâmetros que desejar seguindo o comando. Se a função for chamada em contexto escalar, irá devolver qualquer código de retorno. Se for chamada em contexto de lista, será devolvida uma matriz consistindo dos códigos de retorno numéricos e dos códigos de retorno textuais.

note: type: textblock
en: This module uses Exporter to export all functions it defines. To import everything, simply import ":all".
pt: Este módulo usa Exporter para exportar todas as funções que define. Para importar tudo, simplesmente importe ":all".

note: type: =item
en: import
pt: importar

note: type: textblock
en: Ensure that a FrontEnd is running.  It's a little hackish. If DEBIAN_HAS_FRONTEND is set, a FrontEnd is assumed to be running.  If not, one is started up automatically and stdin and out are connected to it. Note that this function is always run when the module is loaded in the usual way.
pt: Assegura que um FrontEnd está a correr. É um desenrasque. Se DEBIAN_HAS_FRONTEND estiver definido, assume-se que um FrontEnd está em execução. Se não, é iniciado um automaticamente e o stdin e out são ligados a ele. Note que esta função está sempre em execução quando o módulo é carregado da maneira normal.

note: type: =item
en: stop
pt: parar

note: type: textblock
en: The frontend doesn't send a return code here, so we cannot try to read it or we'll block.
pt: Aqui o frontend não envia um código de retorno, portanto não podemos tentar lê-lo ou vamos bloquear.

note: type: =item
en: AUTOLOAD
pt: AUTOCARGA

note: type: textblock
en: Creates handler functions for commands on the fly.
pt: Cria na hora funções de manipulação para comandos.

note: type: textblock
en: The debconf specification (/usr/share/doc/debian-policy/debconf_specification.txt.gz).
pt: A especificação debconf (/usr/share/doc/debian-policy/debconf_specification.txt.gz).

note: type: textblock
en: debconf-apt-progress - install packages using debconf to display a progress bar
pt: debconf-apt-progress - instala pacotes usando o debconf para mostrar uma barra de progresso

note: type: verbatim
en:  debconf-apt-progress [--] command [args ...]
     debconf-apt-progress --config
     debconf-apt-progress --start
     debconf-apt-progress --from waypoint --to waypoint [--] command [args ...]
     debconf-apt-progress --stop
pt:  debconf-apt-progress [--] comando [argumentos ...]
     debconf-apt-progress --config
     debconf-apt-progress --start
     debconf-apt-progress --from waypoint --to waypoint [--] comando [argumentos ...]
     debconf-apt-progress --stop

note: type: textblock
en: B<debconf-apt-progress> installs packages using debconf to display a progress bar. The given I<command> should be any command-line apt frontend; specifically, it must send progress information to the file descriptor selected by the C<APT::Status-Fd> configuration option, and must keep the file descriptors nominated by the C<APT::Keep-Fds> configuration option open when invoking debconf (directly or indirectly), as those file descriptors will be used for the debconf passthrough protocol.
pt: B<debconf-apt-progress> instala pacotes usando o debconf para mostrar uma barra de progresso. O I<comando> fornecido deve ser qualquer frontend do apt de linha de comandos; especificamente, deve enviar informação do processo para o descritor de ficheiro seleccionado pela opção de configuração C<APT::Status-Fd>, e deve manter os descritores de ficheiro nomeados pela opção de configuração C<APT::Keep-Fds> abertos quando invoca o debconf (directamente ou indirectamente), porque esses descritores de ficheiro irão ser usados para o protocolo de passagem do debconf.

note: type: textblock
en: The arguments to the command you supply should generally include B<-y> (for B<apt-get> or B<aptitude>) or similar to avoid the apt frontend prompting for input. B<debconf-apt-progress> cannot do this itself because the appropriate argument may differ between apt frontends.
pt: Os argumentos para o comando que você forneça devem geralmente incluir B<-y> (para o B<apt-get> ou B<aptitude>) ou semelhante para evitar que o frontend do apt pare a aguardar entradas.  B<debconf-apt-progress> não pode fazer isto por si próprio porque o argumento apropriado pode diferir entre frontends do apt.

note: type: textblock
en: The B<--start>, B<--stop>, B<--from>, and B<--to> options may be used to create a progress bar with multiple segments for different stages of installation, provided that the caller is a debconf confmodule. The caller may also interact with the progress bar itself using the debconf protocol if it so desires.
pt: As opções B<--start>, B<--stop>, B<--from>, e B<--to> podem ser usadas para criar uma barra de progresso com múltiplos segmentos para os diferentes estágios de instalação, desde de que quem chama seja um confmodule debconf. O chamador também pode interagir com a barra de progresso usando o protocolo debconf se o desejar.

note: type: textblock
en: debconf locks its config database when it starts up, which makes it unfortunately inconvenient to have one instance of debconf displaying the progress bar and another passing through questions from packages being installed. If you're using a multiple-segment progress bar, you'll need to eval the output of the B<--config> option before starting the debconf frontend to work around this. See L<the EXAMPLES section/EXAMPLES> below.
pt: O debconf tranca a sua base de dados de configuração quando arranca, o que infelizmente torna inconveniente ter uma instância do debconf a mostrar a barra de progresso e outra a passar as perguntas do pacote que está a ser instalado. Se você está a usar uma barra de progresso de múltiplos segmentos, você tem que avaliar a saída da opção B<--config> antes de arrancar o frontend do debconf para contornar isto. Veja L<os EXEMPLOS na secção/EXEMPLOS> em baixo.

note: type: textblock
en: Print environment variables necessary to start up a progress bar frontend.
pt: Escreve as variáveis de ambiente necessárias para iniciar um frontend de barra de progresso.

note: type: textblock
en: Start up a progress bar, running from 0 to 100 by default. Use B<--from> and B<--to> to use other endpoints.
pt: Inicia uma barra de progresso, correndo por predefinição de 0 a 100. Use B<--from> and B<--to> para usar outros pontos de finalização.

note: type: textblock
en: If used with B<--start>, make the progress bar begin at I<waypoint> rather than 0.
pt: Se usado com  B<--start>, faz com que a barra de progresso comece em I<waypoint> em vez de 0.

note: type: textblock
en: Otherwise, install packages with their progress bar beginning at this "waypoint". Must be used with B<--to>.
pt: Caso contrário, instala os pacotes com a sua barra de progresso começando neste "waypoint". Tem de ser usado com B<--to>.

note: type: textblock
en: If used with B<--start>, make the progress bar end at I<waypoint> rather than 100.
pt: Se usado com B<--start>, faz com que a barra de progresso terminar em I<waypoint> em vez de 100.

note: type: textblock
en: Otherwise, install packages with their progress bar ending at this "waypoint". Must be used with B<--from>.
pt: Caso contrário, instala os pacotes com a sua barra de progresso terminando neste "waypoint". Tem de ser usado com B<--from>.

note: type: textblock
en: Stop a running progress bar.
pt: Pára uma barra de progresso em execução.

note: type: textblock
en: Avoid starting, stopping, or stepping the progress bar. Progress messages from apt, media change events, and debconf questions will still be passed through to debconf.
pt: Evita o arranque, paragem e passos da barra de progressos. As mensagens de progresso do apt, eventos de alteração de media, e perguntas do debconf serão mesmo assim passadas através do debconf.

note: type: textblock
en: Specify what percent of the progress bar to use for downloading packages.  The remainder will be used for installing packages. The default is to use 15% for downloading and the remaining 85% for installing.
pt: Especifica qual a percentagem da barra de progresso é usada para download de pacotes. O restante será usado para a instalação dos pacotes. A predefinição que se usa é 15% para o download e os restantes 85% para a instalação.

note: type: textblock
en: Send the normal output from apt to the given file.
pt: Envia a saída normal do apt para o ficheiro fornecido.

note: type: textblock
en: Send the normal output from apt to stderr. If you supply neither B<--logfile> nor B<--logstderr>, the normal output from apt will be discarded.
pt: Envia a saída normal do apt para o stderr. Se você não fornecer nem B<--logfile> nem B<--logstderr>, a saída normal do apt será descartada.

note: type: textblock
en: Terminate options. Since you will normally need to give at least the B<-y> argument to the command being run, you will usually need to use B<--> to prevent that being interpreted as an option to B<debconf-apt-progress> itself.
pt: Termina as opções. Como você normalmente precisa de fornecer pelo menos o argumento B<-y> ao comando que está a ser executado, normalmente irá precisar de usar B<--> para prevenir que isso seja interpretado como uma opção para o próprio B<debconf-apt-progress>.

note: type: textblock
en: Install the GNOME desktop and an X window system development environment within a progress bar:
pt: Instala o ambiente de trabalho GNOME e um ambiente de desenvolvimento do sistema de janelas X dentro duma barra de progresso:

note: type: textblock
en: Install the GNOME, KDE, and XFCE desktops within a single progress bar, allocating 45% of the progress bar for each of GNOME and KDE and the remaining 10% for XFCE:
pt: Instala os ambientes GNOME, KDE e XFCE dentro duma única barra de progresso, alocando 45% da barra de progresso para cada GNOME e KDE e os restantes 10% para o XFCE:

note: type: =head1
en: RETURN CODE
pt: CÓDIGO DE RETORNO

note: type: textblock
en: The exit code of the specified command is returned, unless the user hit the cancel button on the progress bar. If the cancel button was hit, a value of 30 is returned. To avoid ambiguity, if the command returned 30, a value of 3 will be returned.
pt: O código de saída do comando especificado é devolvido, a menos que o utilizador carregue no botão 'cancelar' na barra de progresso. Se o botão' cancelar' for carregado, é devolvido um valor de 30. Para evitar ambiguidade, se o comando devolver 30, é devolvido um valor de 3.

note: type: =head1
en: AUTHORS
pt: AUTORES

note: type: textblock
en: debconf-escape - helper when working with debconf's escape capability
pt: debconf-escape - ajuda quando se trabalha com a capacidade de escape do debconf

note: type: textblock
en: When debconf has the 'escape' capability set, it will expect commands you send it to have backslashes and newlines escaped (as C<\\> and C<\n> respectively) and will in turn escape backslashes and newlines in its replies. This can be used, for example, to substitute multi-line strings into templates, or to get multi-line extended descriptions reliably using C<METAGET>.
pt: Quando o debconf tem a capacidade 'escape' definida, irá esperar que os comandos que você envie tenham barras invertidas escapes de novas linhas (como C<\\> e C<\n> respectivamente) e irá dobrar as barras invertidas e novas linhas nas suas respostas. Isto pode ser usado, por exemplo, para substituir strings de múltiplas linhas em templates, ou para obter descrições extensivas de múltiplas linhas com segurança usando C<METAGET>.

note: type: textblock
en: L<debconf-devel(7)> (available in the debconf-doc package)
pt: L<debconf-devel(7)> (disponível no pacote debconf-doc)

note: type: textblock
en: debconf-communicate - communicate with debconf
pt: debconf-communicate - comunicar com o debconf

note: type: verbatim
en:  echo commands | debconf-communicate [options] [package]
pt:  echo comandos | debconf-communicate [opções] [pacote]

note: type: textblock
en: B<debconf-communicate> allows you to communicate with debconf on the fly, from the command line. The package argument is the name of the package which you are pretending to be as you communicate with debconf, and it may be omitted if you are lazy. It reads commands in the form used by the debconf protocol from stdin. For documentation on the available commands and their usage, see the debconf specification.
pt: B<debconf-communicate> permite-lhe comunicar com o debconf na hora, a partir da linha de comandos. O argumento package é o nome do pacote o qual você finge ser quando comunica com o debconf, e pode ser omitido se você for preguiçoso. Lê comandos no formato usado pelo protocolo debconf a partir do stdin. Para documentação sobre os comandos disponíveis e a sua utilização, veja a especificação debconf.

note: type: textblock
en: The commands are executed in sequence. The textual return code of each is printed out to standard output.
pt: Os comandos são executados em sequência. O código de retorno textual de cada é escrito na saída standard.

note: type: textblock
en: The return value of this program is the numeric return code of the last executed command.
pt: O valor devolvido deste programa é o código de retorno numérico do último comando executado.

note: type: SH
en: EXAMPLE
pt: EXEMPLO

note: type: textblock
en: Print out the value of the debconf/frontend question.
pt: Escreve o valor da questão debconf/frontend.

note: type: =head1
en: WARNING
pt: AVISO

note: type: textblock
en: This program should never be used from a maintainer script of a package that uses debconf! It may however, be useful in debugging.
pt: Este programa nunca deve ser usado a partir dum script de responsável de um pacote que use debconf! Pode, no entanto, ser útil em depuração.

note: type: textblock
en: debconf-copydb - copy a debconf database
pt: debconf-copydb - copia uma base de dados de debconf

note: type: verbatim
en:  debconf-copydb sourcedb destdb [--pattern=pattern] [--owner-pattern=pattern] [--config=Foo:bar]
pt:  debconf-copydb sourcedb destdb [--pattern=padrão] [--owner-pattern=padrão] [--config=Foo:bar]

note: type: textblock
en: B<debconf-copydb> copies items from an existing debconf database into another, possibly new database. The two databases may have different formats; if so a conversion will automatically be done.
pt: B<debconf-copydb> copia itens de uma base de dados debconf existente para outra base de dados, que possivelmente é nova. As duas bases de dados podem ter formatos diferentes; se sim, será automaticamente feita uma conversão.

note: type: textblock
en: The name of the source database. Typically it will be defined in your debconf.conf (or .debconfrc) file.
pt: O nome da base de dados fonte. Tipicamente será definido no seu ficheiro debconf.conf (ou .debconfrc).

note: type: textblock
en: The name of the destination database. It may be defined in debconf.conf or .debconfrc, or you might define it on the command line (see below).
pt: O nome da base de dados de destino. Pode ser definido em debconf.conf ou .debconfrc, ou você pode defini-lo an linha de comandos (veja em baixo).

note: type: textblock
en: If this is specified, only items in I<sourcedb> whose names match the pattern will be copied.
pt: Se isto for especificado, apenas serão copiados os itens em I<sourcedb> cujos nomes coincidam com o padrão.

note: type: textblock
en: If this is specified, only items in I<sourcedb> whose owners match the pattern will be copied.
pt: Se isto for especificado, apenas serão copiados os itens em I<sourcedb> cujos donos coincidam com o padrão.

note: type: textblock
en: Set option Foo to bar. This is similar to writing:
pt: Define a opção Foo para bar. Isto é semelhante a escrever:

note: type: textblock
en: In debconf.conf, except you probably want to leave off the space on the command line (or quote it: "Foo: bar"). Generally must be used multiple times, to build up a full configuration stanza. While blank lines are used to separate stanzas in debconf.conf, this program will assume that "Name:dbname" denotes the beginning of a new stanza.
pt: Em debconf.conf, excepto que você provavelmente vai querer deixar o espaço na linha de comandos (ou citá-lo "Foo: bar"). Geralmente tem de ser usado várias vezes, para construir uma estrofe de configuração completa. Enquanto as linhas vazias são usadas para separar as estrofes em debconf.conf, este programa irá assumir que "Name:dbname" denota o inicio de de uma nova estrofe.

note: type: textblock
en: Copy all of configdb to backup, assuming you already have the backup database defined in debconf.conf.
pt: Copia tudo do configdb para o backup, assumindo que você já tem a base de dados de backup definida em debconf.conf.

note: type: textblock
en: Copy slrn's data out of configdb, and into newdb. newdb is not defined in the rc file, so the --config switches set up the database on the fly.
pt: Copia dados do slrn fora do configdb, e para newdb. newdb não é definido no ficheiro rc, portanto os switches --config definem a base de dados na hora.

note: type: textblock
en: Spit out all the items in the debconf database related to package foo.
pt: Cospe todos os itens na base de dados do debconf relacionados com o pacote foo.

note: type: textblock
en: This uses the special purpose pipe driver to copy a database to a remote system.
pt: Isto usa uma driver pipe de objectivo especial para copiar a base de dados para um sistema remoto.

note: type: textblock
en: debconf-getlang - extract a language from a templates file
pt: debconf-getlang - extrai uma linguagem a partir de um ficheiro de templates

note: type: textblock
en: Note: This utility is deprecated; you should switch to using the po-debconf package.
pt: Nota: Este utilitário está obsoleto; você deve passar a usar o pacote po-debconf.

note: type: textblock
en: This program helps make and manage translations of debconf templates.  There are basically three situations in which this program might be called:
pt: Este programa ajuda a criar e a gerir traduções de templates debconf. Basicamente existem três situações nas quais este programa pode ser chamado:

note: type: =item
en: A translation is just being started.
pt: Uma tradução foi agora iniciada.

note: type: textblock
en: You want to provide the translator with a file they can work on that has the English fields from your templates file, plus blank Field-ll fields for the target language that they can fill in.
pt: Você quer fornecer aos tradutores um ficheiro que eles possam trabalhar que tem os campos em Inglês do ficheiro templates, mais campos Field-ll vazios para a linguagem de destino que eles vão preencher.

note: type: textblock
en: To do this, run the program with first parameter being the code for the language that is being translated to, and the second parameter being the filename of the English templates file.
pt: Para fazer isto, execute o programa com o primeiro parâmetro a ser o código da linguagem para a qual se está a traduzir, e o segundo parâmetro sendo o nome do ficheiro do ficheiro de templates em Inglês.

note: type: =item
en: A translation is well under way.
pt: Uma tradução está em curso.

note: type: textblock
en: You have changed some English text, or added more items to your templates file, and you want to send the translators a file with the English text plus their current translations (or you are the translator, and you want to generate such a file for your own use).
pt: Você alterou algum texto em Inglês, ou adicionou mais itens ao seu ficheiro templates, e quer enviar aos tradutores um ficheiro com o texto em Inglês mais as suas traduções actuais (ou você é o tradutor e quer gerar tal ficheiro para seu próprio uso).

note: type: textblock
en: To accomplish this, run the program with the first parameter being the the code for the language that is being translated to, the second parameter being the filename of the master English templates file, and the third parameter being the filename of the current translated file.
pt: Para fazer isto, execute o programa com o primeiro parâmetro a ser o código da linguagem para a qual se está a traduzir, o segundo parâmetro sendo o nome do ficheiro do ficheiro de templates mestre em Inglês, e o terceiro parâmetro sendo o nome do ficheiro traduzido actual.

note: type: textblock
en: When run this way, the program is smart enough to notice fuzzy translations. For example a fuzzy Description will be output as Description-<lang>-fuzzy, and a new, blank Description-<lang> will be added.  Translators should remove the -fuzzy fields as they correct the fuzzy translations.
pt: Quando corre deste modo, o programa é suficientemente inteligente para detectar traduções fuzzy (aproximadas). Por exemplo, uma descrição fuzzy será mostrada como Description-<lang>-fuzzy, e será adicionado uma nova Description-<lang> em branco. Os tradutores devem remover os campos -fuzzy e corrigir as traduções marcadas com fuzzy.

note: type: =item
en: Checking the status of a translation
pt: A verificar o estado duma tradução

note: type: textblock
en: To check the status of a translation, use the --status flag, and pass the english template file as the first parameter, and all the other translated templates after that. It will output statistics for each of them. For example:
pt: Para verificar o estado duma tradução, use a bandeira --status, e passe o ficheiro template Inglês como o primeiro parâmetro, e todos os outros templates traduzidos depois disso. Irá gerar estatísticas para cada um deles. Por exemplo:

note: type: =head1
en: NOTE
pt: NOTA

note: type: textblock
en: Note that the text in the generated templates may be word-wrapped by debconf.
pt: Note que o texto nos templates gerados pode ter as linhas arrumadas relativamente a palavras pelo debconf.

note: type: textblock
en: debconf-get-selections - output contents of debconf database
pt: debconf-get-selections - escreve o conteúdo da base de dados do debconf

note: type: textblock
en: Output the current debconf database in a format understandable by debconf-set-selections.
pt: Gera a base de dados debconf actual num formato compreensível por debconf-set-selections.

note: type: textblock
en: To dump the debconf database of the debian-installer, from /var/log/installer/cdebconf, use the --installer parameter.
pt: Para abandonar a base de dados debconf do debian-installer a partir de /var/log/installer/cdebconf, use o parâmetro --installer.

note: type: textblock
en: debconf-loadtemplate - load template file into debconf database
pt: debconf-loadtemplate - carrega ficheiro template na base de dados do debconf

note: type: verbatim
en:  debconf-loadtemplate owner file [file ..]
pt:  debconf-loadtemplate dono ficheiro [ficheiro ..]

note: type: textblock
en: Loads one or more template files into the debconf database. The first parameter specifies the owner of the templates (typically, the owner is the name of a debian package). The remaining parameters are template files to load.
pt: Carrega um ou mais ficheiros templates na base de dados debconf. O primeiro parâmetro especifica o dono dos templates (tipicamente, o dono é nome do pacote debian). Os parâmetros restantes são ficheiros template para carregar.

note: type: textblock
en: This program should never be used from a maintainer script of a package that uses debconf! It may however, be useful in debugging, or to seed the debconf database.
pt: Este programa nunca deve ser usado a partir dum script de responsável de um pacote que use debconf! Pode, no entanto, ser útil em depuração, ou para semear a base de dados debconf.

note: type: textblock
en: debconf-mergetemplate - merge together multiple debconf template files
pt: debconf-mergetemplate - junta múltiplos ficheiros template de debconf

note: type: verbatim
en:  debconf-mergetemplate [options] [templates.ll ...] templates
pt:  debconf-mergetemplate [opções] [templates.ll ...] templates

note: type: textblock
en: Note: This utility is deprecated. You should switch to using po-debconf's po2debconf program.
pt: Nota: Este utilitário está obsoleto. Você deve passar a usar o programa po2debconf do po-debconf.

note: type: textblock
en: This program is useful if you have multiple debconf templates files which you want to merge together into one big file. All the specified files will be read in, merged, and output to standard output.
pt: Este programa é útil se tiver múltiplos ficheiros templates de debconf que quer juntar todos num ficheiro grande. Todos os ficheiros especificados serão lidos, juntos, e enviados para a saída standard.

note: type: textblock
en: This can be especially useful if you are dealing with translated template files. In this case, you might have your main template file, plus several other files provided by the translators. These files will have translated fields in them, and maybe the translators left in the english versions of the fields they translated, for their reference.
pt: Isto pode ser especialmente útil se você está a lidar com ficheiros template traduzidos. Neste caso, você pode ter o seu ficheiro template principal, mais outros vários ficheiros disponibilizados por tradutores. Estes ficheiros irão ter campos traduzidos neles, e talvez os tradutores tenham deixado as versões em Inglês dos campos que traduziram, para sua referência.

note: type: textblock
en: So, you want to merge together all the translated templates files with your main templates file. Any fields that are unique to the translated files need to be added in to the correct templates, but any fields they have in common should be superseded by the fields in the main file (which might be more up-to-date).
pt: Portanto, você deseja juntar todos os ficheiros templates traduzidos no seu ficheiro templates principal. Quaisquer campos que apenas existam nos ficheiros traduzidos precisam ser adicionados aos templates correctos, mas quaisquer campos que eles tenham em comum deve ser substituídos pelos campos do ficheiro principal (que os quais pode estar mais actualizados).

note: type: textblock
en: This program handles that case properly, just list each of the translated templates files, and then your main templates file last.
pt: Este programa lida com esse caso apropriadamente, apenas liste cada ficheiro template traduzido, e depois o seu ficheiro template principal no fim.

note: type: textblock
en: Merge in even outdated translations. The default is to drop them with a warning message.
pt: Funde até traduções desactualizadas. A predefinição é abandoná-las com uma mensagem de aviso.

note: type: textblock
en: If a translation has an entire template that is not in the master file (and thus is probably an old template), drop that entire template.
pt: Se uma tradução tem um template inteiro que não está no ficheiro mestre (e por isso é provavelmente um template antigo), abandona esse template inteiro.

note: type: textblock
en: debconf-set-selections - insert new values into the debconf database
pt: debconf-set-selections - insere novos valores na base de dados do debconf

note: type: verbatim
en:  debconf-set-selections file
     debconf-get-selections | ssh newhost debconf-set-selections
pt:  debconf-set-selections ficheiro
     debconf-get-selections | ssh newhost debconf-set-selections

note: type: textblock
en: B<debconf-set-selections> can be used to pre-seed the debconf database with answers, or to change answers in the database. Each question will be marked as seen to prevent debconf from asking the question interactively.
pt: B<debconf-set-selections> pode ser usado para pré-semear a base de dados debconf com respostas, ou para modificar as respostas na base de dados. Cada questão será marcada como 'vista' para prevenir o debconf de perguntar a questão interactivamente.

note: type: textblock
en: Reads from a file if a filename is given, otherwise from stdin.
pt: Lê a partir dum ficheiro de um nome de ficheiro é fornecido, caso contrário a partir do stdin.

note: type: textblock
en: Only use this command to seed debconf values for packages that will be or are installed. Otherwise you can end up with values in the database for uninstalled packages that will not go away, or with worse problems involving shared values. It is recommended that this only be used to seed the database if the originating machine has an identical install.
pt: Use apenas este comando para semear valores de debconf para pacotes que irão ser ou estão instalados. Caso contrário você pode acabar com valores na base de dados para pacotes desinstalados que não desaparecem, ou com problemas piores que envolvem valores partilhados. É recomendado que isto apenas seja usado para semear a base de dados se a máquina original tiver uma instalação idêntica.

note: type: =head1
en: DATA FORMAT
pt: FORMATO DE DADOS

note: type: textblock
en: The data is a series of lines. Lines beginning with a # character are comments. Blank lines are ignored. All other lines set the value of one question, and should contain four values, each separated by one character of whitespace. The first value is the name of the package that owns the question. The second is the name of the question, the third value is the type of this question, and the fourth value (through the end of the line)  is the value to use for the answer of the question.
pt: Os dados são uma série de linhas. As linhas começadas com o caractere # são comentários. As linhas vazias são ignoradas. Todas as outras linhas definem o valor de uma questão, e deve conter quatro valores, cada um separado por um caractere de espaço em branco. O primeiro valor é o nome do pacote que possui a questão. O segundo é o nome da questão, o terceiro valor é o tipo de questão, e o quarto valor (até ao fim da linha) é o valor a usar para a resposta à questão.

note: type: textblock
en: Alternatively, the third value can be "seen"; then the preseed line only controls whether the question is marked as seen in debconf's database. Note that preseeding a question's value defaults to marking that question as seen, so to override the default value without marking a question seen, you need two lines.
pt: Alternativamente, o terceiro valor pode ser "visto"; então a linha precedente apenas controla se a questão está marcada como vista na base de dados do debconf. Note que para preceder os valores predefinidos de uma questão para marcar essa questão como vista, portanto para sobrepor o valor predefinido sem marcar a questão como vista, você precisa de duas linhas.

note: type: textblock
en: Lines can be continued to the next line by ending them with a "\" character.
pt: As linhas podem continuar para a próxima linha ao acabarem com o caractere "\".

note: type: verbatim
en:  # Force debconf priority to critical.
     debconf debconf/priority select critical
pt:  # Força a prioridade do debconf para crítica.
     debconf debconf/priority select critical

note: type: verbatim
en:  # Override default frontend to readline, but allow user to select.
     debconf debconf/frontend select readline
     debconf debconf/frontend seen false
pt:  # Sobrepõe o frontend predefinido para readline, mas permite ai utilizador seleccionar.
     debconf debconf/frontend select readline
     debconf debconf/frontend seen false

note: type: textblock
en: verbose output
pt: saída detalhada

note: type: textblock
en: only check the input file format, do not save changes to database
pt: apenas verifica o formato do ficheiro de entrada, não guarda alterações na base de dados

note: type: textblock
en: L<debconf-get-selections(1)> (available in the debconf-utils package)
pt: L<debconf-get-selections(1)> (disponível no pacote debconf-utils)

note: type: textblock
en: debconf-show - query the debconf database
pt: debconf-show - questiona a base de dados debconf

note: type: verbatim
en:  debconf-show packagename [...] [--db=dbname]
     debconf-show --listowners [--db=dbname]
     debconf-show --listdbs
pt:  debconf-show nome-de-pacote [...] [--db=dbname]
     debconf-show --listowners [--db=dbname]
     debconf-show --listdbs

note: type: textblock
en: B<debconf-show> lets you query the debconf database in different ways.
pt: B<debconf-show> permite-lhe questionar a base de dados debconf de diferentes maneiras.

note: type: textblock
en: The most common use is "debconf-show packagename", which displays all items in the debconf database owned by a given package, and their current values.  Questions that have been asked already are prefixed with an '*'.
pt: A utilização mais comum é "debconf-show nome-do-pacote", o que mostra todos os itens na base de dados debconf possuídos pelo dado pacote, e os seus valores actuais. As questões que já foram respondidas são prefixadas com um '*'.

note: type: textblock
en: This can be useful as a debugging aid, and especially handy in bug reports involving a package's use of debconf.
pt: Isto pode ser útil como ajuda na depuração, e especialmente habilidoso em relatórios de bugs que envolvam a utilização de debconf por um pacote.

note: type: textblock
en: Specify the database to query. By default, debconf-show queries the main database.
pt: Especifica a base de dados a questionar. Por predefinição, debconf-show questiona a base de dados principal.

note: type: textblock
en: Lists all owners of questions in the database. Generally an owner is equivalent to a debian package name.
pt: Lista todos os donos de questões na base de dados. Geralmente um dono é equivalente a um nome de um pacote debian.

note: type: textblock
en: Lists all available databases.
pt: Lista todas as bases de dados disponíveis.

note: type: textblock
en: Joey Hess <joeyh@debian.org> and Sylvain Ferriol
pt: Joey Hess <joeyh@debian.org> e Sylvain Ferriol

note: type: textblock
en: dpkg-preconfigure - let packages ask questions prior to their installation
pt: dpkg-preconfigure - permite que os pacotes façam perguntas antes da sua instalação

note: type: verbatim
en:  dpkg-preconfigure [options] package.deb
pt:  dpkg-preconfigure [opções] pacote.deb

note: type: textblock
en: B<dpkg-preconfigure> lets packages ask questions before they are installed.  It operates on a set of debian packages, and all packages that use debconf will have their config script run so they can examine the system and ask questions.
pt: B<dpkg-preconfigure> permite que os pacotes façam perguntas antes de serem instalados. Opera num conjunto de pacotes debian, e todos os pacotes que usam debconf terão o seu script config executado para que possam examinar o sistema e fazer perguntas.

note: type: textblock
en: Set the lowest priority of questions you are interested in. Any questions with a priority below the selected priority will be ignored and their default answers will be used.
pt: Define a prioridade mais baixa das questões que lhe interessam. Quaisquer questões com uma prioridade abaixo da prioridade seleccionada serão ignoradas e serão usadas as suas respostas predefinidas.

note: type: textblock
en: Run in apt mode. It will expect to read a set of package filenames from stdin, rather than getting them as parameters. Typically this is used to make apt run dpkg-preconfigure on all packages before they are installed.  To do this, add something like this to /etc/apt/apt.conf:
pt: Corre em modo apt. Irá esperar ler um conjunto de nomes de ficheiros de pacotes a partir do stdin, em vez de os obter como parâmetros. Tipicamente isto é usado para fazer com que o apt corra o dpkg-preconfigure em todos os pacotes antes de eles serem instalados. Para fazer isto, adicione algo como isto ao /etc/apt/apt.conf:

note: type: verbatim
en:  // Pre-configure all packages before
     // they are installed.
     DPkg::Pre-Install-Pkgs {
     	"dpkg-preconfigure --apt --priority=low";
     };
pt:  // Pré-configura todos os pacotes antes
     // de estarem instalados.
     DPkg::Pre-Install-Pkgs {
     	"dpkg-preconfigure --apt --priority=low";
     };

note: type: textblock
en: Display usage help.
pt: Mostra a ajuda de utilização.

note: type: textblock
en: dpkg-reconfigure - reconfigure an already installed package
pt: dpkg-reconfigure - reconfigura um pacote já instalado

note: type: verbatim
en:  dpkg-reconfigure [options] packages
pt:  dpkg-reconfigure [opções] pacotes

note: type: textblock
en: B<dpkg-reconfigure> reconfigures packages after they have already been installed. Pass it the names of a package or packages to reconfigure. It will ask configuration questions, much like when the package was first installed.
pt: B<dpkg-reconfigure> reconfigura pacotes após eles já estarem instalados. Passe-lhe o nome do pacote ou pacotes a reconfigurar. Irá fazer perguntas de configuração, à semelhança de quando o pacote foi instalado pela primeira vez.

note: type: textblock
en: If you just want to see the current configuration of a package, see L<debconf-show(1)> instead.
pt: Se apenas deseja ver a configuração actual de um pacote, veja L<debconf-show(1)> em vez disto.

note: type: textblock
en: Select the frontend to use. The default frontend can be permanently changed by:
pt: Selecciona o frontend a usar. O frontend predefinido pode ser alterado permanentemente ao:

note: type: textblock
en: Note that if you normally have debconf set to use the noninteractive frontend, dpkg-reconfigure will use the dialog frontend instead, so you actually get to reconfigure the package.
pt: Note que se você normalmente tiver o debconf configurado para usar o frontend não-interactivo, o dpkg-reconfigure irá usar o frontend dialog, para que você realmente possa reconfigurar o pacote.

note: type: textblock
en: Specify the minimum priority of question that will be displayed.  dpkg-reconfigure normally shows low priority questions no matter what your default priority is. See L<debconf(7)> for a list.
pt: Especifica a prioridade mínima da questão que será mostrada. O dpkg-reconfigure normalmente mostra questões de baixa prioridade independentemente de qual seja a sua prioridade predefinida. Veja L<debconf(7)> para uma listagem.

note: type: textblock
en: Use whatever the default priority of question is, instead of forcing the priority to low.
pt: Usa qualquer que seja a prioridade predefinida da questão, em vez de forçar a prioridade para baixa.

note: type: textblock
en: By default, all questions are shown, even if they have already been answered. If this parameter is set though, only questions that have not yet been seen will be asked.
pt: Por predefinição, são mostradas todas as questões, mesmo que já tenham sido respondidas. Se este parâmetro for definido, apenas serão perguntadas as questões ainda não vistas.

note: type: textblock
en: Force dpkg-reconfigure to reconfigure a package even if the package is in an inconsistent or broken state. Use with caution.
pt: Força o dpkg-reconfigure a reconfigurar um pacote mesmo que o pacote esteja num estado quebrado ou inconsistente. Use com cuidado.

note: type: textblock
en: Prevent dpkg-reconfigure from reloading templates. Use with caution; this will prevent dpkg-reconfigure from repairing broken templates databases.  However, it may be useful in constrained environments where rewriting the templates database is expensive.
pt: Previne o dpkg-reconfigure de recarregar os templates. Use com cuidado, isto irá impedir o dpkg-reconfigure de reparar bases de dados de templates danificadas. No entanto, pode ser útil em ambientes constrangidos onde reescrever a base de dados de templates pode custar caro.

note: type: Plain text
en: debconf.conf - debconf configuration file
pt: debconf.conf - ficheiro de configuração de debconf

note: type: Plain text
en: Debconf is a configuration system for Debian packages. /etc/debconf.conf and ~/.debconfrc are configuration files debconf uses to determine which databases it should use. These databases are used for storing two types of information; dynamic config data the user enters into it, and static template data. Debconf offers a flexible, extensible database backend. New drivers can be created with a minimum of effort, and sets of drivers can be combined in various ways.
pt: Debconf é um sistema de configuração para pacotes Debian. /etc/debconf.conf e ~/.debconfrc são ficheiros de configuração que o debconf usa para determinar quais bases de dados deve usar. Estas bases de dados para armazenar dois tipos de informação; dados de configuração dinâmicos que o utilizador insere, e dados de template estáticos. O debconf oferece um backend de base de dados extensível e flexível. Podem ser criadas novas drivers com um esforço mínimo, e conjuntos de drivers podem ser combinados de várias maneiras.

note: type: Plain text
en:   # This is a sample config file that is
      # sufficient to use debconf.
      Config: configdb
      Templates: templatedb
pt:   # Este é um exemplo de ficheiro de configuração que é
      # suficiente para usar debconf.
      Config: configdb
      Templates: templatedb

note: type: SH
en: FILE FORMAT
pt: FORMATO DE FICHEIRO

note: type: Plain text
en: The format of this file is a series of stanzas, each separated by at least one wholly blank line. Comment lines beginning with a "#" character are ignored.
pt: O formato deste ficheiro é uma série de estrofes, cada uma separada por pelo menos uma linha completamente vazia. As linhas de comentários começadas com um caractere "#" são ignoradas.

note: type: Plain text
en: The first stanza of the file is special, is used to configure debconf as a whole. Two fields are required to be in this first stanza:
pt: A primeira estrofe do ficheiro é especial, é usada para configurar o debconf como uma entidade completa. São necessários dois campos nesta primeira estrofe:

note: type: Plain text
en: Specifies the name of the database from which to load config data.
pt: Especifica o nome da base de dados de onde carregar dados de configuração.

note: type: Plain text
en: Specifies the name of the database to use for the template cache.
pt: Especifica o nome da base de dados a usar para a cache de template.

note: type: Plain text
en: Additional fields that can be used include:
pt: Campos adicionais que podem ser usados incluem:

note: type: Plain text
en: The frontend Debconf should use, overriding any frontend set in the debconf database.
pt: O frontend que o Debconf deverá usar, sobrepondo qualquer definição de frontend na base de dados do debconf.

note: type: Plain text
en: The priority Debconf should use, overriding any priority set in the debconf database.
pt: A prioridade que o Debconf deve usar, sobrepondo-se a qualquer prioridade definida na base de dados debconf.

note: type: Plain text
en: The email address Debconf should send mail to if it needs to make sure that the admin has seen an important message. Defaults to "root", but can be set to any valid email address to send the mail there. If you prefer to never have debconf send you mail, specify a blank address. This can be overridden on the fly with the DEBCONF_ADMIN_EMAIL environment variable.
pt: O endereço de email para onde o debconf deve enviar mail se precisar de certificar que o administrador viu uma mensagem importante. A predefinição é "root", mas pode ser definido para qualquer endereço de email válido para enviar o mail para lá. Se preferir que o debconf nunca lhe mande nenhum mail, especifique um endereço vazio. Isto pode ser sobreposto na hora com a variável de ambiente DEBCONF_ADMIN_EMAIL.

note: type: Plain text
en: If set, this will cause debconf to output debugging information to standard error. The value it is set to can be something like "user", "developer", "db", or a regular expression. Typically, rather than setting it permanently in a config file, you will only want to temporarily turn on debugging, and the DEBCONF_DEBUG environment variable can be set instead to accomplish that.
pt: Se definido, isto fará o debconf enviar informação de depuração para o erro standard. O valor que é definido pode ser algo como "user", "developer", "db", ou uma expressão regular. Tipicamente, em vez de o definir permanentemente num ficheiro de configuração, você vai apenas querer ligar a depuração temporariamente, e a variável de ambiente DEBCONF_DEBUG pode ser definida para conseguir isso.

note: type: Plain text
en: If set, this will make debconf not display warnings about various things.  This can be overridden on the fly with the DEBCONF_NOWARNINGS environment variable.
pt: Se definido,isto fará com que o debconf não mostre avisos sobre várias coisas. Isto pode ser sobreposto na hora com a variável de ambiente DEBCONF_NOWARNINGS.

note: type: Plain text
en: Makes debconf log debugging information as it runs, to the syslog. The value it is set to controls that is logged. See Debug, above for an explanation of the values that can be set to control what is logged.
pt: Faz o debconf registar informação de depuração no syslog, quando é executado. O valor é definido para controlar o que é registado. Veja Debug, em cima, para uma explicação dos valores que podem ser definidos para controlar o que é registado.

note: type: Plain text
en: If set to "true", makes some debconf frontends use a special terse display mode that outputs as little as possible. Defaults to false. Terse mode may be temporarily set via the DEBCONF_TERSE environment variable.
pt: Se definido para "true", faz com que alguns frontends do debconf usem um modo de mostrador conciso especial que mostra o mínimo possível. A predefinição é 'false'. O modo conciso pode ser definido temporariamente através da variável de ambiente DEBCONF_TERSE.

note: type: Plain text
en: For example, the first stanza of a file might look like this:
      Config: configdb
      Templates: templatedb
pt: Por exemplo, a primeira estrofe de um ficheiro pode parecer-se com isto:
      Config: configdb
      Templates: templatedb

note: type: Plain text
en: Each remaining stanza in the file sets up a database. A database stanza
    begins by naming the database:
      Name: configdb
pt: Cada estrofe que permanece no ficheiro define uma base de dados. Uma estrofe de base de dados
    começa por dar o nome à base de dados:
      Name: configdb

note: type: Plain text
en: Then it indicates what database driver should be used for this database.
    See DRIVERS, below, for information about what drivers are available.
      Driver: File
pt: Depois indica que driver de base de dados deve ser usada para esta base de dados.
    Veja DRIVERS em baixo, para informação acerca de quais drivers estão disponíveis.
      Driver: Ficheiro

note: type: Plain text
en: You can indicate that the database is not essential to the proper
    functioning of debconf by saying it is not required. This will make debconf
    muddle on if the database fails for some reason.
      Required: false
pt: Você pode indicar que a base de dados não é essencial ao funcionamento
    apropriado do debconf dizendo que não é requerida. Isto fará com que o debconf
    se atrapalhe se a base de dados falhe por alguma razão.
      Required: false

note: type: Plain text
en: You can mark any database as readonly and debconf will not write anything
    to it.
      Readonly: true
pt: Você pode marcar qualquer base de dados como 'só-leitura' e o debconf não irá
    escrever nada nela.
      Readonly: true

note: type: Plain text
en: You can also limit what types of data can go into the database with Accept- and Reject- lines; see ACCESS CONTROLS, below.
pt: Você também pode limitar que tipos de dados podem ir para a base de dados com linhas Accept- e Reject-; veja CONTROLES DE ACESSO em baixo.

note: type: Plain text
en: The remainder of each database stanza is used to provide configuration
    specific to that driver. For example, the Text driver needs to know
    a directory to put the database in, so you might say:
      Filename: /var/cache/debconf/config.dat
pt: O restante de cada estrofe de base de dados é usado para disponibilizar
    configuração específica para essa driver. Por exemplo, a driver Text precisa
    de saber um directório onde colocar a base de dados, para que você possa dizer:
      Filename: /var/cache/debconf/config.dat

note: type: Plain text
en: A number of drivers are available, and more can be written with little difficulty. Drivers come in two general types. First there are real drivers -- drivers that actually access and store data in some kind of database, which might be on the local filesystem, or on a remote system. Then there are meta-drivers that combine other drivers together to form more interesting systems. Let's start with the former.
pt: Estão disponíveis um número de drivers, e podem ser escritas mais com pouca dificuldade. As drivers vêm em dois tipos gerais. Primeiro existem as drivers verdadeiras -- drivers que realmente acedem e armazenam dados nalgum tipo de base de dados, que pode estar num sistema de ficheiros local, ou num sistema remoto. Depois existem as meta-drivers que combinam outras drivers juntamente para formar sistemas mais interessantes. Vamos começar pelas primeiras.

note: type: Plain text
en: This database driver allows debconf to store a whole database in a single flat text file. This makes it easy to archive, transfer between machines, and edit. It is one of the more compact database formats in terms of disk space used. It is also one of the slowest.
pt: Esta driver de base de dados permite ao debconf armazenar uma base de dados inteira num único ficheiro de texto simples. Isto torna mais fácil arquivar, transferir entre máquinas, e editar. É um dos formatos de base de dados mais compactado em termos de espaço de disco usado. É também um dos mais lentos.

note: type: Plain text
en: On the downside, the entire file has to be read in each time debconf starts up, and saving it is also slow.
pt: No aspecto negativo, o ficheiro completo tem de ser lido de cada vez que o debconf arranca, e guardá-lo é também lento.

note: type: Plain text
en: The following things are configurable for this driver.
pt: As seguintes coisas são configuráveis para esta driver.

note: type: Plain text
en: The file to use as the database. This is a required field.
pt: O ficheiro a ser usado como base de dados. Este é um campo necessário.

note: type: Plain text
en: The permissions to create the file with if it does not exist. Defaults to 600, since the file could contain passwords in some circumstances.
pt: As permissões para criar um ficheiro se este ainda não existir. A predefinição é 600, porque o ficheiro pode conter palavras-passe em algumas circunstâncias.

note: type: Plain text
en: The format of the file. See FORMATS below. Defaults to using a rfc-822 like format.
pt: O formato do ficheiro. Veja FORMATOS em baixo. A predefinição é usar um formato tipo rfc-822.

note: type: Plain text
en: Whether a backup should be made of the old file before changing it.  Defaults to true.
pt: Se deve ser feita uma cópia de segurança (backup) do ficheiro antigo antes de o alterar. A predefinição é 'true'.

note: type: Plain text
en: As example stanza setting up a database using this driver:
pt: Um exemplo de estrofe que define uma base de dados usando esta driver:

note: type: Plain text
en: This database driver allows debconf to store data in a hierarchical directory structure. The names of the various debconf templates and questions are used as-is to form directories with files in them. This format for the database is the easiest to browse and fiddle with by hand.  It has very good load and save speeds. It also typically occupies the most space, since a lot of small files and subdirectories do take up some additional room.
pt: Esta driver de base de dados permite ao debconf armazenar dados numa estrutura de directórios hierárquicos. Os nomes dos vários templates de debconf e questões são usados como são para formar directórios como ficheiros neles. Este formato para a base de dados é o mais fácil de navegar e passear manualmente. Tem bons tempos de carga e gravação. Tipicamente também é o que ocupa mais espaço, porque muitos ficheiro pequenos e sub-directórios ocupam algum espaço adicional.

note: type: Plain text
en: The directory to put the files in. Required.
pt: O directório onde colocar os ficheiros. Necessário.

note: type: Plain text
en: An extension to add to the names of files. Must be set to a non-empty string; defaults to ".dat"
pt: Uma extensão a adicionar aos nomes dos ficheiros. Tem que estar definida para uma string não vazia; a predefinição é ".dat"

note: type: Plain text
en: This database driver is a compromise between the File and DirTree databases. It uses a directory, in which there is (approximately) one file per package that uses debconf. This is fairly fast, while using little more room than the File database driver.
pt: Esta driver de base de dados é um compromisso entre as bases de dados File e DirTree. Usa um directório, onde existe um ficheiro (aproximadamente) por cada pacote que usa debconf. Isto é bastante rápido, enquanto usa um pouco mais de espaço que a driver de bases de dados File.

note: type: Plain text
en: This driver is configurable in the same ways as is the DirTree driver, plus:
pt: Esta driver é configurada do mesmo modo que a driver DirTree, mais:

note: type: Plain text
en: The permissions to create files with. Defaults to 600, since the files could contain passwords in some circumstances.
pt: As permissões com as quais criar ficheiros. A predefinição é 600, porque os ficheiros podem conter palavras-passe em algumas circunstâncias.

note: type: Plain text
en: WARNING: This database driver is currently experimental. Use with caution.
pt: AVISO: Esta driver de base de dados é actualmente experimental. Use-a com cuidado.

note: type: Plain text
en: This database driver accesses a LDAP directory for debconf configuration data. Due to the nature of the beast, LDAP directories should typically be accessed in read-only mode. This is because multiple accesses can take place, and it's generally better for data consistency if nobody tries to modify the data while this is happening. Of course, write access is supported for those cases where you do want to update the config data in the directory.
pt: Esta driver de base de dados acede a uma directório LDAP para dados de configuração de debconf. Devido à natureza da besta, os directórios LDAP devem tipicamente ser acedidos em modo de apenas-leitura. Isto é porque podem ocorrer múltiplos acessos, e é geralmente melhor para a consistência dos dados se ninguém tentar modificá-los quando isto está a acontecer. Claro que o acesso de escrita é suportado para aqueles casos em que você quer actualizar os dados de configuração no directório.

note: type: Plain text
en: For information about setting up a LDAP server for debconf, read /usr/share/doc/debconf-doc/README.LDAP (from the debconf-doc package).
pt: Para informação sobre configurar um servidor LDAP para o debconf, leia /usr/share/doc/debconf-doc/README.LDAP (do pacote debconf-doc).

note: type: Plain text
en: To use this database driver, you must have the libnet-ldap-perl package installed. Debconf suggests that package, but does not depend on it.
pt: Para usar esta driver de base de dados, você precisa de ter o pacote libnet-ldap-perl instalado. O debconf sugere esse pacote, mas não depende dele.

note: type: Plain text
en: Please carefully consider the security implications of using a remote debconf database. Unless you trust the source, and you trust the intervening network, it is not a very safe thing to do.
pt: Por favor considere cuidadosamente as implicações de segurança de usar uma base de dados debconf remota. A menos que confie na fonte, e tenha confiança na rede interveniente, não é algo muito seguro de se fazer.

note: type: Plain text
en: The host name or IP address of an LDAP server to connect to.
pt: O nome de máquina ou endereço IP de um servidor LDAP para se ligar.

note: type: Plain text
en: The port on which to connect to the LDAP server. If none is given, the default port is used.
pt: O porto por onde ligar ao servidor LDAP. Se nenhum for fornecido, é usado o porto predefinido.

note: type: Plain text
en: The DN under which all config items will be stored. Each config item will be assumed to live in a DN of cn=E<lt>item nameE<gt>,E<lt>Base DNE<gt>. If this structure is not followed, all bets are off.
pt: O DN sob o qual todos os itens de configuração serão armazenados. A cada item de configuração será assumido que vive numa DN de cn=E<lt>item nameE<gt>,E<lt>Base DNE<gt>. Se esta estrutura não for seguida, todas as apostas estão fora.

note: type: Plain text
en: The DN to bind to the directory as. Anonymous bind will be used if none is specified.
pt: O DN para unir ao directório como. Será usada união anónima se nenhum for especificado.

note: type: Plain text
en: The password to use in an authenticated bind (used with binddn, above). If not specified, anonymous bind will be used.
pt: A palavra-passe a usar numa união autenticada (usada com o binddn, em cima). Se não for especificada, será usada união anónima.

note: type: Plain text
en: This option should not be used in the general case. Anonymous binding should be sufficient most of the time for read-only access. Specifying a bind DN and password should be reserved for the occasional case where you wish to update the debconf configuration data.
pt: Esta opção não deve ser usada nos casos gerais. A união anónima deve ser suficiente na maioria das vezes para acesso em modo só-leitura. Especificar uma união DN e palavra-passe deve ser reservado para casos ocasionais onde deseja actualizar os dados de configuração do debconf.

note: type: Plain text
en: Enable access to individual LDAP entries, instead of fetching them all at once in the beginning. This is very useful if you want to monitor your LDAP logs for specific debconf keys requested. In this way, you could also write custom handling code on the LDAP server part.
pt: Activa acesso a entradas LDAP individuais, em vez de obter-las todas de uma vez no inicio. Isto é muito útil se desejar monitorizar os seus logs do LDAP por pedidos de chaves debconf específicas. Deste modo, você também pode escrever código de manipulação personalizado na parte do servidor LDAP.

note: type: Plain text
en: Note that when this option is enabled, the connection to the LDAP server is kept active during the whole Debconf run. This is a little different from the all-in-one behavior where two brief connections are made to LDAP; in the beginning to retrieve all the entries, and in the end to save eventual changes.
pt: Note que quando esta opção está activa, a ligação ao servidor LDAP é mantida activa durante toda a execução do Debconf. Isto e um pouco diferente do comportamento todo-em-um onde duas ligações breves são feitas ao LDAP; no início para obter todas as entradas, e no fim para guardar eventuais alterações.

note: type: Plain text
en: An example stanza setting up a database using this driver, assuming the remote database is on example.com and can be accessed anonymously:
pt: Um exemplo de estrofe que define uma base de dados usando esta driver, assumindo que a base de dados remota está em example.com e pode ser acedida em anonimato:

note: type: Plain text
en: Another example, this time the LDAP database is on localhost, and can be written to:
pt: Outro exemplo, desta vez a base de dados LDAP está em localhost, e pode ser escrita:

note: type: Plain text
en: This special-purpose database driver reads and writes the database from standard input/output. It may be useful for people with special needs.
pt: Esta driver de base de dados de objectivos especiais lê e escreve na base de dados a partir da entrada/saída standard. Pode ser útil para pessoas com necessidades especiais.

note: type: Plain text
en: The format to read and write. See FORMATS below. Defaults to using a rfc-822 like format.
pt: O formato para ler e escrever. Veja FORMATOS em baixo. A predefinição é usar um formato tipo rfc-822.

note: type: Plain text
en: File descriptor number to read from. Defaults to reading from stdin. If set to "none", the database will not read any data on startup.
pt: O número de descritor de ficheiro de onde ler. A predefinição é stdin, Se definido para "none", a base de dados não irá ler nenhuns dados no arranque.

note: type: Plain text
en: File descriptor number to write to. Defaults to writing to stdout. If set to "none", the database will be thrown away on shutdown.
pt: O número de descritor de ficheiro para onde escrever. A predefinição é stdout, Se definido para "none", a base de dados será deitada fora ao desligar.

note: type: Plain text
en: That's all of the real drivers, now moving on to meta-drivers..
pt: E é tudo sobre as drivers reais, agora vamos para as meta-drivers...

note: type: Plain text
en: This driver stacks up a number of other databases (of any type), and allows them to be accessed as one. When debconf asks for a value, the first database on the stack that contains the value returns it. If debconf writes something to the database, the write normally goes to the first driver on the stack that has the item debconf is modifying, and if none do, the new item is added to the first writable database on the stack.
pt: Esta driver empilha um número de outras bases de dados (de qualquer tipo), e permite que sejam acedidas como uma só. Quando o debconf pede um valor, a primeira base de dados na pilha que contém o valor devolve-o. Se o debconf escrever algo na base de dados, a escrita vai normalmente para a primeira driver na pilha que possui o item que o debconf está a modificar, e se nenhuma o tiver, o novo item é adicionado na primeira base de dados da pilha onde se pode escrever.

note: type: Plain text
en: Things become more interesting if one of the databases on the stack is readonly. Consider a stack of the databases foo, bar, and baz, where foo and baz are both readonly. Debconf wants to change an item, and this item is only present in baz, which is readonly. The stack driver is smart enough to realize that won't work, and it will copy the item from baz to bar, and the write will take place in bar. Now the item in baz is shadowed by the item in bar, and it will not longer be visible to debconf.
pt: As coisas tornam-se mais interessantes se uma das bases de dados da pilha for de só-leitura. Considere uma pilha das bases de dados foo, bar e baz onde foo e baz são ambas só-leitura. O debconf quer alterar um item, e este item está presente apenas em baz, a qual é só-leitura. A driver stack é suficientemente inteligente para perceber que isso não vai funcionar, e irá copiar o item de baz para bar, e a escrita irá ter lugar em bar. Agora o item em baz está colocado na sombra pelo item em bar, e não irá mais ser visível ao debconf.

note: type: Plain text
en: This kind of thing is particularly useful if you want to point many systems at a central, readonly database, while still allowing things to be overridden on each system. When access controls are added to the picture, stacks allow you to do many other interesting things, like redirect all passwords to one database while a database underneath it handles everything else.
pt: Este tipo de coisa é particularmente útil se você desejar apontar muitos sistemas a uma base de dados central de só-leitura, e ao mesmo tempo permitir que coisas possam ser ultrapassadas em cada sistema. Quando são adicionados controles de acesso à situação, as pilhas permitem-lhe fazer mais coisas interessantes, como redireccionar todas as palavras-passe para uma base de dados enquanto que a base de dados inferior lida com tudo o resto.

note: type: Plain text
en: Only one piece of configuration is needed to set up a stack:
pt: Apenas é necessário um pedaço de configuração para configurar um stack:

note: type: Plain text
en: This is where you specify a list of other databases, by name, to tell it what makes up the stack.
pt: Aqui é onde você especifica uma lista de outras bases de dados, pelo nome, para lhe dizer o que compõe a stack.

note: type: Plain text
en: For example:
pt: Por exemplo:

note: type: Plain text
en: WARNING: The stack driver is not very well tested yet. Use at your own risk.
pt: AVISO: A driver stack ainda não foi bem testada. Use sob sua responsabilidade.

note: type: Plain text
en: This driver passes all requests on to another database driver. But it also copies all write requests to a backup database driver.
pt: Esta driver passa todos os pedidos para outra driver de base de dados. Mas também copia todos os pedidos de escrita para uma driver de base de dados de salvaguarda.

note: type: Plain text
en: You must specify the following fields to set up this driver:
pt: Você tem de especificar os seguintes campos para configurar esta driver:

note: type: Plain text
en: The database to read from and write to.
pt: A base de dados de onde ler e onde escrever.

note: type: Plain text
en: The name of the database to send copies of writes to.
pt: O nome da base da dados para enviar cópias das escritas.

note: type: Plain text
en: This driver passes all requests on to another database driver, outputting verbose debugging output about the request and the result.
pt: Esta driver passa todos os pedidos para outra driver de base de dados, gerando saídas de depuração detalhadas acerca dos pedidos e resultados.

note: type: SH
en: ACCESS CONTROLS
pt: CONTROLOS DE ACESSO

note: type: Plain text
en: When you set up a database, you can also use some fields to specify access controls. You can specify that a database only accepts passwords, for example, or make a database only accept things with "foo" in their name.
pt: Quando você configura uma base de dados, também pode usar alguns campos para especificar controlos de acesso. Você pode especificar que uma base de dados apenas aceita palavras-passe, por exemplo, ou fazer uma base de dados apenas aceitar coisas com "foo" nos seus nomes.

note: type: Plain text
en: As was mentioned earlier, this access control, if set to "true", makes a database readonly. Debconf will read values from it, but will never write anything to it.
pt: Como já dito antes, este controlo de acesso, se definido para "true", torna uma base de dados em só-leitura. O debconf irá ler valores dela, mas nunca irá escrever nada lá.

note: type: Plain text
en: The text in this field is a perl-compatible regular expression that is matched against the names of items as they are requested from the database. Only if an items name matches the regular expression, will the database allow debconf to access or modify it.
pt: O texto neste campo é uma expressão regular compatível com perl que é comparada com os nomes dos itens quando eles são pedidos da base de dados. Apenas se um nome de item corresponder à expressão regular, é que a base de dados permite ao debconf aceder-lhe ou modificá-la.

note: type: Plain text
en: Like Accept-Name, except any item name matching this regular expression will be rejected.
pt: Tal como Accept-Name, excepto que qualquer nome de item que corresponda a esta expressão regular será rejeitado.

note: type: Plain text
en: Another regular expression, this matches against the type of the item that is being accessed. Only if the type matches the regex will access be granted.
pt: Outra expressão regular, esta corresponde contra o tipo de item que está a ser acedido. Apenas se o tipo corresponder ao regex é que o acesso será concedido.

note: type: Plain text
en: Like Accept-Type, except any type matching this regular expression will be rejected.
pt: Tal como Accept-Type, excepto que qualquer tipo que corresponda a esta expressão regular será rejeitado.

note: type: SH
en: FORMATS
pt: FORMATOS

note: type: Plain text
en: Some of the database drivers use format modules to control the actual format in which the database is stored on disk. These formats are currently supported:
pt: Algumas das drivers de bases de dados usam módulos de formato para controlar o formato actual no qual a base de dados está armazenada no disco. São actualmente suportados estes formatos:

note: type: Plain text
en: This is a file format loosely based upon the rfc-822 format for email message headers. Similar formats are used throughout Debian; in the dpkg status file, and so on.
pt: Este é um formato de ficheiro livremente baseado no formato rfc-822 para cabeçalhos de mensagens de email. São usados formatos semelhantes em Debian, no ficheiro de estado do dpkg, e muito mais.

note: type: Plain text
en: Here is a more complicated example of a debconf.conf file.
pt: Aqui está um exemplo mais complicado de um ficheiro debconf.conf.

note: type: Plain text
en:   # This stanza is used for general debconf setup.
      Config: stack
      Templates: templates
      Log: developer
      Debug: developer
pt:   # Esta estrofe é usada para configuração debconf geral.
      Config: stack
      Templates: templates
      Log: developer
      Debug: developer

note: type: Plain text
en:   # This is my own local database.
      Name: mydb
      Driver: DirTree
      Directory: /var/cache/debconf/config
pt:   # Esta é a minha base de dados local.
      Name: mydb
      Driver: DirTree
      Directory: /var/cache/debconf/config

note: type: Plain text
en:   # This is another database that I use to hold
      # only X server configuration.
      Name: X
      Driver: File
      Filename: /etc/X11/debconf.dat
      Mode: 644
      # It's sorta hard to work out what questions
      # belong to X; it should be using a deeper
      # tree structure so I could just match on ^X/
      # Oh well.
      Accept-Name: xserver|xfree86|xbase
pt:   # Isto é outra base de dados que eu uso para manter
      # apenas a configuração do servidor X.
      Name: X
      Driver: File
      Filename: /etc/X11/debconf.dat
      Mode: 644
      # É difícil separar quais as questões pertencem
      # ao X; deveria usar uma estrutura de árvore mais funda
      # para que pudesse apenas coincidir com ^X/
      # Ora bem.
      Accept-Name: xserver|xfree86|xbase

note: type: Plain text
en:   # This is our company's global, read-only
      # (for me!) debconf database.
      Name: company
      Driver: LDAP
      Server: debconf.foo.com
      BaseDN: cn=debconf,dc=foo,dc=com
      BindDN: uid=admin,dc=foo,dc=com
      BindPasswd: secret
      Readonly: true
      # I don't want any passwords that might be
      # floating around in there.
      Reject-Type: password
      # If this db is not accessible for whatever
      # reason, carry on anyway.
      Required: false
pt:   # Esta é a base de dados debconf global da companhia,
      # apenas para leitura (para mim!).
      Name: company
      Driver: LDAP
      Server: debconf.foo.com
      BaseDN: cn=debconf,dc=foo,dc=com
      BindDN: uid=admin,dc=foo,dc=com
      BindPasswd: secret
      Readonly: true
      # Não quero nenhumas palavras-passe que possam
      # andar a flutuar por aí.
      Reject-Type: password
      # Se esta base de dados não estiver acessível por qualquer
      # motivo, continuar de qualquer maneira.
      Required: false

note: type: Plain text
en:   # I use this database to hold
      # passwords safe and secure.
      Name: passwords
      Driver: File
      Filename: /etc/debconf/passwords
      Mode: 600
      Accept-Type: password
pt:   # Eu uso esta base de dados para manter as
      # palavras-passe em segurança.
      Name: passwords
      Driver: File
      Filename: /etc/debconf/passwords
      Mode: 600
      Accept-Type: password

note: type: Plain text
en:   # Let's put them all together
      # in a database stack.
      Name: stack
      Driver: Stack
      Stack: passwords, X, mydb, company
      # So, all passwords go to the password database.
      # Most X configuration stuff goes to the X
      # database, and anything else goes to my main
      # database. Values are looked up in each of those
      # in turn, and if none has a particular value, it
      # is looked up in the company-wide LDAP database
      # (unless it's a password).
pt:   # Vamos juntá-los todos
      # numa pilha de base de dados.
      Name: stack
      Driver: Stack
      Stack: passwords, X, mydb, company
      # Portanto, todas as palavras-passe vão para a base de dados
      # das palavras-passe.
      # A maioria das configurações do X vão para a base de dados
      # do X, e tudo o resto vai para a minha base de dados
      # principal. Os valores são trancados em cada um deles
      # na sua vez, e se nenhum tiver um valor particular, é
      # trancado na base de dados LDAP geral da companhia
      # (a menos que seja uma palavra-passe).

note: type: Plain text
en:   # A database is also used to hold templates. We 
      # don't need to make this as fancy.
      Name: templates
      Driver: File
      Mode: 644
      Format: 822
      Filename: /var/cache/debconf/templates
pt:   # Uma base de dados também é usada para manter templates.
      # Nós não precisamos fazer isto tão imaginativo.
      Name: templates
      Driver: File
      Mode: 644
      Format: 822
      Filename: /var/cache/debconf/templates

note: type: SH
en: NOTES
pt: NOTAS

note: type: Plain text
en: If you use something like ${HOME} in this file, it will be replaced with the value of the named environment variable.
pt: Se você usar algo como ${HOME} neste ficheiro, será substituído pelo valor da variável de ambiente com o mesmo nome.

note: type: Plain text
en: Environment variables can also be used to override the databases on the fly, see B<debconf>(7)
pt: Também podem ser usadas variáveis de ambiente para sobrepor a base de dados na hora, veja B<debconf>(7)

note: type: Plain text
en: The field names (the part of the line before the colon) is case-insensitive. The values, though, are case sensitive.
pt: Os nomes do campos (a parte da linha antes da vírgula) são insensíveis a maiúsculas/minúsculas. No entanto, os valores são sensíveis a maiúsculas/minúsculas.

note: type: SH
en: PLANNED ENHANCEMENTS
pt: MELHORIAS PLANEADAS

note: type: Plain text
en: More drivers and formats. Some ideas include: A SQL driver, with the capability to access a remote database.  A DHCP driver, that makes available some special things like hostname, IP address, and DNS servers.  A driver that pulls values out of public DNS records TXT fields.  A format that is compatible with the output of cdebconf.  An override driver, which can override the value field or flags of all requests that pass through it.
pt: Mais drivers e formatos. Algumas ideias incluem: Uma de«river SQL, com a capacidade de aceder a uma base de dados remota. Uma driver DHCP, que torna disponível algumas coisas especiais como nome de máquina, endereço IP, e servidores DNS. Uma driver que puxa valores dos campos TXT de registos DNS públicos. Um formato compatível com a saída do cdebconf. Uma driver de sobreposição, que pode sobrepor o campo do valor ou as bandeiras de todos os pedidos que passam por ela.

note: type: SH
en: FILES
pt: FICHEIROS

note: type: Plain text
en: confmodule - communicate with Debian configuration system FrontEnd.
pt: confmodule - comunicar com um FrontEnd do sistema de configuração Debian.

note: type: Plain text
en: This is a library of shell functions that eases communication with Debian's configuration management system. It can communicate with a FrontEnd via the debconf protocol. The design is that each command in the protocol is represented by one function in this module. The functionname is the same as the command, except it is prefixed with "db_" and is lower-case. Call the function and pass in any parameters you want to follow the command. Any textual return code from the FrontEnd will be returned to you in the $RET variable, while the numeric return code from the FrontEnd will be returned as a return code (and so those return codes must be captured or ignored).
pt: Esta é uma biblioteca de funções shell que facilita a comunicação com o sistema de gestão de configuração da Debian. Pode comunicar com um FrontEnd através do protocolo debconf. Está desenhada de modo que cada comando no protocolo é representado por uma função neste módulo. O nome-da-função é o mesmo que o comando, excepto se tiver o prefixo de "db_" e em minúsculas. Chame a função e passe-lhe quaisquer parâmetros que queira a seguir ao comando. Qualquer código de retorno textual do FrontEnd será retornado para si na variável $RET, enquanto que o código de retorno numérico do FrontEnd será retornado como um código de retorno (e assim esses códigos de retorno devem ser capturados ou ignorados).

note: type: Plain text
en: Once this library is loaded, any text you later output will go to standard
    error, rather than standard output. This is a good thing in general, because
    text sent to standard output is interpreted by the FrontEnd as commands. If
    you do want to send a command directly to the FrontEnd, you must output it
    to file descriptor 3, like this:
      echo GET foo/bar E<gt>&3
pt: Após esta biblioteca estar carregada, qualquer texto que faça sair irá para o
    error standard em vez da saída standard. Geralmente isto é bom porque
    o texto enviado para a saída standard é interpretado pelo FrontEnd como
    comandos. Se você deseja enviar um comando directamente para o FrontEnd,
    você tem de enviá-lo para o descritor de ficheiro 3, assim:
      echo GET foo/bar E<gt>&3

note: type: Plain text
en: The library checks to make sure it is actually speaking to a FrontEnd by examining the DEBIAN_HAS_FRONTEND variable. If it is set, a FrontEnd is assumed to be running. If not, the library turns into one, and runs a copy of the script that loaded the library connected to it. This means that if you source this library, you should do so very near to the top of your script, because everything before the sourcing of the library may well be run again.
pt: A biblioteca faz verificações para ter a certeza que está mesmo a falar com um FrontEnd ao examinar a variável DEBIAN_HAS_FRONTEND. Se estiver definida, assume-se que um FrontEnd está a correr. Se não, a biblioteca torna-se numa, e corre uma cópia do script que carregou a biblioteca ligada a ela. Isto significa que se você usar a fonte desta biblioteca, deve fazê-lo muito próximo do topo do seu script, porque tudo antes da fonte da biblioteca pode muito bem ser executado de novo.

note: type: Plain text
en: B<debconf-devel>(7), B<dpkg-preconfigure>(8), B<dpkg-reconfigure>(8), debconf_specification in the debian-policy package
pt: B<debconf-devel>(7), B<dpkg-preconfigure>(8), B<dpkg-reconfigure>(8), debconf_specification no pacote debian-policy

note: type: Plain text
en: debconf - Debian package configuration system
pt: debconf - Sistema de configuração de pacotes Debian

note: type: Plain text
en: Debconf is a configuration system for Debian packages. There is a rarely-used command named debconf, documented in B<debconf>(1)
pt: Debconf é um sistema de configuração para pacotes Debian. Existe um comando raramente usado chamado debconf, documentado em B<debconf>(1)

note: type: Plain text
en: Debconf provides a consistent interface for configuring packages, allowing you to choose from several user interface frontends. It supports preconfiguring packages before they are installed, which allows large installs and upgrades to ask you for all the necessary information up front, and then go do the work while you do something else. It lets you, if you're in a hurry, skip over less important questions and information while installing a package (and revisit it later).
pt: O debconf disponibiliza uma interface consistente para configurar pacotes, permitindo-lhe escolher entre vários frontends de interface de utilizador. Suporta a pré-configuração de pacotes antes deles serem instalados, o que permite que grandes instalações e actualizações lhe perguntem toda a informação necessária de avanço e depois façam o trabalho enquanto você faz outras coisas. Permite-lhe, se estiver com pressa, saltar as questões menos importantes e informação instala um pacote (e o revisita mais tarde).

note: type: SH
en: Preconfiguring packages
pt: Pré-configurando pacotes

note: type: Plain text
en: Debconf can configure packages before they are even installed onto your system. This is useful because it lets all the questions the packages are going to ask be asked at the beginning of an install, so the rest of the install can proceed while you are away getting a cup of coffee.
pt: O debconf pode configurar os pacotes antes de eles estarem instalados no seu sistema. Isto é útil porque permite que todas as questões que os pacotes vão perguntar seja perguntadas no princípio da instalação, então o resto da instalação pode prosseguir enquanto você vai beber um café.

note: type: Plain text
en: If you use apt (version 0.5 or above), and you have apt-utils installed, each package apt installs will be automatically preconfigured. This is controlled via I</etc/apt/apt.conf.d/70debconf>
pt: Se você usa o apt (versão 5.0 ou posterior), e tem o apt-utils instalado, cada pacote que o apt instala será automaticamente pré-configurado. Isto é controlado via I</etc/apt/apt.conf.d/70debconf>

note: type: Plain text
en: Sometimes you might want to preconfigure a package by hand, when you're not installing it with apt. You can use B<dpkg-preconfigure>(8)  to do that, just pass it the filenames of the packages you want to preconfigure. You will need apt-utils installed for that to work.
pt: Por vezes você pode desejar pré-configurar um pacote manualmente, quando não está a instalá-lo com o apt. Pode usar o B<dpkg-preconfigure>(8) para isso, apenas passe-lhe os nomes de ficheiros dos pacotes que deseja pré-configurar. Você precisa do apt-utils instalado para isto funcionar.

note: type: SH
en: Reconfiguring packages
pt: Reconfigurando pacotes

note: type: Plain text
en: Suppose you installed the package, and answered debconf's questions, but now that you've used it awhile, you realize you want to go back and change some of your answers. In the past, reinstalling a package was often the thing to do when you got in this situation, but when you reinstall the package, debconf seems to remember you have answered the questions, and doesn't ask them again (this is a feature).
pt: Suponha que instalou um pacote e respondeu às questões do debconf, mas agora que o usou durante algum tempo, percebe que quer voltar atrás e alterar algumas das suas respostas. No passado, a reinstalação do pacote era muitas vezes o caminho a seguir nesta situação, mas quando reinstala o pacote, o debconf parece lembrar-se que você já respondeu às questões, e não as pergunta de novo (isto é uma característica).

note: type: Plain text
en: Luckily, debconf makes it easy to reconfigure any package that uses it.
    Suppose you want to reconfigure debconf itself. Just run, as root:
      dpkg-reconfigure debconf
pt: Felizmente, o debconf facilita a reconfiguração de qualquer pacote que o use.
    Suponha que quer reconfigurar o próprio debconf. Como root, execute:
      dpkg-reconfigure debconf

note: type: Plain text
en: This will ask all the questions you saw when debconf was first installed.  It may ask you other questions as well, since it asks even low priority questions that may have been skipped when the package was installed.  You can use it on any other package that uses debconf, as well.
pt: Isto irá perguntar-lhe todas as perguntas que viu quando o debconf foi instalado pela primeira vez. Pode também fazer-lhe outras perguntas, pois pergunta até questões de baixa prioridade que podem ter sido ignoradas quando o pacote foi instalado. Você pode também usá-lo em qualquer outro pacote que use debconf.

note: type: Plain text
en: One of debconf's unique features is that the interface it presents to you is only one of many, that can be swapped in at will. There are many debconf frontends available:
pt: Uma das características únicas do debconf é que a interface que lhe apresenta é uma de muitas, que podem ser trocadas quando deseja. Existem muitos frontends do debconf disponíveis:

note: type: Plain text
en: The default frontend, this uses the B<whiptail>(1)  or B<dialog>(1)  programs to display questions to you. It works in text mode.
pt: O frontend predefinido, isto usa os programas B<whiptail>(1) ou B<dialog>(1) para lhes mostrar perguntas. Funciona em modo de texto.

note: type: Plain text
en: The most traditional frontend, this looks quite similar to how Debian configuration always has been: a series of questions, printed out at the console using plain text, and prompts done using the readline library. It even supports tab completion. The libterm-readline-gnu-perl package is strongly recommended if you chose to use this frontend; the default readline module does not support prompting with default values.  At the minimum, you'll need the perl-modules package installed to use this frontend.
pt: O frontend mais tradicional, isto parece mesmo com o que a configuração da Debian sempre foi: uma série de questões, escritas na consola usando texto simples, e mostra os "prontos" usando a biblioteca readline. Até suporte acabamentos com a tecla tab. O pacote libterm-readline-gnu-perl é fortemente recomendado se escolher usar este frontend; o módulo predefinido do readline não suporta chamadas ao utilizador (prompt) com valores predefinidos. No mínimo você precisa do pacote perl-modules instalado para usar este frontend.

note: type: Plain text
en: This frontend has some special hotkeys. Pageup (or ctrl-u)  will go back to the previous question (if that is supported by the package that is using debconf), and pagedown (or ctrl-v) will skip forward to the next question.
pt: Este frontend tem algumas teclas de atalho especiais. Pageup (ou ctrl-u) irá voltar para a questão anterior (se isso for suportado pelo pacote que usa o debconf), e pagedown (ou ctrl-v) irá saltar em frente para a próxima questão.

note: type: Plain text
en: This is the best frontend for remote admin work over a slow connection, or for those who are comfortable with unix.
pt: Este é o melhor frontend para trabalho de administração remota por uma ligação lenta, ou para aqueles que estão confortáveis com o unix.

note: type: Plain text
en: This is the anti-frontend. It never interacts with you at all, and makes the default answers be used for all questions. It might mail error messages to root, but that's it; otherwise it is completely silent and unobtrusive, a perfect frontend for automatic installs. If you are using this front-end, and require non-default answers to questions, you will need to preseed the debconf database; see the section below on Unattended Package Installation for more details.
pt: Este é o anti-frontend. Nunca interage consigo de modo algum, e faz com que as respostas predefinidas sejam usadas por todas as questões. Pode enviar mails de erro para o root, mas é só; caso contrário é completamente silencioso e discreto, um frontend perfeito para instalações automáticas. Se você está a usar este frontend e precisa de respostas não predefinidas para as questões, você precisa de pré-semear a base de dados do debconf, veja a secção em baixo em Instalação de 'Pacotes Não Acompanhada' para mais detalhes.

note: type: Plain text
en: This is a modern X GUI using the gtk and gnome libraries. Of course, it requires a valid DISPLAY to work; debconf will fall back to other frontends if it can't work. Note that this frontend requires you have the libgtk3-perl package installed.
pt: Isto é uma GUI X moderna que usa as bibliotecas gtk e gnome. Claro que necessita de um DISPLAY válido para funcionar; o debconf irá cair para para outros frontends se este não puder funcionar. Note que este frontend requer que tenha o pacote libgtk3-perl instalado.

note: type: Plain text
en: This frontend provides a modern X GUI based on the KDE Platform. You of course need a DISPLAY to use this frontend and you must install debconf-kde-helper package. The frontend will fall back to dialog if some of the prerequisites are not met.
pt: Este frontend disponibiliza uma GUI X moderna baseada na plataforma KDE. Claro que você precisa de um DISPLAY para usar este frontend e você tem de instalar o pacote debconf-kde-helper. O frontend irá cair para dialog se algum dos pre-requisitos não estiver satisfeito.

note: type: Plain text
en: This is for those fanatics who have to do everything in a text editor. It runs your editor on a file that looks something like a typical unix config file, and you edit the file to communicate with debconf. Debconf's author prefers to not comment regarding the circumstances that led to this frontend being written.
pt: Isto é para aqueles fanáticos que têm de fazer tudo num editor de texto. Executa o seu editor num ficheiro que parece algo como um ficheiro de configuração típico do unix, e você edita o ficheiro para comunicar com o debconf. O autor do debconf prefere não comentar sobre as circunstâncias que levaram à criação deste frontend.

note: type: Plain text
en: This frontend acts as a web server, that you connect to with your web browser, to browse the questions and answer them.  It has a lot of promise, but is a little rough so far.  When this frontend starts up, it will print out the location you should point your web browser to. You have to run the web browser on the same machine you are configuring, for security reasons.
pt: Este frontend actua como um servidor web, onde você se liga com o seu navegador web, para explorar as perguntas e responder a elas. Tem muito a prometer, mas ainda precisa de muito trabalho. Quando este frontend arranca, escreve a localização para onde deve apontar o seu navegador web. Por razões de segurança, você tem que executar o navegador web na mesma máquina que está a configurar.

note: type: Plain text
en: Do keep in mind that this is not a very secure frontend.  Anyone who has access to the computer being configured can currently access the web server and configure things while this frontend is running. So this is more of a proof of concept than anything.
pt: Tenha sempre em mente que este não é um frontend muito seguro. Qualquer pessoa que tenha acesso ao computador quando está a ser configurado pode aceder ao servidor web e configurar coisas enquanto este frontend está em execução. Portanto isto é mais uma prova de concepção que outra coisa.

note: type: Plain text
en: You can change the default frontend debconf uses by reconfiguring
    debconf. On the other hand, if you just want to change the frontend
    for a minute, you can set the DEBIAN_FRONTEND environment variable to
    the name of the frontend to use. For example:
      DEBIAN_FRONTEND=readline apt-get install slrn
pt: Você pode mudar o frontend predefinido que o debconf usa ao reconfigurar
    o debconf. Por outro lado, se apenas deseja mudar o frontend por um minuto,
    você pode definir a variável de ambiente DEBIAN_FRONTEND para o nome do
    frontend a usar. Por exemplo:
      DEBIAN_FRONTEND=readline apt-get install slrn

note: type: Plain text
en: The B<dpkg-reconfigure>(8)  and B<dpkg-preconfigure>(8)  commands also let you pass I<--frontend=> to them, followed by the frontend you want them to use.
pt: Os comandos B<dpkg-reconfigure>(8) e B<dpkg-preconfigure>(8) também lhe permitem passar I<--frontend=> para eles, seguido do frontend que deseja que estes usem.

note: type: Plain text
en: Note that not all frontends will work in all circumstances. If a frontend fails to start up for some reason, debconf will print out a message explaining why, and fall back to the next-most similar frontend.
pt: Note que nem todos os frontends irão funcionar em todas as circunstâncias, Se um frontend falhar ao arrancar por alguma razão, o debconf irá escrever uma mensagem a explicar porquê, e irá 'cair' para o frontend semelhante seguinte.

note: type: SH
en: Priorities
pt: Propriedades

note: type: Plain text
en: Another nice feature of debconf is that the questions it asks you are prioritized. If you don't want to be bothered about every little thing, you can set up debconf to only ask you the most important questions.  On the other hand, if you are a control freak, you can make it show you all questions. Each question has a priority. In increasing order of importance:
pt: Outra funcionalidade agradável do debconf é que as perguntas que lhe faz são priorizadas. Se você não deseja ser incomodado com todos os pequenos detalhes, você pode configurar o debconf para apenas perguntar as questões mais importantes. Por outro lado, se você é um viciado em controle, pode fazê-lo mostrar todas as perguntas. Cada pergunta tem uma prioridade. A ordem de importância em sequência crescente:

note: type: Plain text
en: Very trivial questions that have defaults that will work in the vast majority of cases.
pt: Questões muito triviais que têm predefinições que irão funcionar na vasta maioria dos casos.

note: type: Plain text
en: Normal questions that have reasonable defaults.
pt: Questões normais que têm predefinições razoáveis.

note: type: Plain text
en: Questions that don't have a reasonable default.
pt: Questões que não têm uma predefinição razoável.

note: type: Plain text
en: Questions that you really, really need to see (or else).
pt: Questões que você precisa realmente de ver (ou então nada feito).

note: type: Plain text
en: Only questions with a priority equal to or greater than the priority you choose will be shown to you. You can set the priority value by reconfiguring debconf, or temporarily by passing I<--priority=> followed by the value to the B<dpkg-reconfigure>(8)  and B<dpkg-preconfigure>(8)  commands, or by setting the DEBIAN_PRIORITY environment variable.
pt: Apenas as questões com uma prioridade igual ou maior que a prioridade que escolheu lhe serão mostradas. Você pode definir o valor da prioridade ao reconfigurar o debconf, ou temporariamente passando I<--priority=> seguido do valor aos comandos B<dpkg-reconfigure>(8) e B<dpkg-preconfigure>(8), ou ao definir a variável de ambiente DEBIAN_PRIORITY.

note: type: SH
en: Backend Database
pt: Base de Dados de Backend

note: type: Plain text
en: Debconf uses a rather flexible and potentially complicated backend database for storing data such as the answers to questions. The file B</etc/debconf.conf> is used to configure this database. If you need to set up something complicated, like make debconf read a remote database to get defaults, with local overrides, read the B<debconf.conf>(5)  man page for all the gory details. Generally, the backend database is located in B</var/cache/debconf/> .
pt: O debconf usa base de dados de backend muito flexível e potencialmente complicada para armazenar dados como as respostas às questões. O ficheiro B</etc/debconf.conf> é usado para configurar esta base de dados. Se você precisar de definir algo complicado, como fazer o debconf ler uma base de dados remota para obter predefinições, com sobreposições locais, leia o manual B<debconf.conf>(5) para todos os detalhes mais chatos. Geralmente, a base de dados de backend está localizada em B</var/cache/debconf/>.

note: type: SH
en: Unattended Package Installation
pt: Instalação de Pacotes Não Acompanhada

note: type: Plain text
en: If you have many machines to manage you will sometimes find yourself in the position of needing to perform an unattended installation or upgrade of packages on many systems, when the default answers to some configuration questions are not acceptable. There are many ways to approach this; all involve setting up a database and making debconf use it to get the answers you want.
pt: Se você tem muitas máquinas para gerir irá por vezes deparar-se com a necessidade de executar uma instalação não acompanhada ou a actualização de pacotes em muitos sistemas, onde as respostas predefinidas de algumas perguntas de configuração não são aceitáveis. Há muitas maneiras de fazer isto; todas envolvem definir uma base de dados e fazer o debconf usá-la para obter as respostas que você quer.

note: type: Plain text
en: You should really read B<debconf.conf>(5)  before this section, as you need to understand how debconf's databases work.
pt: Você deveria mesmo ler B<debconf.conf>(5) antes desta secção, pois precisa de compreender como funcionam as bases de dados do debconf.

note: type: Plain text
en: The easiest way to set up the database is to install the packages on one machine and answer their questions as usual. Or you might just use B<dpkg-preconfigure>(8)  to configure a set of packages without actually installing them. Or you might even decide to write a plain text debconf database by hand or something.
pt: A maneira mais fácil de definir uma base de dados é instalar os pacotes em uma máquina e responder às suas perguntas como usualmente. Ou você pode usar B<dpkg-preconfigure>(8) para configurar um conjunto de pacotes sem realmente os instalar. Ou você pode até decidir escrever uma base de dados debconf em texto simples manualmente ou algo do género.

note: type: Plain text
en: Once you have the database, you need to figure out how to make the remote systems use it. This depends of course on the configuration of those systems and what database types they are set up to use.
pt: Após ter a base de dados, você precisa descobrir como fazer os sistemas remotos usá-la. Isto claro que depende da configuração desses sistemas e quais são os tipos de bases de dados que eles têm definido para usar.

note: type: Plain text
en: If you are using the LDAP debconf database, an entire network of debian machines can also have any or all package installation questions answered automatically by a single LDAP server.
pt: Se você está a usar uma base de dados debconf LDAP, uma rede inteira de máquinas debian podem ter as questões de instalação de qualquer ou todos os pacotes respondidas automaticamente por um único servidor LDAP.

note: type: Plain text
en: But perhaps you're using something a little bit easier to set up like, say, the default debconf database configuration, or you just don't want your remote systems to use LDAP all the time. In this case the best approach is to temporarily configure the remote systems to stack your database underneath their own existing databases, so they pull default values out of it. Debconf offers two environment variables, DEBCONF_DB_FALLBACK and DEBCONF_DB_OVERRIDE, to make it easy to do this on the fly. Here is a sample use:
pt: Mas talvez você esteja a usar algo um pouco mais fácil como, digamos, a configuração de base de dados debconf predefinida, ou você apenas não quer que os seus sistemas remotos usem LDAP a toda a hora. Neste caso a melhor aproximação é configurar temporariamente os sistemas remotos para empilhar a sua base de dados por baixo das já existentes e próprias bases de dados, para que puxem valores predefinidos dela. O debconf oferece duas variáveis de ambiente, DEBCONF_DB_FALLBACK e DEBCONF_DB_OVERRIDE, para tornar mais fácil fazer isto na hora. Aqui está um exemplo de utilização:

note: type: Plain text
en: This makes the debconf on the remote host read in the data that is piped across the ssh connection and interpret it as a plain text format debconf database. It then uses that database as a fallback database -- a read-only database that is queried for answers to questions if the system's main debconf database lacks answers.
pt: Isto faz com que o debconf na máquina remota leia os dados que são canalizados pela ligação ssh e os interprete como uma base de dados debconf em formato de texto. Depois usar essa base de dados como uma base de dados de reserva (fallback) -- uma base de dados só de leitura que é questionada por respostas a perguntas se a base de dados debconf principal do sistema não tiver as respostas.

note: type: Plain text
en: Here's another way to use the DEBCONF_DB_FALLBACK environment variable:
pt: Aqui está outro modo de usar a variável de ambiente DEBCONF_DB_FALLBACK:

note: type: Plain text
en: Here ssh is used to set up a tunneled LDAP connection and run debconf.  Debconf is told to use the LDAP server as the fallback database. Note the use of "{host:localhost}" to configure how debconf accesses the LDAP database by providing the "host" field with a value of "localhost".
pt: Aqui é usado ssh para configurar uma ligação LDAP em túnel e correr o  debconf. Ao debconf é dito para usar o servidor LDAP como base de dados fallback. Note o uso de "{host:localhost}" para configurar como o debconf acede à base de dados LDAP ao disponibilizar o campo "host" com um valor de "localhost".

note: type: Plain text
en: Here's another method:
pt: Aqui está outro método:

note: type: Plain text
en: Here you copy the database over with scp, and then ssh over and make debconf use the file you copied over. This illustrates a shorthand you can use in the DEBCONF_DB_FALLBACK parameters -- if a field name is left off, it defaults to "filename".
pt: Aqui você copia a base de dados com scp, e depois usa ssh para fazer com que o debconf use o ficheiro que copiou. Isto ilustra um atalho que pode usar nos parâmetros DEBCONF_DB_FALLBACK -- se um nome de campo for deixado, usará por predefinição "filename".

note: type: Plain text
en: There is only one problem with these uses of the DEBCONF_DB_FALLBACK parameter: While the fallback database can provide answers to questions the other debconf databases have never seen, it is only queried as a fallback; after the other databases. If you need to instead temporarily override an existing value on the remote host, you should instead use the DEBCONF_DB_OVERRIDE variable. Like DEBCONF_DB_FALLBACK, it sets up a temporary database, but this database is consulted before any others, and can be used to override existing values.
pt: Há apenas um problema com estes usos do parâmetro DEBCONF_DB_FALLBACK. Enquanto a base de dados fallback pode disponibilizar respostas a questões que as outras bases de dados debconf nunca viram, é apenas questionada como uma reserva; depois das outras bases de dados. Se você precisa de sobrepor temporariamente um valor existente na máquina remota, deve usar a variável DEBCONF_DB_OVERRIDE em vez desta. Tal como DEBCONF_DB_FALLBACK, define uma base de dados temporária, mas esta base de dados é consultada antes das outras, e pode ser usada para sobrepor valores existentes.

note: type: SH
en: Developing for Debconf
pt: Desenvolvendo para Debconf

note: type: Plain text
en: Package developers and others who want to develop packages that use debconf should read B<debconf-devel>(7)  .
pt: Programadores de pacotes e outros que desejam desenvolver pacotes que usam debconf devem ler B<debconf-devel>(7).

note: type: Plain text
en: Briefly, debconf communicates with maintainer scripts or other programs via standard input and output, using a simple line-oriented command language similar to that used by common internet protocols such as SMTP. Programs use this protocol to ask debconf to display questions to the user, and retrieve the user's answers. The questions themselves are defined in a separate file, called the "templates file", which has a format not unlike a debian control file.
pt: Resumindo, o debconf comunica com scripts do maintainer ou outros programas via entradas e saídas standard, usando uma simples linguagem de comandos orientada a linhas semelhante à usada por protocolos comuns de internet como o SMTP. Os programas usam este protocolo para pedir ao debconf para mostrar questões ao utilizador, e recolher as respostas dos utilizadores. As próprias questões são definidas num ficheiro separado, chamado o ficheiro "templates", o qual tem um formato não muito diferente de um ficheiro de controle debian.

note: type: Plain text
en: Debian packages which use debconf typically provide both a templates file and a "config" script (run to preconfigure the package) in the control metadata section of the package.
pt: Os pacotes debian que usam debconf tipicamente disponibilizam ambos; um ficheiro de templates e um script de configuração (executado para pré-configurar o pacote) na secção de meta-dados de control do pacote.

note: type: SH
en: ENVIRONMENT
pt: AMBIENTE

note: type: Plain text
en: Used to temporarily change the frontend debconf uses. See above.
pt: Usado para alterar temporariamente o frontend que o debconf usa. Veja em cima.

note: type: Plain text
en: Used to temporarily change the minimum priority of question debconf will display. See above.
pt: Usado para alterar temporariamente a prioridade mínima das questões que o debconf irá mostrar. Veja em cima.

note: type: Plain text
en: Turns on debugging output on standard error. May be set to a facility name or a regular expression which matches a facility name (such as '.*' to output all debug info). The facility names include:
pt: Liga a saída de depuração no erro standard. Pode ser definido para um nome de instituição ou uma expressão regular que corresponda a um nome de instituição (tal como '.*' para gerar toda a informação de depuração). Os nomes de instituições incluem:

note: type: Plain text
en: Debugging info of interest to a debconf user.
pt: Informação de depuração de interesse a um utilizador do debconf.

note: type: Plain text
en: Debugging info of interest to a package developer.
pt: Informação de depuração de interesse para um programador de pacote.

note: type: Plain text
en: Debugging info about the backend database.
pt: Informação de depuração acerca da base de dados backend.

note: type: Plain text
en: Set to "yes" to disable some warnings that debconf may display. Does not suppress display of fatal errors.
pt: Definir para "yes" para desactivar alguns avisos que o debconf pode mostrar. Não suprime a exibição de erros fatais.

note: type: Plain text
en: Set to "yes" to enable terse mode, in which debconf frontends cut down on the verbiage as much as possible.
pt: Definir para "yes" para activar o modo "terse", no qual os frontends do debconf cortam na exibição de detalhes o máximo possível.

note: type: Plain text
en: Stack a database after the normally used databases, so that it is used as a fallback to get configuration information from. See "Unattended Package Installation" above. If the value of the variable is the name of an existing database in debconf.conf, then that database will be used.  Otherwise, the environment variable can be used to configure a database on the fly, by telling the type of database, and optionally passing field:value settings, inside curly braces after the type. Spaces are used to separate fields, so you cannot specify a field value containing whitespace.
pt: Empilha uma base de dados após as bases de dados normalmente usadas, para que a use como uma reserva de onde obter informação de configuração. Veja "Instalação de Pacotes Não Acompanhada" em cima. Se o valor da variável for o nome de uma base de dados existente em debconf.conf, então essa base de dados será usada. Caso contrário, a variável de ambiente pode ser usada para configurar uma base de dados na hora, ao dizer-lhe o tipo de base de dados, e passar opcionalmente definições de campo:valor, dentro de chavetas após o tipo. Os espaços são usados para separar os campos, portanto você não pode especificar um valor que tenha espaços em branco.

note: type: Plain text
en: Thus, this uses the fallbackdb in debconf.conf:
      DEBCONF_DB_FALLBACK=fallbackdb
pt: Assim, isto usa o fallbackdb em debconf.conf:
      DEBCONF_DB_FALLBACK=fallbackdb

note: type: Plain text
en: While this sets up a new database of type File, and tells it a filename to
    use and turns off backups:
      DEBCONF_DB_FALLBACK=File{Filename:/root/config.dat Backup:no}
pt: Enquanto isto define uma nova base de dados do tipo File, e diz-lhe um nome de
    ficheiro a usar e desliga os backups:
      DEBCONF_DB_FALLBACK=File{Filename:/root/config.dat Backup:no}

note: type: Plain text
en: And as a shorthand, this sets up a database of type File with a filename:
      DEBCONF_DB_FALLBACK=File{/root/config.dat}
pt: E de forma abreviada, isto define uma base de dados do tipo File com um nome
    de ficheiro:
      DEBCONF_DB_FALLBACK=File{/root/config.dat}

note: type: Plain text
en: Note that if a fallback database is set up on the fly, it will be read-only by default.
pt: Note que se uma base de dados de emergência (fallback) for definida na hora, irá ficar em apenas-leitura por predefinição.

note: type: Plain text
en: Stack a database before the normally used databases, so that it can override values from them. The value of the variable works the same as does the value of DEBCONF_DB_FALLBACK.
pt: Empilha uma base de dados antes das bases de dados usadas normalmente, para que possa sobrepor valores delas. O valor da variável funciona do mesmo modo que o valor de DEBCONF_DB_FALLBACK.

note: type: Plain text
en: Use a given database instead of the normally used databases.  This may be useful for testing with a separate database without having to create a separate debconf.conf, or to avoid locking the normal databases.
pt: Usa uma base de dados fornecida em vez das bases de dados normalmente usadas. isto pode ser útil para testes com uma base de dados separada sem ter que criar um debconf.conf separado, ou para evitar bloquear as bases de dados normais.

note: type: Plain text
en: If this environment variable is set, debconf will ignore a user's ~/.debconfrc file, and use the system one instead.  If it is set to the name of a regular file, debconf will use that file in preference to the system configuration files.
pt: Se esta variável de ambiente estiver definida, o debconf irá ignorar o ficheiro ~/.debconfrc do utilizador, e em vez deste, usar o do sistema. Se estiver definida para o nome de um ficheiro regular, o debconf irá usar esse ficheiro em preferência dos ficheiros de configuração do sistema.

note: type: Plain text
en: If this environment variable is set, debconf will use dialog in preference to whiptail for the dialog frontend.
pt: Se esta variável de ambiente estiver definida, o debconf irá usar o dialog em preferência do whiptail para o frontend do diálogo.

note: type: Plain text
en: If this environment variable is set, debconf will use Xdialog in preference to whiptail for the dialog frontend.
pt: Se esta variável de ambiente estiver definida, o debconf irá usar o Xdialog em preferência do whiptail para o frontend de diálogo.

note: type: Plain text
en: Set to "true" to cause the seen flag to be set for questions asked in the noninteractive frontend.
pt: Definido para "true" fará definir a bandeira "visto" nas perguntas feitas no frontend noninteractive.

note: type: Plain text
en: Probably quite a few, there's a lot of code here.
pt: Provavelmente alguns, existe muito código aqui.

note: type: Plain text
en: If you do file a bug report, be sure to include the following information:
pt: Se você preencher um relatório de bug, certifique-se que inclui a seguinte informação:

note: type: Plain text
en: The debconf frontend you were using when the problem occurred
pt: O frontend do debconf que estava a usar quando o problema ocorreu

note: type: Plain text
en: What you did to trigger the problem.
pt: O que você fez para despoletar o problema.

note: type: Plain text
en: The full text of any error messages. If you can reproduce the bug, do so with DEBCONF_DEBUG='.*' set and exported. This speeds up debugging a lot.
pt: O texto completo de quaisquer mensagens de erro. Se você consegue reproduzir o bug, faça-o com DEBCONF_DEBUG='.*' definido e exportado. Isto acelera imenso a depuração.

note: type: Plain text
en: debconf - developers guide
pt: debconf - guia de programadores

note: type: Plain text
en: This is a guide for developing packages that use debconf.
pt: Isto é um guia para desenvolver pacotes que usam debconf.

note: type: Plain text
en: This manual assumes that you are familiar with debconf as a user, and are familiar with the basics of debian package construction.
pt: Este manual assume que você está familiarizado com o debconf como utilizador, e está familiarizado com as bases de construção de pacotes debian.

note: type: Plain text
en: This manual begins by explaining two new files that are added to debian packages that use debconf. Then it explains how the debconf protocol works, and points you at some libraries that will let your programs speak the protocol. It discusses other maintainer scripts that debconf is typically used in: the postinst and postrm scripts. Then moves on to more advanced topics like shared debconf templates, debugging, and some common techniques and pitfalls of programming with debconf. It closes with a discussion of debconf's current shortcomings.
pt: Este manual começa por explicar dois novos ficheiros que foram adicionados aos pacotes debian que usam debconf. Depois explica como funciona o protocolo debconf, e indica-lhe algumas bibliotecas que permitem que os seus programas falem o protocolo. Discute outros scripts de maintainer onde o debconf é tipicamente usado: os scripts postinst e postrm. Depois avança para tópicos mais avançados como templates debconf partilhados, depuração, e algumas técnicas comuns e armadilhas de programar com debconf. Termina com uma discussão das deficiências actuais do debconf.

note: type: SH
en: THE CONFIG SCRIPT
pt: O SCRIPT DE CONFIGURAÇÃO

note: type: Plain text
en: Debconf adds an additional maintainer script, the config script, to the set of maintainer scripts that can be in debian packages (the postinst, preinst, postrm, and prerm). The config script is responsible for asking any questions necessary to configure the package.
pt: Debconf adiciona um script de maintainer adicional, o script config, ao conjunto de scripts do maintainer que podem existir nos pacotes debian (o postinst, preinst, postrm, e prerm). O script config é responsável por perguntar quaisquer questões necessárias à configuração do pacote.

note: type: Plain text
en: Note: It is a little confusing that dpkg refers to running a package's postinst script as "configuring" the package, since a package that uses debconf is often fully pre-configured, by its config script, before the postinst ever runs. Oh well.
pt: Nota: É um pouco confuso que o dpkg refira a correr o script postinst de um pacote como "a configurar" o pacote, porque o pacote que usa debconf é geralmente totalmente pré-configurado, pelo seu script config, antes do postinst correr. Pois é.

note: type: Plain text
en: Like the postinst, the config script is passed two parameters when it is run. The first tells what action is being performed, and the second is the version of the package that is currently installed. So, like in a postinst, you can use dpkg --compare-versions on $2 to make some behavior happen only on upgrade from a particular version of a package, and things like that.
pt: Como o postinst, ao script config são passados dois parâmetros quando é executado. O primeiro diz que acção é executada, e o segundo é a versão do pacote que está actualmente instalada. Portanto, como num postinst, você pode usar dpkg --compare-versions em $2 para fazer com que certo comportamento apenas aconteça na actualização de uma versão particular de um pacote, e coisas desse género.

note: type: Plain text
en: The config script can be run in one of three ways:
pt: O script config pode ser executado em um de três modos:

note: type: Plain text
en: If a package is pre-configured, with dpkg-preconfigure, its config script is run, and is passed the parameters "configure", and installed-version.
pt: Se um pacote é pré-configurado com o dpkg-preconfigure, o seu script config é executado, e é lhe passado os parâmetros "configure" e installed-version.

note: type: Plain text
en: When a package's postinst is run, debconf will try to run the config script then too, and it will be passed the same parameters it was passed when it is pre-configured. This is necessary because the package might not have been pre-configured, and the config script still needs to get a chance to run. See HACKS for details.
pt: Quando o postinst de um pacote é executado, o debconf irá tentar executar também o script config, e serão passados os mesmos parâmetros que foram passados quando foi pré-configurado. Isto é necessário porque o pacote pode não ter sido pré-configurado, e o script config ainda precise de uma chance para funcionar. Veja TRUQUES para mais detalhes.

note: type: Plain text
en: If a package is reconfigured, with dpkg-reconfigure, its config script it run, and is passed the parameters "reconfigure" and installed-version.
pt: Se um pacote é reconfigurado com o dpkg-reconfigure, o seu script config é executado, e é lhe passado os parâmetros "reconfigure" e installed-version.

note: type: Plain text
en: Note that since a typical package install or upgrade using apt runs steps 1 and 2, the config script will typically be run twice. It should do nothing the second time (to ask questions twice in a row is annoying), and it should definitely be idempotent. Luckily, debconf avoids repeating questions by default, so this is generally easy to accomplish.
pt: Note que como uma instalação típica ou actualização de pacote usando apt corre em passos 1 e 2, tipicamente o script config será executado duas vezes. Não deverá fazer nada na segunda vez (fazer as mesmas perguntas duas vezes é aborrecido), e deverá definitivamente ser idempotente. Felizmente, o debconf evita repetir questões por predefinição, então isto é geralmente fácil de conseguir.

note: type: Plain text
en: Note that the config script is run before the package is unpacked. It should only use commands that are in essential packages. The only dependency of your package that is guaranteed to be met when its config script is run is a dependency (possibly versioned) on debconf itself.
pt: Note que o script config é executado antes do pacote ser desempacotado. Deverá apenas usar comandos que estão em pacotes essenciais. A única dependência do seu pacote que é garantido estar satisfeita quando o seu script config é executado é uma dependência do próprio debconf (possivelmente com uma versão específica).

note: type: Plain text
en: The config script should not need to modify the filesystem at all. It just examines the state of the system, and asks questions, and debconf stores the answers to be acted on later by the postinst script. Conversely, the postinst script should almost never use debconf to ask questions, but should instead act on the answers to questions asked by the config script.
pt: O script config não deve necessitar de modificar o sistema de ficheiros. Apenas examina o estado do sistema, e faz perguntas, e o debconf armazena as respostas para serem actuadas mais tarde pelo script postinst. Reciprocamente, o script postinst não deve quase nunca usar o debconf para fazer perguntas, mas em vez disso deve actuar com as respostas às questões feitas pelo script config.

note: type: SH
en: THE TEMPLATES FILE
pt: O FICHEIRO TEMPLATES

note: type: Plain text
en: A package that uses debconf probably wants to ask some questions. These questions are stored, in template form, in the templates file.
pt: Um pacote que usa debconf provavelmente vai querer perguntar algumas questões. Estas questões estão armazenadas, num formato de template, no ficheiro de templates.

note: type: Plain text
en: Like the config script, the templates file is put in the control.tar.gz section of a deb. Its format is similar to a debian control file; a set of stanzas separated by blank lines, with each stanza having a RFC822-like form:
pt: Tal como o script config, o ficheiros templates é colocado na secção control.tar.gz de um deb. O seu formato é semelhante a um ficheiro de controle debian; um conjunto de estrofes separadas por linhas vazias, com cada estrofe a ter um formato tipo RFC822:

note: type: Plain text
en:   Template: foo/bar
      Type: string
      Default: foo
      Description: This is a sample string question.
       This is its extended description.
       .
       Notice that:
        - Like in a debian package description, a dot
          on its own line sets off a new paragraph.
        - Most text is word-wrapped, but doubly-indented
          text is left alone, so you can use it for lists
          of items, like this list. Be careful, since
          it is not word-wrapped, if it's too wide
          it will look bad. Using it for short items
          is best (so this is a bad example).
pt:   Template: foo/bar
      Type: string
      Default: foo
      Description: Isto é um exemplo de string de questão.
       Isto é a sua descrição extensa.
       .
       Note que:
        - Tal como na descrição dum pacote debian, um ponto
          isolado define um novo parágrafo.
        - A maioria do texto é arrumado por palavras, mas o texto
          duplamente indentado é deixado como está, portanto pode usá-lo para
          listas de itens, como esta. Tenha cuidado, como não
          é arrumado por palavras, se for muito longo
          vai ficar mal. É melhor usá-lo para itens curtos
          (portanto isto é um mau exemplo).

note: type: Plain text
en:   Template: foo/baz
      Type: boolean
      Description: Clear enough, no?
       This is another question, of boolean type.
pt:   Template: foo/baz
      Type: boolean
      Description: Suficientemente claro, não?
       Isto é outra questão, de tipo booleano.

note: type: Plain text
en: For some real-life examples of templates files, see /var/lib/dpkg/info/debconf.templates, and other .templates files in that directory.
pt: Para alguns exemplos reais de ficheiros templates, veja /var/lib/dpkg/info/debconf.templates, e outros ficheiros templates nesse directório.

note: type: Plain text
en: Let's look at each of the fields in turn..
pt: Vamos observar cada um dos campos um de cada vez...

note: type: Plain text
en: The name of the template, in the 'Template' field, is generally prefixed with the name of the package. After that the namespace is wide open; you can use a simple flat layout like the one above, or set up "subdirectories" containing related questions.
pt: O nome do template, no campo 'Template', é geralmente prefixado com nome do pacote. Após isso o espaço do nome é totalmente aberto; você pode usar uma disposição plana e simples como a que está em cima, ou configurar "sub-directórios" que contêm questões relacionadas.

note: type: Plain text
en: The type of the template determines what kind of widget is displayed to the user. The currently supported types are:
pt: O tipo de template determina que tipo de widget é mostrado ao utilizador. Os tipos actualmente suportados são:

note: type: Plain text
en: Results in a free-form input field that the user can type any string into.
pt: Resulta num campo de entrada de formato livre onde o utilizador pode escrever qualquer string.

note: type: Plain text
en: Prompts the user for a password. Use this with caution; be aware that the password the user enters will be written to debconf's database. You should probably clean that value out of the database as soon as is possible.
pt: Pede ao utilizador uma palavra-passe. Use isto com cuidado; esteja ciente que a palavra-passe que o utilizador inserir será escrita na base de dados do debconf. Você deve provavelmente limpar esse valor da base de dados o mais cedo possível.

note: type: Plain text
en: A true/false choice.
pt: Uma escolha verdadeiro/falso.

note: type: Plain text
en: A choice between one of a number of values. The choices must be specified in a field named 'Choices'. Separate the possible values with commas and spaces, like this:
pt: Uma escolha entre um de um número de valores. As escolhas devem ser especificadas num campo chamado 'Choices'. Separe os valores possíveis com vírgulas e espaços, como isto:

note: type: Plain text
en: Like the select data type, except the user can choose any number of items from the choices list (or choose none of them).
pt: Tal como o tipo de dados select, excepto que o utilizador pode escolher qualquer número de itens da lista de escolhas (ou não escolher nenhum deles).

note: type: Plain text
en: Rather than being a question per se, this datatype indicates a note that can be displayed to the user. It should be used only for important notes that the user really should see, since debconf will go to great pains to make sure the user sees it; halting the install for them to press a key.  It's best to use these only for warning about very serious problems, and the error datatype is often more suitable.
pt: Em vez de ser uma questão em si, este tipo de dados indica uma nota que pode ser mostrada ao utilizador. Deve ser usado apenas para notas importantes que o utilizador realmente precisa de ver, pois o debconf irá ter trabalho a certificar-se que o utilizador a vê; parando a instalação para que ele carregue numa tecla. É melhor usar estas apenas avisos sobre problemas muito sérios, e o tipo de dados error é geralmente mais apropriado.

note: type: Plain text
en: This datatype is used for error messages, such as input validation errors.  Debconf will show a question of this type even if the priority is too high or the user has already seen it.
pt: Este tipo de dados é usado para mensagens de erro, tais como erros de validação de entrada. O Debconf irá mostrar uma questão deste tipo mesmo que a prioridade seja muito alta ou que o utilizador já a tenha visto.

note: type: Plain text
en: This datatype is used for titles, to be set with the SETTITLE command.
pt: Este tipo de dados é usado para títulos, para ser definido com o comando SETTITLE.

note: type: Plain text
en: This datatype can be used for fragments of text, such as labels, that can be used for cosmetic reasons in the displays of some frontends. Other frontends will not use it at all. There is no point in using this datatype yet, since no frontends support it well. It may even be removed in the future.
pt: Este tipo de dados pode ser usado para fragmentos de texto, tais como etiquetas, que podem ser usadas por questões cosméticas nos mostradores de alguns frontends. Outros frontends nem as vão usar de todo. Não existe razão para usar este tipo de dados ainda, já que nenhum frontend o suporta bem, e pode até ser removido no futuro.

note: type: Plain text
en: The 'Default' field tells debconf what the default value should be. For multiselect, it can be a list of choices, separated by commas and spaces, similar to the 'Choices' field. For select, it should be one of the choices. For boolean, it is "true" or "false", while it can be anything for a string, and it is ignored for passwords.
pt: O campo 'Default' diz ao debconf qual deve ser o valor predefinido. Para multi-selecção, pode ser uma lista escolhas, separadas por vírgulas e espaços, semelhante ao campo 'Choices'. Para selecção, deve ser uma das opções. Para booleano, é "true" ou "false", enquanto que pode ser qualquer coisa para uma string, e é ignorado para palavras-passe.

note: type: Plain text
en: Don't make the mistake of thinking that the default field contains the "value" of the question, or that it can be used to change the value of the question. It does not, and cannot, it just provides a default value for the first time the question is displayed. To provide a default that changes on the fly, you'd have to use the SET command to change the value of a question.
pt: Não cometa o erro de pensar que o campo default contém o "valor" da questão, ou que pode ser usado para alterar o valor da questão. Não o faz, nem pode fazer, apenas disponibiliza um valor predefinido para a primeira vez que a questão é mostrada. Para disponibilizar uma predefinição que muda na hora, você terá de usar o comando SET para alterar o valor de uma questão.

note: type: Plain text
en: The 'Description' field, like the description of a Debian package, has two parts: A short description and an extended description. Note that some debconf frontends don't display the long description, or might only display it if the user asks for help. So the short description should be able to stand on its own.
pt: O campo 'Description', como a descrição de um pacote Debia, tem duas partes: Uma descrição curta e uma descrição extensa. Note que alguns frontends não mostram a descrição longa, ou podem apenas mostrá-la se o utilizador pedir ajuda. Portanto a descrição curta deverá ser suficiente sozinha.

note: type: Plain text
en: If you can't think up a long description, then first, think some more. Post to debian-devel. Ask for help. Take a writing class! That extended description is important. If after all that you still can't come up with anything, leave it blank. There is no point in duplicating the short description.
pt: Se você não consegue pensar numa descrição longa, então primeiro pense mais um pouco. Poste em debian-devel. Peça ajuda. Tire um curso de escrita! Essa descrição extensa é importante. Se após isso tudo ainda não conseguir imaginar nada, deixe em branco. Não vale a pena duplicar a descrição curta.

note: type: Plain text
en: Text in the extended description will be word-wrapped, unless it is prefixed by additional whitespace (beyond the one required space). You can break it up into separate paragraphs by putting " ." on a line by itself between them.
pt: O texto na descrição extensa será arrumado por palavras, a menos que seja prefixado com um espaço em branco adicional (para além do espaço necessário). Você pode parti-lo em parágrafos separados ao colocar um "." sozinho numa linha entre eles.

note: type: SH
en: QUESTIONS
pt: QUESTÕES

note: type: Plain text
en: A question is an instantiated template. By asking debconf to display a question, your config script can interact with the user. When debconf loads a templates file (this happens whenever a config or postinst script is run), it automatically instantiates a question from each template. It is actually possible to instantiate several independent questions from the same template (using the REGISTER command), but that is rarely necessary. Templates are static data that comes from the templates file, while questions are used to store dynamic data, like the current value of the question, whether a user has seen a question, and so on. Keep the distinction between a template and a question in mind, but don't worry too much about it.
pt: Uma questão é um template instanciado. Ao pedir ao debconf para mostrar uma questão, o seu script config pode interagir com o utilizador. Quando o debconf carrega um ficheiro templates (isto acontece quer um script config ou postinst seja executado), instancia automaticamente uma questão para cada template. Na realidade é possível instanciar várias questões independentes do mesmo template (usando o comando REGISTER), mas isso é raramente necessário. Templates são dados estáticos que vêm do ficheiro templates, enquanto as questões são usadas para armazenar dados dinâmicos, tal como o valor actual de uma questão, se um utilizador já viu a questão, e etc. Mantenha em mente a distinção entre um template e uma questão, mas não se preocupe muito com isso.

note: type: SH
en: SHARED TEMPLATES
pt: TEMPLATES PARTILHADOS

note: type: Plain text
en: It's actually possible to have a template and a question that are shared among a set of packages. All the packages have to provide an identical copy of the template in their templates files. This can be useful if a bunch of packages need to ask the same question, and you only want to bother the user with it once. Shared templates are generally put in the shared/ pseudo-directory in the debconf template namespace.
pt: É possível ter um template e uma questão que é partilhada entre um conjunto de pacotes. Todos os pacotes têm que disponibilizar uma cópia idêntica do template nos seus ficheiros templates. Isto pode ser útil num grupo de pacotes que precisam de perguntar a mesma pergunta, e você apenas deseja aborrecer o utilizador com ela uma vez. Os templates partilhados são geralmente colocados no pseudo-directório shared/ no espaço de nomes de template do debconf.

note: type: SH
en: THE DEBCONF PROTOCOL
pt: O PROTOCOLO DEBCONF

note: type: Plain text
en: Config scripts communicate with debconf using the debconf protocol. This is a simple line-oriented protocol, similar to common internet protocols such as SMTP. The config script sends debconf a command by writing the command to standard output. Then it can read debconf's reply from standard input.
pt: Os scripts de configuração comunicam com o debconf usando o protocolo debconf. Isto é um protocolo orientado a linhas simples, semelhante a protocolos de internet comuns como o SMTP. O script config envia um comando ao debconf ao escrever o comando na saída (output) standard. Depois pode ler a resposta do debconf a partir da entrada (input) standard.

note: type: Plain text
en: Debconf's reply can be broken down into two parts: A numeric result code (the first word of the reply), and an optional extended result code (the remainder of the reply). The numeric code uses 0 to indicate success, and other numbers to indicate various kinds of failure. For full details, see the table in Debian policy's debconf specification document.
pt: A resposta do debconf pode ser partida em duas partes: Um código de resultado numérico (a primeira palavra da resposta), e um código de resultado extensivo opcional (o restante da resposta). O código numérico usa 0 para indicar sucesso, e outros números para indicar vários tipos de falhas. Para os detalhes completos, veja a tabela no documento de especificação do debconf da política Debian.

note: type: Plain text
en: The extended return code is generally free form and unspecified, so you should generally ignore it, and should certainly not try to parse it in a program to work out what debconf is doing. The exception is commands like GET, that cause a value to be returned in the extended return code.
pt: o código de retorno extensivo é geralmente de formato livre e não especificado, portanto você geralmente ignorá-lo, e não deve tentar analisá-lo com um programa para inspeccionar o que o debconf está a fazer. As excepções são comandos como o GET, que causa o retorno de um valor no código de retorno extensivo.

note: type: Plain text
en: Generally you'll want to use a language-specific library that handles the nuts and bolts of setting up these connections to debconf and communicating with it.
pt: Geralmente você vai querer usar uma biblioteca específica para a linguagem que lida com os 'parafusos e porcas' da configuração destas ligações ao debconf e da comunicação com ele.

note: type: Plain text
en: For now, here are the commands in the protocol. This is not the definitive definition, see Debian policy's debconf specification document for that.
pt: Por agora, aqui estão os comandos no protocolo. Isto não é a definição definitiva, veja o documento de especificação debconf da política Debian para isso.

note: type: Plain text
en: You generally don't need to use this command. It exchanges with debconf the protocol version number that is being used. The current protocol version is 2.0, and versions in the 2.x series will be backwards-compatible. You may specify the protocol version number you are speaking and debconf will return the version of the protocol it speaks in the extended result code. If the version you specify is too low, debconf will reply with numeric code 30.
pt: Geralmente você não precisa de usar este comando. Ele troca com o debconf o número de versão do protocolo que está a ser usado. A versão actual do protocolo é 2.0, e versões na série 2.x serão compatíveis para trás. Você pode especificar o número da versão de protocolo que está a falar e o debconf irá responder com a versão do protocolo que ele fala no código de resultados extenso. Se a versão que você especificar for muito baixa, o debconf irá responder com o código numérico 30.

note: type: Plain text
en: You generally don't need to use this command. It exchanges with debconf a list of supported capabilities (separated by spaces). Capabilities that both you and debconf support will be used, and debconf will reply with all the capabilities it supports.
pt: Geralmente você não precisa de usar este comando. Ele troca com o debconf uma lista das capacidades suportadas (separadas por espaços). As capacidades que ambos você e o debconf suportam serão usadas, e o debconf irá responder com todas as capacidades que suporta.

note: type: Plain text
en: If 'escape' is found among your capabilities, debconf will expect commands you send it to have backslashes and newlines escaped (as \e\e and \en respectively) and will in turn escape backslashes and newlines in its replies. This can be used, for example, to substitute multi-line strings into templates, or to get multi-line extended descriptions reliably using METAGET. In this mode, you must escape input text yourself (you can use B<debconf-escape>(1)  to help with this if you want), but the confmodule libraries will unescape replies for you.
pt: Se o 'escape' for encontrado entre as suas capacidades, o debconf irá esperar que os comandos que você envia tenha barras invertidas e escapes de novas linhas (como \e\e e \en respectivamente) e irá por sua vez escapar as barras invertidas e novas linhas nas suas respostas. Isto pode ser usado, por exemplo, para substituir strings de múltiplas linhas em templates, ou para obter descrições extensas de múltiplas linhas com segurança usando METAGET. Neste modo, você tem que dar escape você próprio no texto de entrada (pode usar B<debconf-escape>(1) para o ajudar com isto se desejar), mas as bibliotecas confmodule irá retirar o espace das respostas para si.

note: type: Plain text
en: This sets the title debconf displays to the user, using the short description of the template for the specified question. The template should be of type title. You rarely need to use this command since debconf can automatically generate a title based on your package's name.
pt: Isto define o título que o debconf mostra ao utilizador, usando a descrição curta do template para a questão específica. O template deve ser do tipo 'title'. Você raramente precisa de usar este comando porque o debconf pode automaticamente gerar um título baseado no nome do seu pacote.

note: type: Plain text
en: Setting the title from a template means they are stored in the same place as the rest of the debconf questions, and allows them to be translated.
pt: Definir o título a partir de um template significa que eles são armazenados no mesmo local que o resto das questões do debconf, e permite-lhes serem traduzidos.

note: type: Plain text
en: This sets the title debconf displays to the user to the specified string.  Use of the SETTITLE command is normally to be preferred as it allows for translation of the title.
pt: Isto define o título que o debconf mostra ao utilizador para a string especificada. Normalmente é preferido o uso do comando SETTITLE pois este permite a tradução do título.

note: type: Plain text
en: Ask debconf to prepare to display a question to the user. The question is not actually displayed until a GO command is issued; this lets several INPUT commands be given in series, to build up a set of questions, which might all be asked on a single screen.
pt: Pede ao debconf para preparar a amostragem de uma questão ao utilizador. A questão não é realmente mostrada até que seja emitido um comando GO; isto permite que sejam dados vários comandos INPUT em série, para preparar um conjunto de questões, que as quais podem ser todas respondidas num único écran.

note: type: Plain text
en: The priority field tells debconf how important it is that this question be shown to the user. The priority values are:
pt: O campo de prioridade diz ao debconf qual a importância de mostrar esta questão ao utilizador. Os valores de prioridade são:

note: type: Plain text
en: Very trivial items that have defaults that will work in the vast majority of cases; only control freaks see these.
pt: Itens muito triviais que têm predefinições que irão trabalhar ma vasta maioria dos casos, apenas os viciados no controle vêm estes.

note: type: Plain text
en: Normal items that have reasonable defaults.
pt: Itens normais que têm predefinições razoáveis.

note: type: Plain text
en: Items that don't have a reasonable default.
pt: Itens que não têm uma predefinição razoável.

note: type: Plain text
en: Items that will probably break the system without user intervention.
pt: Itens que provavelmente irão danificar o sistema sem a intervenção do utilizador.

note: type: Plain text
en: Debconf decides if the question is actually displayed, based on its priority, and whether the user has seen it before, and which frontend is being used. If the question will not be displayed, debconf replies with code 30.
pt: O debconf decide se uma questão é mesmo mostrada, baseando-se na sua prioridade, e se o utilizador já a viu antes, e qual o frontend está a ser usado. Se a questão não é para ser mostrada, o debconf responde com o código 30.

note: type: Plain text
en: Tells debconf to display the accumulated set of questions (from INPUT commands) to the user.
pt: Diz ao debconf para mostrar o conjunto de questões acumuladas (a partir de comandos INPUT) ao utilizador.

note: type: Plain text
en: If the backup capability is supported and the user indicates they want to back up a step, debconf replies with code 30.
pt: Se a capacidade de backup for suportada e o utilizador indicar que quer fazer backup de um passo, o debconf responde com código 30.

note: type: Plain text
en: Clears the accumulated set of questions (from INPUT commands) without displaying them.
pt: Limpa o conjunto de questões acumulado (de comandos INPUT) sem os mostrar.

note: type: Plain text
en: Some debconf frontends can display a number of questions to the user at once.  Maybe in the future a frontend will even be able to group these questions into blocks on screen. BEGINBLOCK and ENDBLOCK can be placed around a set of INPUT commands to indicate blocks of questions (and blocks can even be nested). Since no debconf frontend is so sophisticated yet, these commands are ignored for now.
pt: Alguns frontends do debconf podem mostrar ao utilizador um número de questões de uma vez. Talvez no futuro um frontend seja até capaz de agrupar estas questões em blocos no écran. BEGINBLOCK e ENDBLOCK podem ser colocados em redor de um conjunto de comandos INPUT para indicar blocos de questões (e os blocos podem até ser aninhados). Como ainda não há nenhum frontend do debconf tão sofisticado, este comandos são ignorados, por agora.

note: type: Plain text
en: This command tells debconf that you're done talking to it. Often debconf can detect termination of your program and this command is not necessary.
pt: Este comando diz ao debconf que já terminou de falar com ele. Geralmente o debconf consegue determinar o terminar do seu programa e este comando é desnecessário.

note: type: Plain text
en: After using INPUT and GO to display a question, you can use this command to get the value the user entered. The value is returned in the extended result code.
pt: Após usar INPUT e GO para mostrar uma questão, você pode usar este comando para obter o valor que o utilizador inseriu. O valor é retornado no código de resultado extensivo.

note: type: Plain text
en: This sets the value of a question, and it can be used to override the default value with something your program calculates on the fly.
pt: Isto define o valor de uma questão, e pode ser usado para sobrepor o valor predefinido com algo que o seu programa calcula na hora.

note: type: Plain text
en: This resets the question to its default value (as is specified in the 'Default' field of its template).
pt: Isto re-define (reset) a questão ao seu valor predefinido (tal como especificado no campo 'Default' do seu template).

note: type: Plain text
en: Questions can have substitutions embedded in their 'Description' and 'Choices' fields (use of substitutions in 'Choices' fields is a bit of a hack though; a better mechanism will eventually be developed). These substitutions look like "${key}". When the question is displayed, the substitutions are replaced with their values. This command can be used to set the value of a substitution. This is useful if you need to display some message to the user that you can't hard-code in the templates file.
pt: As questões podem ter substituições embebidas nos seus campos "Description" e "Choices" (apesar do uso de substituições nos campos "Choices" ser um pouco de truque; será eventualmente desenvolvido um mecanismo melhor). Estas substituições parecem-se como "${key}". Quando a questão é mostrada, as substituições trocam de lugar com os seus valores. Este comando pode ser usado para definir o valor de uma substituição. Isto é útil caso você precise de mostrar alguma questão ao utilizador que não a pode codificar no ficheiro templates.

note: type: Plain text
en: Do not try to use SUBST to change the default value of a question; it won't work since there is a SET command explicitly for that purpose.
pt: Não tente usar o SUBST para alterar o valor predefinido de uma questão, não vai funcionar porque existe um comando SET explícito para esse trabalho.

note: type: Plain text
en: Questions can have flags associated with them. The flags can have a value of "true" or "false". This command returns the value of a flag.
pt: As questões podem ter bandeiras associadas a elas. As bandeiras pode ter um valor de "true" ou "false". Este comando devolve o valor de uma bandeira.

note: type: Plain text
en: This sets the value of a question's flag. The value must be either "true" or "false".
pt: Isto define o valor da bandeira de uma questão. O valor tem de ser "true" ou " false".

note: type: Plain text
en: One common flag is the "seen" flag. It is normally only set if a user has already seen a question. Debconf usually only displays questions to users if they have the seen flag set to "false" (or if it is reconfiguring a package).  Sometimes you want the user to see a question again -- in these cases you can set the seen flag to false to force debconf to redisplay it.
pt: Uma bandeira comum é a bandeira "seen" (visto). Normalmente apenas é definida se um utilizador já viu uma pergunta. Normalmente o debconf apenas mostra questões aos utilizadores se estas tiverem a bandeira seen definida para "false" (ou se estiver e reconfigurar um pacote). Por vezes você quer que o utilizador volte a ver a pergunta de novo -- nestes casos você pode definir a bandeira seen para false para forçar o debconf a mostrá-la.

note: type: Plain text
en: This returns the value of any field of a question's associated template (the Description, for example).
pt: Isto devolve o valor de qualquer campo de um template associado a uma questão (a Descrição, por exemplo).

note: type: Plain text
en: This creates a new question that is bound to a template. By default each template has an associated question with the same name. However, any number of questions can really be associated with a template, and this lets you create more such questions.
pt: Isto cria uma nova questão que está ligada a um template. Por predefinição cada template tem uma questão associada com o mesmo nome. No entanto, qualquer número de questões pode ser realmente associado com um template, e isto permite-lhe criar mais dessas tais questões.

note: type: Plain text
en: This removes a question from the database.
pt: Isto remove uma questão da base de dados.

note: type: Plain text
en: Call this in your postrm when your package is purged. It removes all of your package's questions from debconf's database.
pt: Chame isto no seu pós-remoção (postrm) quando o seu pacote é purgado. Remove todas as suas questões do pacote da base de dados do debconf.

note: type: TP
en: B<X_LOADTEMPLATEFILE /path/to/templates [owner]>
pt: B<X_LOADTEMPLATEFILE /caminho/para/templates [dono]>

note: type: Plain text
en: This extension loads the specified template file into debconf's database.  The owner defaults to the package that is being configured with debconf.
pt: Esta extensão carrega o ficheiro template específico na base de dados do debconf. O dono muda por predefinição para o pacote que está a ser configurado com o debconf.

note: type: Plain text
en: Here is a simple example of the debconf protocol in action.
pt: Aqui está um exemplo simples do protocolo debconf em acção.

note: type: SH
en: LIBRARIES
pt: BIBLIOTECAS

note: type: Plain text
en: Setting things up so you can talk to debconf, and speaking the debconf protocol by hand is a little too much work, so some thin libraries exist to relieve this minor drudgery.
pt: Configurar as coisas para que possa falar com o debconf, e falar o protocolo debconf manualmente é demasiado trabalhoso, então existem algumas pequenas bibliotecas para aliviar esta pequena trabalheira.

note: type: Plain text
en: For shell programming, there is the /usr/share/debconf/confmodule library, which you can source at the top of a shell script, and talk to debconf in a fairly natural way, using lower-case versions of the debconf protocol commands, that are prefixed with "db_" (ie, "db_input" and "db_go"). For details, see B<confmodule>(3)  .
pt: Para programação em shell, existe a biblioteca /usr/share/debconf/confmodule, a qual você pode usar no topo de um script shell, e falar com o debconf dum modo bastante natural, usando versões em minúsculas dos comandos do protocolo debconf, que estão prefixados com "db_" (ie, "db_input" e "db_go"). Para detalhes veja B<confmodule>(3).

note: type: Plain text
en: Perl programmers can use the B<Debconf::Client::ConfModule>(3pm)  perl module, and python programmers can use the debconf python module.
pt: Programadores de Perl podem usar o módulo B<Debconf::Client::ConfModule>(3pm), e programadores de python podem usar o módulo python do debconf.

note: type: Plain text
en: The rest of this manual will use the /usr/share/debconf/confmodule library in example shell scripts. Here is an example config script using that library, that just asks a question:
pt: O resto deste manual irá usar a biblioteca /usr/share/debconf/confmodule em exemplos de scripts de shell. Aqui está um exemplo de script config que usa essa biblioteca, que apenas faz uma pergunta:

note: type: Plain text
en: Notice the uses of "|| true" to prevent the script from dying if debconf decides it can't display a question, or the user tries to back up. In those situations, debconf returns a non-zero exit code, and since this shell script is set -e, an untrapped exit code would make it abort.
pt: Repare na utilização de "|| true" para prevenir que o script morra se o debconf decidir que não pode mostrar uma pergunta, ou o utilizador tente voltar atrás. Nessas situações, o debconf devolve um código de erro diferente de zero, e como este script de shell está definido com -e, um código de saída não previsto irá fazê-lo abortar.

note: type: Plain text
en: And here is a corresponding postinst script, that uses the user's answer to the question to see if the system should be rebooted (a rather absurd example..):
pt: E aqui está o script postinst correspondente, que usa a resposta do utilizador para a questão para ver se o sistema deve ser reiniciado (um exemplo bastante absurdo...):

note: type: Plain text
en: Notice the use of the $RET variable to get at the extended return code from the GET command, which holds the user's answer to the question.
pt: Repare na utilização da variável $RET para obter um código de retorno extenso do comando GET, o qual detém a resposta do utilizador para a questão.

note: type: SH
en: THE POSTINST SCRIPT
pt: O SCRIPT POSTINST

note: type: Plain text
en: The last section had an example of a postinst script that uses debconf to get the value of a question, and act on it. Here are some things to keep in mind when writing postinst scripts that use debconf:
pt: A última secção tinha um exemplo de um script postinst que usa debconf para obter um valor de uma questão, e actuar nela. Aqui estão algumas coisas a ter em mente quando escrever scripts postinst que usam debconf:

note: type: Plain text
en: Avoid asking questions in the postinst. Instead, the config script should ask questions using debconf, so that pre-configuration will work.
pt: Evite fazer as questões no pós-instalação. Em vez disso, o script config deve fazer as questões usando debconf, para que a pré-configuração funcione.

note: type: Plain text
en: Always source /usr/share/debconf/confmodule at the top of your postinst, even if you won't be running any db_* commands in it.  This is required to make sure the config script gets a chance to run (see HACKS for details).
pt: Use sempre a fonte /usr/share/debconf/confmodule no topo do seu postinst, mesmo que não vá correr nenhuns comandos db_* nele. Isto é necessário para certificar que o script config tem uma hipótese de correr (veja TRUQUES para mais detalhes).

note: type: Plain text
en: Avoid outputting anything to stdout in your postinst, since that can confuse debconf, and postinst should not be verbose anyway. Output to stderr is ok, if you must.
pt: Evite escrever algo para o stdout no seu postinst, pois isso pode confundir o debconf, e o postinst não deve ser detalhado de qualquer modo. A escrita para o stderr é boa ideia, se tiver mesmo que ser.

note: type: Plain text
en: If your postinst launches a daemon, make sure you tell debconf to STOP at the end, since debconf can become a little confused about when your postinst is done otherwise.
pt: Se o seu postinst lançar um daemon, certifique-se de dizer ao debconf para parar (STOP) no fim, pois caso contrário o debconf pode ficar um pouco confuso acerca de quando o seu postinst terminou.

note: type: Plain text
en: Make your postinst script accept a first parameter of "reconfigure". It can treat it just like "configure". This will be used in a later version of debconf to let postinsts know when they are reconfigured.
pt: Faça o seu script postinst aceitar um primeiro parâmetro de "reconfigure". Ele pode tratá-lo tal como "configure". Isto será usado numa versão posterior do debconf para permitir aos postinsts saberem quando são reconfigurados.

note: type: SH
en: OTHER SCRIPTS
pt: OUTROS SCRIPTS

note: type: Plain text
en: Besides the config script and postinst, you can use debconf in any of the other maintainer scripts. Most commonly, you'll be using debconf in your postrm, to call the PURGE command when your package is purged, to clean out its entries in the debconf database. (This is automatically set up for you by B<dh_installdebconf>(1)B<,> by the way.)
pt: À parte dos scripts config e postinst, você pode usar o debconf em qualquer dos outros scripts do maintainer. Mais geralmente, você vai usar debconf no seu postrm, para chamar o comando PURGE quando o seu pacote é purgado, para limpar as suas entradas na base de dados debconf. (Já agora, isto é definido automaticamente para si por B<dh_installdebconf>(1)B<,>.)

note: type: Plain text
en: A more involved use of debconf would be if you want to use it in the postrm when your package is purged, to ask a question about deleting something. Or maybe you find you need to use it in the preinst or prerm for some reason. All of these uses will work, though they'll probably involve asking questions and acting on the answers in the same program, rather than separating the two activities as is done in the config and postinst scripts.
pt: Uma utilização mais envolvida do debconf seria se desejasse usá-lo no postrm quando o seu pacote é purgado, para fazer uma pergunta acerca de apagar algo. Ou talvez você descubra que precisa de usá-lo no preinst ou prerm or alguma razão. Todas estas utilizações irão funcionar, irá provavelmente envolver o fazer perguntas e actuar nas respostas no mesmo programa, em vez de separar as duas actividades como é feito pelos scripts config e postinst.

note: type: Plain text
en: Note that if your package's sole use of debconf is in the postrm, you should make your package's postinst source /usr/share/debconf/confmodule, to give debconf a chance to load up your templates file into its database. Then the templates will be available when your package is being purged.
pt: Note que se a única utilização do debconf do seu pacote é o postrm, você deve fazer o postinst do seu pacote usar a fonte /usr/share/debconf/confmodule, para dar uma chance ao debconf de carregar o seu ficheiro templates na base de dados. Então o templates estará disponível quando o seu pacote for purgado.

note: type: Plain text
en: You can also use debconf in other, standalone programs. The issue to watch out for here is that debconf is not intended to be, and must not be used as a registry. This is unix after all, and programs are configured by files in /etc, not by some nebulous debconf database (that is only a cache anyway and might get blown away). So think long and hard before using debconf in a standalone program.
pt: Você também pode usar o debconf em outros programas standalone. O problema a observar aqui é que o debconf não se destina a ser, e não deve ser usado como um registo. No fim de contas isto é unix, e os programas são configurados por ficheiros em /etc, e não por alguma base de dados debconf nebulosa (de qualquer modo é apenas uma cache e pode ser derrubada). Portanto pense bem antes de usar o debconf num programa standalone.

note: type: Plain text
en: There are times when it can make sense, as in the apt-setup program which uses debconf to prompt the user in a manner consistent with the rest of the debian install process, and immediately acts on their answers to set up apt's sources.list.
pt: Existem alturas em que isso faz sentido, com no programa apt-setup que usa debconf para perguntar ao utilizador num modo consistente com o resto do processo de instalação debian, e actua imediatamente nas suas respostas para configurar o sources.list do apt.

note: type: SH
en: LOCALIZATION
pt: LOCALIZAÇÃO

note: type: Plain text
en: Debconf supports localization of templates files. This is accomplished by adding more fields, with translated text in them. Any of the fields can be translated. For example, you might want to translate the description into Spanish. Just make a field named 'Description-es' that holds the translation. If a translated field is not available, debconf falls back to the normal English field.
pt: Debconf suporta a localização de ficheiros templates. Isto é conseguido ao adicionar mais campos, com texto traduzido neles. Qualquer dos campos pode ser traduzido. Por exemplo, você pode querer traduzir a descrição em Espanhol. Apenas crie um campo chamado 'Description-es' que mantém a tradução. Se um campo traduzido não estiver disponível, o debconf regressa ao campo de Inglês normal.

note: type: Plain text
en: Besides the 'Description' field, you should translate the 'Choices' field of a select or multiselect template. Be sure to list the translated choices in the same order as they appear in the main 'Choices' field. You do not need to translate the 'Default' field of a select or multiselect question, and the value of the question will be automatically returned in English.
pt: Além do campo 'Description', você deve traduzir o campo 'Choices' de um template de selecção ou multi-selecção. Certifique-se de listar as escolhas traduzidas na mesma ordem que elas aparecem no campo 'Choices' principal. Você não precisa de traduzir o campo 'Default' de uma questão de selecção ou multi-selecção, e o valor da questão será automaticamente devolvido em Inglês.

note: type: Plain text
en: You will find it easier to manage translations if you keep them in separate files; one file per translation. In the past, the B<debconf-getlang>(1)  and B<debconf-mergetemplate>(1)  programs were used to manage debian/template.ll files. This has been superseded by the B<po-debconf>(7)  package, which lets you deal with debconf translations in .po files, just like any other translations. Your translators will thank you for using this new improved mechanism.
pt: Você vai descobrir que é mais fácil de gerir traduções se as manter em ficheiros separados; um ficheiro por cada tradução. No passado, os programas B<debconf-getlang>(1)  e B<debconf-mergetemplate>(1) eram usados para gerir ficheiros debian/template.ll. Isto foi substituído pelo pacote B<po-debconf>(7)l, o qual permite-lhe lidar com as traduções de debconf em ficheiros .po, tal como quaisquer outras traduções. Os seus tradutores vão agradecer-lhe por usar este mecanismo novo e melhorado.

note: type: Plain text
en: For the details on po-debconf, see its man page. If you're using debhelper, converting to po-debconf is as simple as running the B<debconf-gettextize>(1)  command once, and adding a Build-Dependency on po-debconf and on debhelper (E<gt>= 4.1.13).
pt: Para detalhes sobre o po-debconf, veja o seu manual. Se você está a usar debhelper, converter para po-debconf é tão simples como correr o comando B<debconf-gettextize>(1) uma vez, e adicionar uma Dependência de Compilação (Build-Dependency) ao po-debconf e ao debhelper (E<gt>= 4.1.13).

note: type: SH
en: PUTTING IT ALL TOGETHER
pt: JUNTAR TUDO

note: type: Plain text
en: So you have a config script, a templates file, a postinst script that uses debconf, and so on. Putting these pieces together into a debian package isn't hard. You can do it by hand, or can use B<dh_installdebconf>(1)  which will merge your translated templates, copy the files into the right places for you, and can even generate the call to PURGE that should go in your postrm script. Make sure that your package depends on debconf (E<gt>= 0.5), since earlier versions were not compatible with everything described in this manual. And you're done.
pt: Então você tem um script config, um ficheiro templates, um script postinst que usa debconf, e etc. Juntar estas peças num pacote debian não é difícil. Pode fazê-lo manualmente, ou pode usar B<dh_installdebconf>(1) o qual irá fundir os seus templates traduzidos, copiar os ficheiros para os lugares correctos para si. e pode até gerar a chamada ao PURGE que deve ir para o seu script postrm. Certifique-se que o seu pacote depende do debconf (E<gt>= 0.5), pois as versões anteriores não eram compatíveis com tudo o que é descrito neste manual. E está feito.

note: type: Plain text
en: Well, except for testing, debugging, and actually using debconf for more interesting things than asking a few basic questions. For that, read on..
pt: Bem, excepto para testar, depurar, e realmente usar o debconf para coisas mais interessantes do que fazer algumas perguntas básicas. Para isso continue a ler...

note: type: SH
en: DEBUGGING
pt: DEPURAÇÃO

note: type: Plain text
en: So you have a package that's supposed to use debconf, but it doesn't quite work. Maybe debconf is just not asking that question you set up. Or maybe something weirder is happening; it spins forever in some kind of loop, or worse. Luckily, debconf has plenty of debugging facilities.
pt: Se você tem um pacote que é suposto usar debconf, mas não funciona, talvez o debconf não esteja a perguntar a questão que você definiu. Ou talvez não esteja a acontecer nada de esquisito: ela ficou presa eternamente num tipo de ciclo vicioso, ou pior. Felizmente, o debconf tem bastantes funcionalidades de depuração.

note: type: Plain text
en: The first thing to reach for is the DEBCONF_DEBUG environment variable.  If you set and export DEBCONF_DEBUG=developer, debconf will output to stderr a dump of the debconf protocol as your program runs. It'll look something like this -- the typo is made clear:
pt: A primeira coisa a pegar é na variável de ambiente DEBCONF_DEBUG. Se você definir e export DEBCONF_DEBUG=developer, o debconf irá escrever no stderr uma descarga do protocolo debconf quando o seu programa corre. Irá parecer algo como isto -- o erro de escrita é tornado claro:

note: type: Plain text
en: It's rather useful to use debconf's readline frontend when you're debugging (in the author's opinion), as the questions don't get in the way, and all the debugging output is easily preserved and logged.
pt: É bastante útil usar o frontend readline do debconf quando está a depurar (na opinião do autor), porque as perguntas não interrompem, e toda a informação de depuração é facilmente preservada e registada em log.

note: type: Plain text
en: If this environment variable is set to 'true', the frontend will display the values in Choices-C fields (if present) of select and multiselect templates rather than the descriptive values.
pt: Se esta variável de ambiente for definida para 'true', o frontend irá mostrar os valores nos campos Choices-C (se presentes) de templates de selecção e multi-selecção em vez dos valores descritivos.

note: type: Plain text
en: Another useful tool is the B<debconf-communicate>(1)  program. Fire it up and you can speak the raw debconf protocol to debconf, interactively. This is a great way to try stuff out on the fly.
pt: Outra ferramenta útil é o programa B<debconf-communicate>(1).Execute-o e você pode falar o protocolo debconf em cru com o debconf interactivamente, Este é um bom modo de experimentar coisas na hora.

note: type: Plain text
en: If a user is reporting a problem, B<debconf-show>(1)  can be used to dump out all the questions owned by your package, displaying their values and whether the user has seen them.
pt: Se um utilizador está a reportar um problema, o B<debconf-show>(1) pode ser usado para despejar todas as questões possuídas pelo seu pacote, mostrando todos os valores e se o utilizador as viu.

note: type: Plain text
en: To avoid the often tedious build/install/debug cycle, it can be useful to load up your templates with B<debconf-loadtemplate>(1)  and run your config script by hand with the B<debconf>(1)  command. However, you still have to do that as root, right? Not so good.  And ideally you'd like to be able to see what a fresh installation of your package looks like, with a clean debconf database.
pt: Para evitar o ciclo tedioso de compilar/instalar/depurar, pode ser útil para carregar o seu templates com B<debconf-loadtemplate>(1) e correr o seu script config manualmente com o comando B<debconf>(1). No entanto, você ainda vai precisar de fazer isso como root, certo? Não é muito bom. E o ideal seria você ser capaz de ver como é que uma instalação fresca do seu pacote fica, com uma base de dados debconf limpa.

note: type: Plain text
en: It turns out that if you set up a ~/.debconfrc file for a normal user, pointing at a personal config.dat and template.dat for the user, you can load up templates and run config scripts all you like, without any root access. If you want to start over with a clean database, just blow away the *.dat files.
pt: Acontece que você definiu um ficheiro ~/.debconfrc para um utilizador normal, apontando para um config.dat e template.dat pessoal para o utilizador, você pode carregar os templates e correr os scripts config que quiser, sem nenhum acesso de root. Se deseja começar com uma base de dados limpa, apenas livre-se dos ficheiros *.dat.

note: type: Plain text
en: For details about setting this up, see B<debconf.conf>(5)B<,> and note that /etc/debconf.conf makes a good template for a personal ~/.debconfrc file.
pt: Para detalhes de como definir isto, veja B<debconf.conf>(5)B<,> e note que /etc/debconf.conf faz um bom modelo para um ficheiro ~/.debconfrc pessoal.

note: type: SH
en: ADVANCED PROGRAMMING WITH DEBCONF
pt: PROGRAMAÇÃO AVANÇADA COM DEBCONF

note: type: SS
en: Config file handling
pt: Manuseamento do ficheiro de configuração

note: type: Plain text
en: Many of you seem to want to use debconf to help manage config files that are part of your package. Perhaps there is no good default to ship in a conffile, and so you want to use debconf to prompt the user, and write out a config file based on their answers. That seems easy enough to do, but then you consider upgrades, and what to do when someone modifies the config file you generate, and dpkg-reconfigure, and ...
pt: Muita gente parece querer usar o debconf para ajudar a gerir ficheiros de configuração que fazem parte do seu pacote. Talvez não haja uma boa predefinição para lançar um ficheiro de configuração, e assim desejam usar o debconf para questionar o utilizador, e escrever um ficheiro de configuração baseado nas suas respostas. Isso parece bastante fácil de fazer, mas depois considere as actualizações, e o que fazer quando alguém modifica o ficheiro de configuração que você gerou, e o dpkg-reconfigure, e...

note: type: Plain text
en: There are a lot of ways to do this, and most of them are wrong, and will often earn you annoyed bug reports. Here is one right way to do it. It assumes that your config file is really just a series of shell variables being set, with comments in between, and so you can just source the file to "load" it.  If you have a more complicated format, reading (and writing) it becomes a bit trickier.
pt: Existem muitas maneiras de fazer isto, e a maioria delas estão erradas, e irão geralmente dar-lhe relatórios aborrecidos de bugs. Aqui está uma maneira certa de o fazer. Assume que o seu ficheiro de configuração é realmente apenas uma série de variáveis shell a serem definidas, com comentários pelo meio, e então você pode simplesmente usar a fonte do ficheiro para "carregá-lo". Se você tem um formato mais complicado, ler (e escrever) fica mais complicado.

note: type: Plain text
en: Your config script will look something like this:
pt: O seu script config irá parecer algo como isto:

note: type: Plain text
en:  # Load config file, if it exists.
     if [ -e $CONFIGFILE ]; then
     	. $CONFIGFILE || true
pt:  # Carrega ficheiro de configuração, se existir.
     if [ -e $CONFIGFILE ]; then
     	. $CONFIGFILE || true

note: type: Plain text
en:  	# Store values from config file into
     	# debconf db.
     	db_set mypackage/foo "$FOO"
     	db_set mypackage/bar "$BAR"
     fi
pt:  	# Armazena valores do ficheiro de configuração na
     	# base de dados debconf.
     	db_set mypackage/foo "$FOO"
     	db_set mypackage/bar "$BAR"
     fi

note: type: Plain text
en:  # Ask questions.
     db_input medium mypackage/foo || true
     db_input medium mypackage/bar || true
     db_go || true
pt:  # Faz perguntas.
     db_input medium mypackage/foo || true
     db_input medium mypackage/bar || true
     db_go || true

note: type: Plain text
en: And the postinst will look something like this:
pt: E o postinst irá parecer algo como isto:

note: type: Plain text
en:  # Generate config file, if it doesn't exist.
     # An alternative is to copy in a template
     # file from elsewhere.
     if [ ! -e $CONFIGFILE ]; then
     	echo "# Config file for my package" E<gt> $CONFIGFILE
     	echo "FOO=" E<gt>E<gt> $CONFIGFILE
     	echo "BAR=" E<gt>E<gt> $CONFIGFILE
     fi
pt:  # Gera ficheiro de configuração, se este não existir.
     # Uma alternativa é copiar um ficheiro template
     # de outro sítio.
     if [ ! -e $CONFIGFILE ]; then
     	echo "# Config file for my package" E<gt> $CONFIGFILE
     	echo "FOO=" E<gt>E<gt> $CONFIGFILE
     	echo "BAR=" E<gt>E<gt> $CONFIGFILE
     fi

note: type: Plain text
en:  # Substitute in the values from the debconf db.
     # There are obvious optimizations possible here.
     # The cp before the sed ensures we do not mess up
     # the config file's ownership and permissions.
     db_get mypackage/foo
     FOO="$RET"
     db_get mypackage/bar
     BAR="$RET"
     cp -a -f $CONFIGFILE $CONFIGFILE.tmp
pt:  # Substituto nos valores de debconf db.
     # Existem optimizações óbvias possíveis aqui.
     # O cp antes do sed assegura que não estragamos as
     # permissões e dono do ficheiro de configuração.
     db_get mypackage/foo
     FOO="$RET"
     db_get mypackage/bar
     BAR="$RET"
     cp -a -f $CONFIGFILE $CONFIGFILE.tmp

note: type: Plain text
en:  # If the admin deleted or commented some variables but then set
     # them via debconf, (re-)add them to the conffile.
     test -z "$FOO" || grep -Eq '^ *FOO=' $CONFIGFILE || \e
     	echo "FOO=" E<gt>E<gt> $CONFIGFILE
     test -z "$BAR" || grep -Eq '^ *BAR=' $CONFIGFILE || \e
     	echo "BAR=" E<gt>E<gt> $CONFIGFILE
pt:  # Se o administrador apagou o comentou algumas variáveis mas depois
     # definiu-as via debconf, (re-)adiciona-as ao ficheiro de configuração.
     test -z "$FOO" || grep -Eq '^ *FOO=' $CONFIGFILE || \e
     	echo "FOO=" E<gt>E<gt> $CONFIGFILE
     test -z "$BAR" || grep -Eq '^ *BAR=' $CONFIGFILE || \e
     	echo "BAR=" E<gt>E<gt> $CONFIGFILE

note: type: Plain text
en: Consider how these two scripts handle all the cases. On fresh installs the questions are asked by the config script, and a new config file generated by the postinst. On upgrades and reconfigures, the config file is read in, and the values in it are used to change the values in the debconf database, so the admin's manual changes are not lost. The questions are asked again (and may or may not be displayed). Then the postinst substitutes the values back into the config file, leaving the rest of it unchanged.
pt: Considere como estes dois scripts lidam com todos os casos. Em instalações novas as perguntas são feitas pelo script config, e um novo ficheiro de configuração é gerado pelo postinst. Nas actualizações e reconfigurações, o ficheiro de configuração é lido, e os valores nele são usados para alterar os valores na base de dados debconf, portanto as modificações manuais do administrador não são perdidas. As questões são feitas de novo (e podem ser ou não ser mostradas). Depois o postinst substitui os valores de volta ao ficheiro de configuração, deixando o resto inalterado.

note: type: SS
en: Letting the user back up
pt: Permitir que o utilizador volte atrás

note: type: Plain text
en: Few things are more frustrating when using a system like debconf than being asked a question, and answering it, then moving on to another screen with a new question on it, and realizing that hey, you made a mistake, with that last question, and you want to go back to it, and discovering that you can't.
pt: Poucas coisas são mais frustrantes que quando se usa um sistema como o debconf onde é-lhe feita uma pergunta, respondida, depois avança-se para outro écran com uma nova pergunta, e depois percebe-se que cometeu um erro na última pergunta, e você quer voltar atrás e descobre que já não pode.

note: type: Plain text
en: Since debconf is driven by your config script, it can't jump back to a previous question on its own but with a little help from you, it can accomplish this feat. The first step is to make your config script let debconf know it is capable of handling the user pressing a back button.  You use the CAPB command to do this, passing backup as a parameter.
pt: Como o debconf é conduzido pelo seu script config, ele não pode saltar para uma questão anterior por si só, mas com alguma ajuda da sua parte, ele pode conseguir isso. O primeiro passo é fazer com que o seu script config faça o debconf saber que é capaz de lidar com um utilizador a carregar no botão de retroceder. Você usa o comando CAPB para fazer isto, passando backup como parâmetro.

note: type: Plain text
en: Then after each GO command, you must test to see if the user asked to back up (debconf returns a code of 30), and if so jump back to the previous question.
pt: Então após cada comando GO, você tem de testar para ver se o utilizador pediu para recuar (o debconf devolve um código de 30), e se sim, saltar de volta para a questão anterior.

note: type: Plain text
en: There are several ways to write the control structures of your program so it can jump back to previous questions when necessary. You can write goto-laden spaghetti code. Or you can create several functions and use recursion. But perhaps the cleanest and easiest way is to construct a state machine. Here is a skeleton of a state machine that you can fill out and expand.
pt: Existem várias maneiras de escrever as estruturas de controle do seu programa para que possa saltar para questões anteriores caso necessário. Você pode escrever código goto-laden spaghetti. Ou pode criar várias funções e usar a recursão. Mas talvez o modo mais simples e limpo seja construir uma máquina de estado. Aqui está um exemplo de uma máquina de estado que você pode preencher e expandir.

note: type: Plain text
en:  STATE=1
     while true; do
     	case "$STATE" in
      	1)
      		# Two unrelated questions.
     		db_input medium my/question || true
     		db_input medium my/other_question || true
     	;;
     	2)
     		# Only ask this question if the
     		# first question was answered in
     		# the affirmative.
            	db_get my/question
     		if [ "$RET" = "true" ]; then
     			db_input medium my/dep_question || true
     		fi
      	;;
     	*)
     		# The default case catches when $STATE is greater than the
     		# last implemented state, and breaks out of the loop. This
     		# requires that states be numbered consecutively from 1
     		# with no gaps, as the default case will also be entered
     		# if there is a break in the numbering
     		break # exits the enclosing "while" loop
      	;;
      	esac
pt:  STATE=1
     while true; do
     	case "$STATE" in
      	1)
      		# Duas questões não relacionadas.
     		db_input medium my/question || true
     		db_input medium my/other_question || true
     	;;
     	2)
     		# Apenas faz esta pergunta se a
     		# primeira questão foi respondida em
     		# afirmativo.
            	db_get my/question
     		if [ "$RET" = "true" ]; then
     			db_input medium my/dep_question || true
     		fi
      	;;
     	*)
     		# O caso predefinido é capturado quando $STATE é maior que o
     		# último estado implementado, e sai fora do ciclo. Isto
     		# requer que os estados sejam numerados consecutivamente a partir de 1
     		# sem falhas, pois o caso predefinido também irá ser inserido
     		# se houver uma falha na numeração
     		break # sai do delimitador "enquanto" em ciclo
      	;;
      	esac

note: type: Plain text
en:  if [ $STATE -eq 0 ]; then
     	# The user has asked to back up from the first
     	# question. This case is problematical. Regular
     	# dpkg and apt package installation isn't capable
     	# of backing up questions between packages as this
     	# is written, so this will exit leaving the package
     	# unconfigured - probably the best way to handle
     	# the situation.
     	exit 10
     fi
pt:  if [ $STATE -eq 0 ]; then
     	# O utilizador pediu para voltar atrás a partir da primeira
     	# questão. Este caso é problemático. Uma instalação
     	# de pacote regular do dpkg e apt não é capaz de
     	# andar para trás nas questões entre pacotes quando estas
     	# são escritas, portanto isto vai terminar deixando o pacote
     	# por configurar - provavelmente a melhor maneira de lidar com
     	# esta situação.
     	exit 10
     fi

note: type: Plain text
en: Note that if all your config script does is ask a few unrelated questions, then there is no need for the state machine. Just ask them all, and GO; debconf will do its best to present them all in one screen, and the user won't need to back up.
pt: Note que se tudo o que o seu script config faz é perguntar algumas questões não relacionadas, então não há necessidade duma máquina de estado. Apenas pergunte-as todas e, GO; o debconf fará o seu melhor para apresentá-las todas no mesmo écran, e o utilizador não precisa de voltar a trás.

note: type: SS
en: Preventing infinite loops
pt: Prevenindo loops infinitos

note: type: Plain text
en: One gotcha with debconf comes up if you have a loop in your config script. Suppose you're asking for input and validating it, and looping if it's not valid:
pt: Acontece um problema com o debconf se você tem um ciclo no seu script config. Suponha que está a perguntar por uma entrada e a validá-la, e a usar um looping caso não seja válida:

note: type: Plain text
en: This looks ok at first glance. But consider what happens if the value of foo/bar is "" when this loop is entered, and the user has their priority set high, or is using a non-interactive frontend, and so they are not really asked for input. The value of foo/bar is not changed by the db_input, and so it fails the test and loops. And loops ...
pt: isto parece ok à primeira vista. Mas considere o que acontece se o valor de /foo/bar for "" quando se entra neste ciclo, e o utilizador tem a sua prioridade definida para alta, ou está a usar um frontend não-interactivo, e então não lhe é realmente pedido uma entrada. O valor de foo/bar não é alterado pelo db_input, e então falha ao testar e volta a repetir o ciclo vicioso...

note: type: Plain text
en: One fix for this is to make sure that before the loop is entered, the value of foo/bar is set to something that will pass the test in the loop. So for example if the default value of foo/bar is "1", then you could RESET foo/bar just before entering the loop.
pt: Uma correcção para isto é certificar-se que antes de entrar no ciclo, o valor de foo/bar é definido para algo que passe no teste no ciclo. Então por exemplo se o valor predefinido de foo/bar for "1", você pode fazer RESET a foo/bar antes de entrar no ciclo.

note: type: Plain text
en: Another fix is to check the return code of the INPUT command. If it is 30 then the user is not being shown the question you asked them, and you should break out of the loop.
pt: Outra correcção é verifica o código de retorno do comando INPUT. Se for 30 então não está a ser mostrada ao utilizador a pergunta que pediu, e deve sair do ciclo.

note: type: SS
en: Choosing among related packages
pt: Escolhendo entre pacotes relacionados

note: type: Plain text
en: Sometimes a set of related packages can be installed, and you want to prompt the user which of the set should be used by default. Examples of such sets are window managers, or ispell dictionary files.
pt: Por vezes pode ser instalado um conjunto de pacotes relacionados, e você quer perguntar ao utilizador qual dos conjuntos deve ser usado por predefinição. Exemplos de tais conjuntos são os gestores de janelas, ou ficheiros do dicionário ispell.

note: type: Plain text
en: While it would be possible for each package in the set to simply prompt, "Should this package be default?", this leads to a lot of repetitive questions if several of the packages are installed. It's possible with debconf to present a list of all the packages in the set and allow the user to choose between them. Here's how.
pt: Enquanto seria possível para cada pacote no conjunto simplesmente perguntar "Deve este pacote ser predefinido?", isto levaria a um monte de perguntas repetidas se estiverem a ser instalados vários pacotes. É possível com o debconf apresentar uma lista de todos os pacotes no conjunto e permitir ao utilizador escolher entre eles. Aqui está como.

note: type: Plain text
en: Make all the packages in the set use a shared template. Something like this:
pt: Faz com que todos os pacotes no conjunto usem um template partilhado. Algo como isto:

note: type: Plain text
en:  Template: shared/window-manager
     Type: select
     Choices: ${choices}
     Description: Select the default window manager.
      Select the window manager that will be started by
      default when X starts.
pt:  Template: shared/window-manager
     Type: select
     Choices: ${choices}
     Description: Selecciona o gestor de janelas predefinido.
      Selecciona o gestor de janelas que será iniciado por
      predefinição quando o X arranca.

note: type: Plain text
en: Each package should include a copy of the template. Then it should include some code like this in its config script:
pt: Cada pacote deve incluir uma cópia do template. Depois deve incluir algum código como este no seu script config:

note: type: Plain text
en: A bit of an explanation is called for. By the time your config script runs, debconf has already read in all the templates for the packages that are being installed. Since the set of packages share a question, debconf records that fact in the owners field. By a strange coincidence, the format of the owners field is the same as that of the choices field (a comma and space delimited list of values).
pt: É preciso um pouco de explicação. Pela altura em que o seu script config corre, o debconf já leu todos os templates para os pacotes que estão a ser instalados. Como um conjunto de pacotes partilha uma questão, o debconf regista esse facto no campo owners. Por estranha coincidência, o formato do campo owners é o mesmo que aquele do campo choices (uma lista de valores delimitada por vírgulas e espaços).

note: type: Plain text
en: The METAGET command can be used to get the list of owners and the list of choices. If they are different, then a new package has been installed. So use the SUBST command to change the list of choices to be the same as the list of owners, and ask the question.
pt: O comando METAGET pode ser usado para obter a lista de donos e a lista de escolhas. Se forem diferentes, então foi instalado um novo pacote. Então use o comando SUBST para alterar a lista de escolhas para ser o mesmo que a lista de donos, e fazer a pergunta.

note: type: Plain text
en: When a package is removed, you probably want to see if that package is the currently selected choice, and if so, prompt the user to select a different package to replace it.
pt: Quando um pacote é removido, provavelmente você quer ver se esse pacote é a escolha actualmente seleccionada, e se for, avisar o utilizado para seleccionar um pacote diferente para o substituir.

note: type: Plain text
en: This can be accomplished by adding something like this to the prerm scripts of all related packages (replacing E<lt>packageE<gt> with the package name):
pt: Isto pode ser conseguido ao adicionar algo como isto aos scripts prerm de todos os pacotes relacionados (substituindo E<lt>packageE<gt> pelo nome do pacote):

note: type: Plain text
en:  	# See if the shared question still exists.
     	if db_get shared/window-manager; then
     		db_metaget shared/window-manager owners
     		db_subst shared/window-manager choices $RET
     		db_metaget shared/window-manager value
     		if [ "E<lt>packageE<gt>" = "$RET" ] ; then
     			db_fset shared/window-manager seen false
     			db_input high shared/window-manager || true
     			db_go || true
     		fi
pt:  	# Vê se a questão partilhada ainda existe.
     	if db_get shared/window-manager; then
     		db_metaget shared/window-manager owners
     		db_subst shared/window-manager choices $RET
     		db_metaget shared/window-manager value
     		if [ "E<lt>packageE<gt>" = "$RET" ] ; then
     			db_fset shared/window-manager seen false
     			db_input high shared/window-manager || true
     			db_go || true
     		fi

note: type: Plain text
en:  		# Now do whatever the postinst script did
     		# to update the window manager symlink.
     	fi
     fi
pt:  		# Agora faz o que o script postinst fez
     		# para actualizar o link simbólico do gestor de janelas.
     	fi
     fi

note: type: SH
en: HACKS
pt: TRUQUES

note: type: Plain text
en: Debconf is currently not fully integrated into dpkg (but I want to change this in the future), and so some messy hacks are currently called for.
pt: O debconf não está presentemente totalmente integrado com o dpkg (mas queremos mudar isto no futuro), e então actualmente são precisos alguns truques feiosos.

note: type: Plain text
en: The worst of these involves getting the config script to run. The way that works now is the config script will be run when the package is pre-configured. Then, when the postinst script runs, it starts up debconf again. Debconf notices it is being used by the postinst script, and so it goes off and runs the config script. This can only work if your postinst loads up one of the debconf libraries though, so postinsts always have to take care to do that. We hope to address this later by adding explicit support to dpkg for debconf. The B<debconf>(1)  program is a step in this direction.
pt: O pior destes involve meter o script config a correr. O modo como funciona agora é que o script config será executado quando o pacote é pré-configurado. Depois, quando o script postinst corre, arranca o debconf outra vez. O debconf percebe que está a ser usado pelo script postinst, e então desliga-se e corre corre o script config. Isto apenas funciona se o seu postinst carregar uma das bibliotecas do debconf, então os postinsts têm sempre que tratar disso. Nós esperamos dirigir-nos a isto mais tarde ao adicionar suporte explícito ao dpkg para debconf. O programa B<debconf>(1) é um passo nesta direcção.

note: type: Plain text
en: A related hack is getting debconf running when a config script, postinst, or other program that uses it starts up. After all, they expect to be able to talk to debconf right away. The way this is accomplished for now is that when such a script loads a debconf library (like /usr/share/debconf/confmodule), and debconf is not already running, it is started up, and a new copy of the script is re-execed. The only noticeable result is that you need to put the line that loads a debconf library at the very top of the script, or weird things will happen. We hope to address this later by changing how debconf is invoked, and turning it into something more like a transient daemon.
pt: Um truque relacionado e fazer o debconf correr quando um script config, postinst, ou outro programa que o usa, arranque. Afinal de contas, eles esperam poder falar com o debconf imediatamente. A maneira que isto é conseguido por agora é que quanto um tal script carrega uma biblioteca do debconf (como /usr/share/debconf/confmodule), e o debconf não está já a correr, é arrancado, e uma nova cópia do script é re-executada. O único resultado apreciável é que você precisa de colocar a linha que carrega a biblioteca do debconf no topo do script, ou vão acontecer coisas esquisitas. Nós esperamos dirigir-nos a isto mais tarde ao alterar o modo como o debconf é invocado, e transformá-lo em algo como um daemon de transição.

note: type: Plain text
en: It's rather hackish how debconf figures out what templates files to load, and when it loads them. When the config, preinst, and postinst scripts invoke debconf, it will automatically figure out where the templates file is, and load it. Standalone programs that use debconf will cause debconf to look for templates files in /usr/share/debconf/templates/progname.templates.  And if a postrm wants to use debconf at purge time, the templates won't be available unless debconf had a chance to load them in its postinst. This is messy, but rather unavoidable. In the future some of these programs may be able to use debconf-loadtemplate by hand though.
pt: É também um truque o modo como o debconf percebe que ficheiros templates deve carregar, e quando os carrega. Quando os scripts config, preinst e postinst invocam o debconf, ele descobre automaticamente onde está o ficheiro templates, e carrega-o. Os programas standalone que usam debconf irão fazer com que o debconf procure os ficheiro templates em /usr/share/debconf/templates/nome-do-programa.templates. E se um postrm quer usar debconf durante uma purga, os templates não estarão disponíveis a menos que o debconf tenha uma chance de carregá-los no seu postinst. Isto é uma trapalhada, mas inevitável. No futuro alguns destes programas poderão ser capazes de usar debconf-loadtemplate manualmente.

note: type: Plain text
en: /usr/share/debconf/confmodule's historic behavior of playing with file descriptors and setting up a fd #3 that talks to debconf, can cause all sorts of trouble when a postinst runs a daemon, since the daemon ends up talking to debconf, and debconf can't figure out when the script terminates. The STOP command can work around this. In the future, we are considering making debconf communication happen over a socket or some other mechanism than stdio.
pt: O comportamento histórico de /usr/share/debconf/confmodule de jogar com descritores de ficheiros e definindo um fd #3 que fala com debconf, pode causar todo o tipo de problemas quando um postinst corre em daemon, pois o daemon começa a falar com o debconf,e o debconf não consegue perceber quando o script termina. O comando STOP pode contornar isto. No futuro, estamos a considerar fazer com que a comunicação com o debconf aconteça por um socket ou outro mecanismo que não seja o stdio.

note: type: Plain text
en: Debconf sets DEBCONF_RECONFIGURE=1 before running postinst scripts, so a postinst script that needs to avoid some expensive operation when reconfigured can look at that variable. This is a hack because the right thing would be to pass $1 = "reconfigure", but doing so without breaking all the postinsts that use debconf is difficult. The migration plan away from this hack is to encourage people to write postinsts that accept "reconfigure", and once they all do, begin passing that parameter.
pt: Debconf define DEBCONF_RECONFIGURE=1 antes de correr scripts postinst, então um script postinst que precise de evitar alguma operação cara quando reconfigurado pode olhar para essa variável. Isto é um truque porque o correcto seria passar $1 = "reconfigure", mas fazê-lo sem quebrar todos os postinsts que usam debconf é difícil. O plano de migração para fugir a este truque é encorajar as pessoas a escrever postinsts que aceitem "reconfigure", e quanto todos o fizerem, começar a passar esse parâmetro.

note: type: Plain text
en: B<debconf>(7)  is the debconf user's guide.
pt: B<debconf>(7) é o guia do utilizador do debconf.

note: type: Plain text
en: The debconf specification in debian policy is the canonical definition of the debconf protocol. /usr/share/doc/debian-policy/debconf_specification.txt.gz
pt: A especificação debconf na política debian é a definição canónica do protocolo debconf. /usr/share/doc/debian-policy/debconf_specification.txt.gz

note: type: Plain text
en: B<debconf.conf>(5)  has much useful information, including some info about the backend database.
pt: B<debconf.conf>(5) tem muita informação útil, incluindo alguma informação acerca da base de dados backend.
