debhelper 13.11.4 - en to pt translation catalogue (1094 entries)

note: type: =head1
en: NAME
pt: NOME

note: type: textblock
en: debhelper - the debhelper tool suite
pt: debhelper - a suite de ferramentas debhelper

note: type: =head1
en: SYNOPSIS
pt: RESUMO

note: type: =head1
en: DESCRIPTION
pt: DESCRIÇÃO

note: type: textblock
en: Debhelper is used to help you build a Debian package. The philosophy behind debhelper is to provide a collection of small, simple, and easily understood tools that are used in F<debian/rules> to automate various common aspects of building a package. This means less work for you, the packager.  It also, to some degree means that these tools can be changed if Debian policy changes, and packages that use them will require only a rebuild to comply with the new policy.
pt: Debhelper é usado para ajuda-lo a compilar um pacote Debian. A filosofia por detrás de debhelper é disponibilizar uma colecção de ferramentas pequenas, simples e de fácil compreensão que são usadas em F<debian/rules> para automatizar vários aspectos comuns da compilação de um pacote. Isto significa menos trabalho para si, o empacotador. Também significa, até certo ponto, que estas ferramentas podem ser alteradas se a política de Debian alterar, e os pacotes que as usam irão precisar apenas de uma recompilação para ficarem em conformidade com a nova política.

note: type: textblock
en: A typical F<debian/rules> file that uses debhelper will call several debhelper commands in sequence, or use L<dh(1)> to automate this process. Examples of rules files that use debhelper are in F</usr/share/doc/debhelper/examples/>
pt: Um ficheiro F<debian/rules> típico que usa debhelper irá chamar vários comandos debhelper em sequência, ou usar L<dh(1)> para automatizar este processo. Em F</usr/share/doc/debhelper/examples/> estão exemplos de ficheiros de regras que usam debhelper.

note: type: textblock
en: To create a new Debian package using debhelper, you can just copy one of the sample rules files and edit it by hand. Or you can try the B<dh-make> package, which contains a L<dh_make|dh_make(1)> command that partially automates the process. For a more gentle introduction, the B<maint-guide> Debian package contains a tutorial about making your first package using debhelper.
pt: Para criar um novo pacote Debian usando o debhelper, você pode copiar um dos ficheiros de regras exemplo e edita-lo à mão. Ou pode tentar o pacote B<dh-make>, o qual contém um comando L<dh_make|dh_make(1)> que automatiza parcialmente o processo Para uma introdução mais gentil, o pacote Debian B<maint-guide> contém um tutorial acerca de como fazer o seu primeiro pacote usando o debhelper.

note: type: textblock
en: Except where the tool explicitly denotes otherwise, all of the debhelper tools assume that they run from the root directory of an unpacked source package.  This is so they can locate find files like F<debian/control> when needed.
pt: Excepto onde a ferramenta explicitamente denota, caso contrário, todas as ferramentas do debhelper assumem que são corridas a partir do directório raiz de um pacote fonte descompactado. Isto é feito para que possam localizar e encontrar ficheiros como F<debian/control> quando necessário.

note: type: =head1
en: DEBHELPER COMMANDS
pt: COMANDOS DO DEBHELPER

note: type: textblock
en: Here is the list of debhelper commands you can use. See their man pages for additional documentation.
pt: Aqui está a lista dos comandos debhelper que você pode usar. Veja os seus manuais para documentação adicional.

note: type: textblock
en: #LIST#
pt: #LISTA#

note: type: =head2
en: Deprecated Commands
pt: Comandos Descontinuados

note: type: textblock
en: A few debhelper commands are deprecated and should not be used.
pt: Alguns comandos debhelper estão descontinuados e não devem ser usados.

note: type: textblock
en: #LIST_DEPRECATED#
pt: #LISTA_DE_DESCONTINUADOS#

note: type: =head2
en: Other Commands
pt: Outros comandos

note: type: textblock
en: If a program's name starts with B<dh_>, and the program is not on the above lists, then it is not part of the debhelper package, but it should still work like the other programs described on this page.
pt: Se o nome dum programa começa com B<dh_>, e o programa não está nas listas em cima, então não faz parte do pacote debhelper, mas mesmo assim deverá funcionar como os outros programas descritos nesta página.

note: type: =head1
en: DEBHELPER CONFIG FILES
pt: FICHEIROS DE CONFIGURAÇÃO DO DEBHELPER

note: type: textblock
en: Many debhelper commands make use of files in F<debian/> to control what they do. Besides the common F<debian/changelog> and F<debian/control>, which are in all packages, not just those using debhelper, some additional files can be used to configure the behavior of specific debhelper commands. These files are typically named debian/I<package>.foo (where I<package> of course, is replaced with the package that is being acted on).
pt: Muitos comandos do debhelper usam ficheiros em F<debian/> para controlar o que fazem. Para além dos comuns F<debian/changelog> e F<debian/control>, que estão em todos os pacotes, e não apenas aqueles que usam debhelper, alguns ficheiros adicionais podem ser usados para configurar o comportamento de comandos debhelper específicos. Estes ficheiros são chamados tipicamente debian/I<pacote>.foo (onde I<pacote> é claro, é substituído pelo nome do pacote no qual se está a actuar).

note: type: textblock
en: For example, B<dh_installdocs> uses files named F<debian/package.docs> to list the documentation files it will install. See the man pages of individual commands for details about the names and formats of the files they use.  Generally, these files will list files to act on, one file per line. Some programs in debhelper use pairs of files and destinations or slightly more complicated formats.
pt: Por exemplo, B<dh_installdocs> usa ficheiros chamados F<debian/package.docs> para listar os ficheiros de documentação que ira instalar. Veja os manuais individuais dos comandos para detalhes acerca dos nomes e formatos dos ficheiros que usam. Geralmente, estes ficheiros irão listar ficheiros onde se vai actuar, um ficheiro por linha. Alguns programas no debhelper usam pares de ficheiros e destinos ou formatos ligeiramente mais complicados.

note: type: textblock
en: In some rare cases, you may want to have different versions of these files for different architectures or OSes. If files named debian/I<package>.foo.I<ARCH> or debian/I<package>.foo.I<OS> exist, where I<ARCH> and I<OS> are the same as the output of "B<dpkg-architecture -qDEB_HOST_ARCH>" / "B<dpkg-architecture -qDEB_HOST_ARCH_OS>", then they will be used in preference to other, more general files.
pt: Em alguns casos raros, você pode querer ter versões diferentes destes ficheiros para arquitecturas ou sistemas operativos diferentes. Se existirem ficheiros chamados debian/I<pacote>.foo.I<ARCH> ou debian/I<pacote>.foo.I<OS>, onde I<ARCH> e I<OS> são o mesmo que o resultado de "B<dpkg-architecture -qDEB_HOST_ARCH>" / "B<dpkg-architecture -qDEB_HOST_ARCH_OS>", então eles irão ser usados em preferência de outros ficheiros mais gerais.

note: type: textblock
en: Mostly, these config files are used to specify lists of various types of files. Documentation or example files to install, files to move, and so on.  When appropriate, in cases like these, you can use standard shell wildcard characters (B<?> and B<*> and B<[>I<..>B<]> character classes) in the files.  You can also put comments in these files; lines beginning with B<#> are ignored.
pt: Maioritariamente, estes ficheiros de configuração são usados para especificar listas de vários tipos de ficheiros. Documentação ou ficheiros exemplo para instalar, ficheiros para mover, e etc. Quando apropriado, em casos como estes, você pode usar caracteres "wildcard" de shell standard (classes de caracteres B<?> e B<*> e B<[>I<..>B<]>) nos ficheiros. Também pode meter comentários neste ficheiros; as linhas começadas com B<#> são ignoradas.

note: type: textblock
en: The syntax of these files is intentionally kept very simple to make them easy to read, understand, and modify.
pt: A sintaxe destes ficheiros é mantida intencionalmente muito simples para os tornar fáceis de ler, compreender e modificar.

note: type: =head2
en: Substitutions in debhelper config files
pt: Substituições em ficheiros de configuração do debhelper

note: type: textblock
en: In compatibility level 13 and later, it is possible to use simple substitutions in debhelper config files for the following tools:
pt: Em nível de compatibilidade 13 e posterior, é possível usar substituições simples em ficheiros de configuração do debhelper para as seguintes ferramentas:

note: type: textblock
en: All substitution variables are of the form I<${foo}> and the braces are mandatory.  Variable names are case-sensitive and consist of alphanumerics (a-zA-Z0-9), hyphens (-), underscores (_), and colons (:).  The first character must be an alphanumeric.
pt: Todas as variáveis de substituição são do formato I<${foo}> e as chavetas são obrigatórias. Os nomes das variáveis são sensíveis a maiúscula/minúscula e consistem de alfanuméricos (a-zA-Z0-9), hífens (-), underscores (_), and dois pontos (:). O primeiro caractere tem de ser alfanumérico.

note: type: textblock
en: If you need a literal dollar sign that cannot trigger a substitution, you can either use the B<${Dollar}> substitution or the sequence B<${}>.
pt: Se precisar de um sinal literal de dollar que não despolete uma substituição, você pode ou usar a substituição de B<${Dollar}> ou a sequência B<${}>.

note: type: textblock
en: The following expansions are available:
pt: As seguintes expansões estão disponíveis:

note: type: textblock
en: Expands to the relevant L<dpkg-architecture(1)> value (similar to I<dpkg-architecture -qVARIABLE_HERE>).
pt: Expande para o valor L<dpkg-architecture(1)> relevante (semelhante a I<dpkg-architecture -qVARIABLE_HERE>).

note: type: textblock
en: When in doubt, the B<DEB_HOST_*> variant is the one that will work both for native and cross builds.
pt: Em caso de dúvida, a variante B<DEB_HOST_*> é aquela que irá trabalhar para ambas compilações nativas e cruzadas.

note: type: textblock
en: For performance reasons, debhelper will attempt to resolve these names from the environment first before consulting L<dpkg-architecture(1)>.  This is mostly mentioned for completeness as it will not matter for most cases.
pt: Por razões de performance, o debhelper irá tentar resolver esses nomes primeiro a partir do ambiente antes de consultar L<dpkg-architecture(1)>. Isto é muito mencionado para plenitude pois não irá ter importância na maioria dos casos.

note: type: textblock
en: Expands to a single literal B<$>-symbol.  This symbol will I<never> be considered part of a substitution variable.  That is:
pt: Expande para um símbolo literal único B<$>-symbol. Este símbolo I<nunca> irá ser considerado parte de uma variável de substituição. Isso é:

note: type: textblock
en: This variable equivalent to the sequence B<${}> and the two can be used interchangeably.
pt: Esta variável é equivalente à sequência B<${}> e as duas podem ser usadas alternadamente.

note: type: textblock
en: Expands to a single ASCII newline, space and tab respectively.
pt: Expande para uma nova linha ASCII única, espaço e tab respetivamente.

note: type: textblock
en: This can be useful if you need to include a literal whitespace character (e.g. space) where it would otherwise be stripped or used as a separator.
pt: Isto pode ser útil se precisar de incluir um caractere literal de "espaço em branco" (ex. espaço) onde caso contrário ele iria ser descartado ou usado como um separador.

note: type: textblock
en: Expands to the environment variable I<NAME>.  The environment variable must be set (but can be set to the empty string).
pt: Expande para a variável de ambiente I<NAME>. A variável de ambiente tem de estar definida (mas pode estar definida para uma string vazia).

note: type: textblock
en: Note that all variables must expand to a defined value.  As an example, if debhelper sees I<${env:FOO}>, then it will insist that the environment variable I<FOO> is set (it can be set to the empty string).
pt: Note que todas as variáveis têm de expandir para um valor definido. Como exemplo, se o debhelper vir I<${env:FOO}>, então ele irá insistir que a variável de ambiente I<FOO> está definida (pode estar definida para uma string vazia).

note: type: =head3
en: Substitution limits
pt: Limites de substituição

note: type: textblock
en: To avoid infinite loops and resource exhaustion, debhelper will stop with an error if the text contains many substitution variables (50) or they expand beyond a certain size (4096 characters or 3x length of the original input - whichever is bigger).
pt: Para evitar ciclos infinitos e exaustão de recursos, o debhelper irá parar com um erro se o texto conter muitas variáveis de substituição (50) ou se elas expandirem para lá de um determinado tamanho (4096 caracteres ou 3x o comprimento da entrada original - qual deles for maior).

note: type: =head2
en: Executable debhelper config files
pt: Ficheiros de configuração do debhelper executáveis.

note: type: textblock
en: If you need additional flexibility, many of the debhelper tools (e.g. L<dh_install(1)>) support executing a config file as a script.
pt: Se precisar de flexibilidade adicional, muitas das ferramentas debhelper (ex, L<dh_install(1)>) suportam executar um ficheiro de configuração como um script.

note: type: textblock
en: To use this feature, simply mark the config file as executable (e.g. B<< chmod +x debian/I<package>.install >>) and the tool will attempt to execute it and use the output of the script.  In many cases, you can use L<dh-exec(1)> as interpreter of the config file to retain most of the original syntax while getting the additional flexibility you need.
pt: Para usar esta funcionalidade, simplesmente marque o ficheiro de configuração como executável (ex. B<< chmod +x debian/I<package>.install >>) e a ferramenta irá tentar executa-lo e usar o resultado do script. Em muitos casos, você pode usar L<dh-exec(1)> como interpretador do ficheiro de configuração para reter a maioria da sintaxe original enquanto obtém a flexibilidade adicional que precisa.

note: type: textblock
en: When using executable debhelper config files, please be aware of the following:
pt: Quando usar ficheiros de configuração executáveis do debhelper, por favor tenha em atenção o seguinte:

note: type: textblock
en: The executable config file B<must> exit with success (i.e. its return code should indicate success).
pt: O ficheiro de configuração executável B<must> termina com sucesso (isto é, o seu código de retorne deve indicar sucesso).

note: type: textblock
en: If you need the package to build on a file system where you cannot disable the executable bit, then you can use L<dh-exec(1)> and its B<strip-output> script.
pt: Se precisar que o pacote compile num sistema de ficheiros onde não pode desactivar o bit de executável, então você pode usar L<dh-exec(1)> o o seu script B<strip-output>.

note: type: =head1
en: SHARED DEBHELPER OPTIONS
pt: OPÇÕES DO DEBHELPER PARTILHADAS

note: type: textblock
en: The following command line options are supported by all debhelper programs.
pt: As seguintes opções de linha de comandos são suportadas por todos os programas do debhelper.

note: type: textblock
en: Verbose mode: show commands that modify the package build directory.
pt: Modo detalhado: mostra os comandos que modificam o directório de compilação de pacotes.

note: type: textblock
en: Note that verbose mode may also output other "internal" commands that do not directly affect the package build directory.
pt: Note que o modo detalhado pode também gerar resultados de outros comandos "internos" que não afectam diretamente o directório de compilação de pacotes.

note: type: textblock
en: Do not really do anything. If used with -v, the result is that the command will output what it would have done.
pt: Não faz nada na realidade. Se usado com -v, o resultado é que o comando mostra o que iria fazer.

note: type: textblock
en: Act on architecture dependent packages that should be built for the B<DEB_HOST_ARCH> architecture.
pt: Actua em pacotes dependentes da arquitectura que devem ser compilados para a arquitectura de compilação B<DEB_HOST_ARCH>.

note: type: textblock
en: Act on all architecture independent packages.
pt: Actua em todos os pacotes independentes da arquitectura.

note: type: =item
en: B<-p>I<package>, B<--package=>I<package>
pt: B<-p>I<pacote>, B<--package=>I<pacote>

note: type: textblock
en: Act on the package named I<package>. This option may be specified multiple times to make debhelper operate on a given set of packages.
pt: Actua no pacote chamado I<pacote>. Esta opção pode ser especifica várias vezes para fazer o debhelper operar num determinado conjunto de pacotes.

note: type: textblock
en: Deprecated alias of B<-a>.
pt: Alias descontinuado de B<-a>.

note: type: textblock
en: This option is removed in compat 12.
pt: Esta opção foi removida no nível de compatibilidade 12.

note: type: =item
en: B<-N>I<package>, B<--no-package=>I<package>
pt: B<-N>I<pacote>, B<--no-package=>I<pacote>

note: type: textblock
en: Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option lists the package as one that should be acted on.
pt: Não actua no pacote especificado mesmo se uma opção B<-a>, B<-i>, ou B<-p> listarem o pacote como um em que se deverá actuar.

note: type: textblock
en: Do not act on the packages which have already been acted on by this debhelper command earlier (i.e. if the command is present in the package debhelper log).  For example, if you need to call the command with special options only for a couple of binary packages, pass this option to the last call of the command to process the rest of packages with default settings.
pt: Não actua nos pacotes que já foram actuados antes por este comando do debhelper (isto é, se o comando estiver presente no debhelper log do pacote). Por exemplo, se você precisar de chamar o comando com opções especiais apenas para um par de pacotes binários, passe esta opção para a última chamada do comando para processar o resto dos pacotes com as definições predefinidas.

note: type: textblock
en: Use I<tmpdir> for package build directory. The default is debian/I<package>
pt: Usa I<tmpdir> para directório de compilação de pacotes. A predefinição é debian/I<pacote>

note: type: =item
en: B<--mainpackage=>I<package>
pt: B<--mainpackage=>I<pacote>

note: type: textblock
en: This little-used option changes the package which debhelper considers the "main package", that is, the first one listed in F<debian/control>, and the one for which F<debian/foo> files can be used instead of the usual F<debian/package.foo> files.
pt: Esta opção pouco usada muda o pacote que o debhelper considera o "pacote principal", isto é, o primeiro listado em F<debian/control>, e aquele para o qual os ficheiros F<debian/foo> podem ser usados em vez dos ficheiros F<debian/package.foo> usuais.

note: type: =item
en: B<-O=>I<option>|I<bundle>
pt: B<-O=>I<opção>|I<bundle>

note: type: textblock
en: This is used by L<dh(1)> when passing user-specified options to all the commands it runs. If the command supports the specified option or option bundle, it will take effect. If the command does not support the option (or any part of an option bundle), it will be ignored.
pt: Isto é usado pelo L<dh(1)> quando se passa opções específicas do utilizador a todos os comandos que corre. Se o comando suportar a opção ou opções especificadas, irá fazer efeito. Se o comando não suportar a opção (ou alguma parte do conjunto de opções), será ignorado.

note: type: =head1
en: COMMON DEBHELPER OPTIONS
pt: OPÇÕES COMUNS DO DEBHELPER

note: type: textblock
en: The following command line options are supported by some debhelper programs.  See the man page of each program for a complete explanation of what each option does.
pt: As seguintes opções de linha de comandos são suportadas por alguns programas do debhelper. Veja o manual de cada programa para uma explicação completa sobre o que cada opção faz.

note: type: textblock
en: Do not modify F<postinst>, F<postrm>, etc. scripts.
pt: Não modifique os scripts F<postinst>, F<postrm>, etc.

note: type: textblock
en: Exclude an item from processing. This option may be used multiple times, to exclude more than one thing. The I<item> is typically part of a filename, and any file containing the specified text will be excluded.
pt: Exclui um item do processamento. Esta opção pode ser usada várias vezes, para excluir mais do que uma coisa. O I<item> é tipicamente parte de um nome de ficheiro, e qualquer ficheiro que contenha o texto especificado será excluído.

note: type: textblock
en: Makes files or other items that are specified on the command line take effect in ALL packages acted on, not just the first.
pt: Faz com que ficheiros ou outros itens que são especificados na linha de comandos tenham efeito em TODOS os pacotes em que se actua, e não apenas o primeiro.

note: type: =head1
en: BUILD SYSTEM OPTIONS
pt: OPÇÕES DO SISTEMA DE COMPILAÇÃO

note: type: textblock
en: The following command line options are supported by all of the B<dh_auto_>I<*> debhelper programs. These programs support a variety of build systems, and normally heuristically determine which to use, and how to use them.  You can use these command line options to override the default behavior.  Typically these are passed to L<dh(1)>, which then passes them to all the B<dh_auto_>I<*> programs.
pt: As seguintes opções de linha de comandos são suportadas por todos os comandos B<dh_auto_>I<*> do debhelper. Estes programas suportam uma variedade de sistemas de compilação, e normalmente determinam heuristicamente qual usar, e como os usar. Você pode usar estes opções de linha de comandos para sobrepor o comportamento predefinido. Tipicamente estas são passadas ao L<dh(1)>, o qual passa-as a todos os programas B<dh_auto_>I<*>.

note: type: textblock
en: Force use of the specified I<buildsystem>, instead of trying to auto-select one which might be applicable for the package.
pt: Força a utilização do |<buildsystem> especificado, em vez de tentar auto-seleccionar um que pode ser aplicável para o pacote.

note: type: textblock
en: Pass B<none> as I<buildsystem> to disable auto-selection.
pt: Passa B<none> como I<buildsystem> para desactivar a auto-selecção.

note: type: textblock
en: Assume that the original package source tree is at the specified I<directory> rather than the top level directory of the Debian source package tree.
pt: Assume que a árvore fonte do pacote original está no I<directório> especificado em vez de estar no directório de nível de topo da árvore de pacotes fonte de Debian.

note: type: textblock
en: B<Warning>: The B<--sourcedir> variant matches a similar named option in B<dh_install> and B<dh_missing> (etc.) for historical reasons.  While they have a similar name, they have very distinct purposes and in some cases it can cause errors when this variant is passed to B<dh> (when then passes it on to all tools).
pt: B<Aviso>: A variante B<--sourcedir> corresponde a uma opção de nome semelhante em B<dh_install> e B<dh_missing> (etc.) por razões históricas. Apesar de terem nomes semelhantes, elas têm objectivos muito distintos e em alguns casos podem causar erros quando esta variante é passada ao B<dh> (quando então passada para todas as ferramentas).

note: type: textblock
en: Enable out of source building and use the specified I<directory> as the build directory. If I<directory> parameter is omitted, a default build directory will be chosen.
pt: Activa a compilação da fonte e usa o I<directório> especificado como o directório de compilação. Se o parâmetro I<directório> for omitido, é escolhido o directório de compilação predefinido.

note: type: textblock
en: If this option is not specified, building will be done in source by default unless the build system requires or prefers out of source tree building.  In such a case, the default build directory will be used even if B<--builddirectory> is not specified.
pt: Se esta opção não for especificada, a compilação será feita por predefinição na fonte a menos que o sistema de compilação requeira ou prefira a compilação da árvore de fonte. Em tal caso, será usado o directório de compilação predefinido mesmo se B<--builddirectory> não seja especificado.

note: type: textblock
en: If the build system prefers out of source tree building but still allows in source building, the latter can be re-enabled by passing a build directory path that is the same as the source directory path.
pt: Se o sistema de compilação preferir a compilação da árvore fonte mas ainda permitir a compilação da fonte, a última pode ser re-activada ao passar-lhe um caminho para um directório de compilação que é o mesmo que o caminho para o directório fonte.

note: type: textblock
en: Control whether parallel builds should be used if underlying build system supports them.  The number of parallel jobs is controlled by the B<DEB_BUILD_OPTIONS> environment variable (L<Debian Policy, section 4.9.1>) at build time. It might also be subject to a build system specific limit.
pt: Controla se devem ser usadas compilações paralelas se o sistema de compilação o suportar. O número de trabalhos paralelos é controlado pela variável de ambiente B<DEB_BUILD_OPTIONS> (L<Debian Policy, secção 4.9.1>) durante a compilação. Também pode servir como um limite específico do sistema de compilação.

note: type: textblock
en: If neither option is specified, debhelper currently defaults to B<--parallel> in compat 10 (or later) and B<--no-parallel> otherwise.
pt: Se nenhuma destas opções for especificada, presentemente o debhelper usa por predefinição B<--parallel> em modo compatibilidade 10 (ou posterior) e B<--no-parallel> em caso contrário.

note: type: textblock
en: As an optimization, B<dh> will try to avoid passing these options to subprocesses, if they are unnecessary and the only options passed.  Notably this happens when B<DEB_BUILD_OPTIONS> does not have a I<parallel> parameter (or its value is 1).
pt: Como uma optimização, o B<dh> irá tentar evitar passar estas opções aos sub-processos, se estas forem desnecessárias e as únicas opções a passar. De notar que isto acontece quando B<DEB_BUILD_OPTIONS> não tem um parâmetro I<parallel> (ou o seu valor é 1).

note: type: =item
en: B<--max-parallel=>I<maximum>
pt: B<--max-parallel=>I<máximo>

note: type: textblock
en: This option implies B<--parallel> and allows further limiting the number of jobs that can be used in a parallel build. If the package build is known to only work with certain levels of concurrency, you can set this to the maximum level that is known to work, or that you wish to support.
pt: Esta opção implica B<--parallel> e permite mais limitação ao número de trabalhos que podem ser usados numa compilação paralela. Se a compilação do pacote é conhecida por apenas funcionar em certos níveis de concorrência, você pode definir isto para o nível máximo que é sabido funcionar, ou que deseje suportar.

note: type: textblock
en: Notably, setting the maximum to 1 is effectively the same as using B<--no-parallel>.
pt: De notar que, definir o máximo para 1 é efectivamente o mesmo que usar B<--no-parallel>.

note: type: textblock
en: By default, L<dh(1)> will compute several environment variables (e.g. by using L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> tool recompute them.
pt: Por predefinição, o L<dh(1)> irá computar várias variáveis de ambiente (ex. ao usar L<dpkg-buildflags(1)>) e guarda-los em cache para evitar que todas as ferramentas B<dh_auto_*> os recompute.

note: type: textblock
en: When passing this option, the concrete B<dh_auto_*> tool will ignore the cache from L<dh(1)> and retrigger a rebuild of these variables.  This is useful in the very rare case where the package need to do multiple builds but with different B<...FLAGS> options.  A concrete example would be needing to change the B<-O> parameter in B<CFLAGS> in the second build:
pt: Quando se passa esta opção, a ferramenta B<dh_auto_*> concreta irá ignorar a cache de L<dh(1)> e re-despoletar uma recompilação destas variáveis. Isto é útil nos casos muito raros onde o pacote precisa de fazer múltiplas compilações mas com diferentes opções B<...FLAGS>. Um exemplo concreto seria precisar de alterar o parâmetro B<-O> em B<CFLAGS> na segunda compilação:

note: type: textblock
en: Without B<--reload-all-buildenv-variables> in the second call to L<dh_auto_configure(1)>, the change in B<DEB_CFLAGS_MAINT_APPEND> would be ignored as L<dh_auto_configure(1)> would use the cached value of B<CFLAGS> set by L<dh(1)>.
pt: Sem B<--reload-all-buildenv-variables> na segunda chamada ao L<dh_auto_configure(1)>, a alteração em B<DEB_CFLAGS_MAINT_APPEND> seria ignorada pois L<dh_auto_configure(1)> iria usar o valor em cache de <CFLAGS> definido por L<dh(1)>.

note: type: textblock
en: This option is only available with B<< debhelper (>= 12.7~) >> when the package uses compatibility level 9 or later.
pt: Esta opção está apenas disponível com B<< debhelper (>= 12.7~) >> quando o pacote usar nível de compatibilidade 9 ou posterior.

note: type: textblock
en: List all build systems supported by debhelper on this system. The list includes both default and third party build systems (marked as such). Also shows which build system would be automatically selected, or which one is manually specified with the B<--buildsystem> option.
pt: Lista todos os sistemas de compilação suportados pelo debhelper neste sistema. A lista inclui ambos sistemas de compilação predefinidos e de terceiros (marcados como tal). Também mostra qual o sistema de compilação será seleccionado automaticamente, ou qual está especificado manualmente com a opção B<--buildsystem>.

note: type: =head1
en: COMPATIBILITY LEVELS
pt: NÍVEIS DE COMPATIBILIDADE

note: type: textblock
en: From time to time, major non-backwards-compatible changes need to be made to debhelper, to keep it clean and well-designed as needs change and its author gains more experience. To prevent such major changes from breaking existing packages, the concept of debhelper compatibility levels was introduced. You must tell debhelper which compatibility level it should use, and it modifies its behavior in various ways.
pt: De tempos a tempos, precisam de ser feitas grandes alterações no debhelper que não compatíveis com as versões anteriores, para o manter limpo e bem construído quando as necessidades alteram e o seu autor ganha mais experiência. Para prevenir que tais grandes alterações danifiquem os pacotes existentes, foi introduzido o conceito de níveis de compatibilidade no debhelper. Você deve dizer ao debhelper qual o nível de compatibilidade que ele deve usar, e ele modifica o seu comportamento de várias maneiras.

note: type: textblock
en: In current debhelper, you can specify the compatibility level in F<debian/control> by adding a Build-Depends on the debhelper-compat package.  For example, to use v#RECOMMENDED_COMPAT# mode, ensure F<debian/control> has:
pt: No debhelper actual, você pode especificar o nível de compatibilidade em F<debian/control> ao adicionar um Build-Depends no pacote debhelper-compat. Por exemplo, para usar modo v#RECOMMENDED_COMPAT#, assegure que F<debian/control> tem:

note: type: textblock
en: This also serves as an appropriate versioned build dependency on a sufficient version of the debhelper package, so you do not need to specify a separate versioned build dependency on the debhelper package unless you need a specific point release of debhelper (such as for the introduction of a new feature or bugfix within a compatibility level).
pt: Isto também serve como uma dependência de compilação de versão apropriada numa versão suficiente do pacote debhelper, assim você não precisa de especificar uma dependência de compilação de versão separada no pacote debhelper a menos que precise de um lançamento pontual específico do debhelper (tal como para a introdução de uma nova funcionalidade ou correcção de bug dentro de um nível de compatibilidade).

note: type: textblock
en: If needed be, the B<DH_COMPAT> environment variable can be used to override the compat level for a given command.  The feature is mostly useful for either temporarily upgrading a few commands to a new compat level or keeping a few commands on a lower compat level.  The feature is best used sparingly as it effectively introduces special-cases into the F<debian/rules> file that may be surprising to maintainers or reviewers (or, in the long term, to yourself).
pt: Se necessário, a variável de ambiente B<DH_COMPAT> pode ser usada para sobrepor o nível de compatibilidade para um dado comando. Esta funcionalidade é maioritariamente útil seja para actualizar temporariamente alguns comandos para um novo nível de compatibilidade ou manter alguns comandos num nível de compatibilidade inferior. Esta funcionalidade é melhor ser usada com moderação pois introduz efectivamente casos-especiais no ficheiro F<debian/rules> que podem ser surpreendentes para maintainers ou revisores (ou, a longo prazo, para si).

note: type: textblock
en: Unless otherwise indicated, all debhelper documentation assumes that you are using the most recent compatibility level, and in most cases does not indicate if the behavior is different in an earlier compatibility level, so if you are not using the most recent compatibility level, you're advised to read below for notes about what is different in earlier compatibility levels.
pt: A menos que seja indicado o contrário, toda a documentação do debhelper assume que você está a usar o nível de compatibilidade mais recente, e na maioria dos casos não indica se o comportamento é diferente num nível de compatibilidade anterior, portanto se não está a usar o nível de compatibilidade mais recente, você é aconselhado a procurar em baixo por notas acerca do que é diferente nos níveis de compatibilidade anteriores.

note: type: =head2
en: Supported compatibility levels
pt: Níveis de compatibilidade suportados

note: type: textblock
en: The list of supported compatibility levels and the related upgrade check list has moved to L<debhelper-compat-upgrade-checklist(7)>.
pt: A lista dos níveis de compatibilidade suportados e a lista de verificação de actualizações relacionadas foi movida para L<debhelper-compat-upgrade-checklist(7)>.

note: type: =head1
en: NOTES
pt: NOTAS

note: type: =head2
en: Multiple binary package support
pt: Suporte a pacotes de múltiplos binários

note: type: textblock
en: If your source package generates more than one binary package, debhelper programs will default to acting on all binary packages when run. If your source package happens to generate one architecture dependent package, and another architecture independent package, this is not the correct behavior, because you need to generate the architecture dependent packages in the binary-arch F<debian/rules> target, and the architecture independent packages in the binary-indep F<debian/rules> target.
pt: Se o seu pacote fonte gerar mais do que um pacote binário, os programas do debhelper, por predefinição, irão actuar em todos os pacotes binários quando correm. No caso do seu pacote fonte gerar um pacote dependente de arquitectura, e outro pacote independente da arquitectura, este não é o comportamento correcto, porque você precisa de gerar os pacotes dependentes de arquitectura no alvo F<debian/rules> binary-arch, e os pacotes independentes de arquitectura no alvo F<debian/rules> binary-indep.

note: type: textblock
en: To facilitate this, as well as give you more control over which packages are acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative.  If none are given, debhelper programs default to acting on all packages listed in the control file, with the exceptions below.
pt: Para facilitar isto, e também para lhe dar mais controle sobre em quais pacotes os programas debhelper actuam, todos os programas debhelper aceitam os parâmetros B<-a>, B<-i>, B<-p>, e B<-s>. Estes parâmetros são cumulativos. Se nenhum for usado, os programas debhelper por predefinição actuam em todos os pacotes listados no ficheiro de controle, com as excepções em baixo.

note: type: textblock
en: First, any package whose B<Architecture> field in B<debian/control> does not match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, section 5.6.8>).
pt: Primeiro, qualquer pacote cujo campo B<Architecture> em B<debian/control> não corresponda à arquitectura B<DEB_HOST_ARCH> será excluído (L<Debian Policy, secção 5.6.8>).

note: type: textblock
en: Also, some additional packages may be excluded based on the contents of the B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in binary package stanzas in B<debian/control>, according to the draft policy at L<https://wiki.debian.org/BuildProfileSpec>.
pt: Também, alguns pacotes adicionais podem ser excluídos com base no conteúdo da variável de ambiente B<DEB_BUILD_PROFILES> e nos campos B<Build-Profiles> nas estrofes de pacotes binários em B<debian/control>, de acordo com a política proposta em  L<https://wiki.debian.org/BuildProfileSpec>.

note: type: =head3
en: Interaction between package selections and Build-Profiles
pt: Interacção entre selecções de pacotes e Build-Profiles

note: type: textblock
en: Build-Profiles affect which packages are included in the package selections mechanisms in debhelper.  Generally, the package selections are described from the assumption that all packages are enabled.  This section describes how the selections react when a package is disabled due to the active Build-Profiles (or lack of active Build-Profiles).
pt: Build-Profiles afectam quais pacotes são incluídos nos mecanismos de selecção de pacotes do debhelper. Geralmente, as selecções de pacotes são descritas a partir do pressuposto que todos os pacotes estão activados. Esta secção descreve como as selecções reagem quando um pacote é desactivado devido a Build-Profiles activos (ou a falta de Build-Profiles activos).

note: type: =item
en: -a/--arch, -i/--indep OR no selection options (a raw "dh_X" call)
pt: -a/--arch, -i/--indep OU nenhuma opção de selecção (uma chamada "dh_X" crua)

note: type: textblock
en: The package disabled by Build-Profiles is silently excluded from the selection.
pt: O pacote desactivado por Build-Profiles é excluído em silêncio da selecção.

note: type: textblock
en: Note you will receive a warning if I<all> packages related to these selections are disabled.  In that case, it generally does not make sense to do the build in the first place.
pt: Note que vai receber um aviso se I<todos> os pacotes relacionados com estas selecções estiverem desactivados. Nesse caso, geralmente não faz nenhum sentido sequer fazer a compilação.

note: type: textblock
en: The option is accepted and effectively does nothing.
pt: A opção é aceite e efectivamente não faz nada.

note: type: textblock
en: The option is accepted, but debhelper will not act on the package.
pt: A opção é  aceite, mas o debhelper não irá actuar no pacote.

note: type: textblock
en: Note that it does not matter whether a package is enabled or disabled by default.
pt: Note que não importa se um pacote está activado ou desactivado por predefinição.

note: type: =head2
en: Automatic generation of Debian install scripts
pt: Geração automática de scripts de instalação Debian

note: type: textblock
en: Some debhelper commands will automatically generate parts of Debian maintainer scripts. If you want these automatically generated things included in your existing Debian maintainer scripts, then you need to add B<#DEBHELPER#> to your scripts, in the place the code should be added.  B<#DEBHELPER#> will be replaced by any auto-generated code when you run B<dh_installdeb>.
pt: Alguns comandos do debhelper irão gerar automaticamente partes de scripts de maintainer Debian. Se desejar que estas coisas geradas automaticamente sejam incluídas nos sues scripts de maintainer Debian existentes, então você precisa adicionar B<#DEBHELPER#> aos seus scripts, no local onde o código deverá ser adicionado. B<#DEBHELPER#> será substituído por qualquer código auto-gerado quando você correr o B<dh_installdeb>.

note: type: textblock
en: If a script does not exist at all and debhelper needs to add something to it, then debhelper will create the complete script.
pt: Se não existir nenhum script e o debhelper precisar de adicionar algo a ele, então o debhelper irá criar o script completo.

note: type: textblock
en: All debhelper commands that automatically generate code in this way let it be disabled by the -n parameter (see above).
pt: Todos os comandos debhelper que geram código automaticamente deste modo permitem que o seja desactivado pelo parâmetro -n (ver em cima).

note: type: textblock
en: Note that the inserted code will be shell code, so you cannot directly use it in a Perl script. If you would like to embed it into a Perl script, here is one way to do that (note that I made sure that $1, $2, etc are set with the set command):
pt: Note que o código inserido será código shell, portanto você não pode usa-lo directamente num script de Perl. Se desejar embebe-lo num script Perl, aqui está um modo de o fazer (note que Eu certifico-me que $1, $2, etc são definidos com o comando "set"):

note: type: =head2
en: Automatic generation of miscellaneous dependencies.
pt: Geração automática de dependências variadas.

note: type: textblock
en: Some debhelper commands may make the generated package need to depend on some other packages. For example, if you use L<dh_installdebconf(1)>, your package will generally need to depend on debconf. Or if you use L<dh_installxfonts(1)>, your package will generally need to depend on a particular version of xutils. Keeping track of these miscellaneous dependencies can be annoying since they are dependent on how debhelper does things, so debhelper offers a way to automate it.
pt: Alguns programas debhelper podem fazer com que o pacote gerado precise de depender de alguns outros pacotes. Por exemplo, se você usar o L<dh_installdebconf(1)>, o seu pacote irá geralmente depender do debconf. Ou se você usar L<dh_installxfonts(1)>, o seu pacote irá geralmente depender de uma versão particular do xutils. Acompanhar estas dependências variadas pode ser aborrecido pois elas dependem de como o debhelper faz as coisas, então o debhelper oferece um modo de automatizar isto.

note: type: textblock
en: All commands of this type, besides documenting what dependencies may be needed on their man pages, will automatically generate a substvar called B<${misc:Depends}>. If you put that token into your F<debian/control> file, it will be expanded to the dependencies debhelper figures you need.
pt: Todos os comandos deste tipo, além de documentar quais dependências podem ser necessárias nos seus manuais, irão gerar automaticamente um substvar chamado B<${misc:Depends}>. Se você colocar esse token no seu ficheiro F<debian/control>, será expandido às dependências que o debhelper descobre que você precisa.

note: type: textblock
en: This is entirely independent of the standard B<${shlibs:Depends}> generated by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by L<dh_perl(1)>.  You can choose not to use any of these, if debhelper's guesses don't match reality.
pt: Isto é inteiramente independente do standard B<${shlibs:Depends}> gerado pelo L<dh_makeshlibs(1)>, e do B<${perl:Depends}> gerado pelo L<dh_perl(1)>. Você pode escolher usar qualquer um destes, se as escolhas do debhelper não corresponderem à realidade.

note: type: =head2
en: Package build directories
pt: Directórios de compilação de pacotes

note: type: textblock
en: By default, all debhelper programs assume that the temporary directory used for assembling the tree of files in a package is debian/I<package>.
pt: Por predefinição, todos os programas do debhelper assumem que o directório temporário usado para montar a árvore de ficheiros num pacote é debian/I<pacote>.

note: type: textblock
en: Sometimes, you might want to use some other temporary directory. This is supported by the B<-P> flag. For example, "B<dh_installdocs -Pdebian/tmp>", will use B<debian/tmp> as the temporary directory. Note that if you use B<-P>, the debhelper programs can only be acting on a single package at a time. So if you have a package that builds many binary packages, you will need to also use the B<-p> flag to specify which binary package the debhelper program will act on.
pt: Por vezes, você pode querer usar outro directório temporário. Isto é suportado pela bandeira B<-P>, por exemplo, "B<dh_installdocs -Pdebian/tmp>", irá usar B<debian/tmp> como directório temporário. Note que se você usar B<-P>, os programas debhelper só podem actuar num pacote de cada vez. Por isso se tem um pacote que compila muitos pacotes binários, irá também precisar de usar a bandeira B<-p> para especificar em qual pacote binário o programa debhelper irá actuar.

note: type: textblock
en: Debhelper includes support for udebs. To create a udeb with debhelper, add "B<Package-Type: udeb>" to the package's stanza in F<debian/control>.  Debhelper will try to create udebs that comply with debian-installer policy, by making the generated package files end in F<.udeb>, not installing any documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, and F<config> scripts, etc.
pt: Debhelper inclui suporte para udebs. Para criar um udeb com o debhelper, adicione "B<Package-Type: udeb>" à estrofe do pacote em F<debian/control>. O Debhelper irá tentar criar udebs em conformidade com a política do instalador debian, ao finalizar os ficheiros de pacotes gerados com F<.udeb>, não instalando nenhuma documentação num udeb, saltando os scripts F<preinst>, F<postrm>, F<prerm>, e F<config>, etc.

note: type: =head1
en: ENVIRONMENT
pt: AMBIENTE

note: type: textblock
en: This section describes some of the environment variables that influences the behaviour of debhelper or which debhelper interacts with.
pt: Esta secção descreve algumas das variáveis de ambiente que influenciam o comportamento do debhelper ou de quem o debhelper interage.

note: type: textblock
en: It is important to note that these must be actual environment variables in order to affect the behaviour of debhelper (not simply F<Makefile> variables).  To specify them properly in F<debian/rules>, be sure to "B<export>" them. For example, "B<export DH_VERBOSE>".
pt: É importante notar que estas que estas têm de ser mesmo variáveis de ambiente de modo a afectarem o comportamento do debhelper (e não simplesmente variáveis do F<Makefile>). Para as especificar correctamente em F<debian/rules>, assegure-se de lhes fazer "B<export>". Por exemplo, "B<export DH_VERBOSE>"

note: type: textblock
en: Set to a non-empty value to enable verbose mode.  Please see the B<-v> / B<--verbose> option for details.
pt: Definir para um valor não-vazio para activar o modo detalhado. Por favor veja a opção B<-v> / B<--verbose> para detalhes.

note: type: textblock
en: Set to a non-empty value to enable quiet mode. Debhelper will not output commands calling the upstream build system nor will dh print which subcommands are called and depending on the upstream build system might make that more quiet, too.  This makes it easier to spot important messages but makes the output quite useless as buildd log.
pt: Definir para um valor não-vazio para activar o modo silencioso. O Debhelper não irá escrever os comandos a chamar o sistema de compilação do autor nem o dh irá escrever quais sub-comandos são chamados e dependendo do sistema de compilação do autor, poderá também tornar isso mais silencioso. Isto facilita a identificação de mensagens importantes mas torna os resultados inúteis como relatório do buildd.

note: type: textblock
en: Ignored if DH_VERBOSE is also set or B<-v> / B<--verbose> is passed.
pt: É ignorado se DH_VERBOSE estiver também definido ou se for passado B<-v> / B<--verbose>.

note: type: textblock
en: Set to B<1> to enable no-act mode.
pt: Defina para B<1> para activar o modo no-act.

note: type: textblock
en: All debhelper tools will parse command line arguments listed in this variable before any command option (as if they had been prepended to the command line arguments).  Unfortunately, some third-party provided tools may not support this variable and will ignore these command line arguments.
pt: Todas as ferramentas debhelper irão processar os argumentos de linha de comandos listados nesta variável antes de qualquer opção de comando (como se eles fossem anexados aos argumentos de linha de comandos). Infelizmente, algumas ferramentas disponibilizadas por terceiros podem não suportar esta variável e irão ignorar estes argumentos de linha de comandos.

note: type: textblock
en: When using L<dh(1)>, it can be passed options that will be passed on to each debhelper command, which is generally better than using DH_OPTIONS.
pt: Quando se usa L<dh(1)>, podem-se passar opções que irão ser passadas a cada comando do debhelper, o que é geralmente melhor do que usar DH_OPTIONS.

note: type: textblock
en: If set, this adds the value the variable is set to to the B<-X> options of all commands that support the B<-X> option. Moreover, B<dh_builddeb> will B<rm -rf> anything that matches the value in your package build tree.
pt: Se definido, isto adiciona o valor que está definido na variável às opções B<-X> de todos os comandos que suportam a opção B<-X>. Ainda mais, o B<dh_builddeb> irá fazer B<rm -rf> a tudo o que corresponda a esse valor na sua árvore de compilação do pacote.

note: type: textblock
en: This can be useful if you are doing a build from a CVS source tree, in which case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from sneaking into the package you build. Or, if a package has a source tarball that (unwisely) includes CVS directories, you might want to export B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever your package is built.
pt: Isto pode ser útil se você está a fazer uma compilação a partir de uma árvore fonte CVS, que no caso definindo B<DH_ALWAYS_EXCLUDE=CVS> irá prevenir que quaisquer directórios CVS se esgueirem para o pacote que está a compilar. Ou, se um pacote tem um tarball de fonte que (não inteligentemente) inclui directórios CVS, você pode querer exportar B<DH_ALWAYS_EXCLUDE=CVS> em F<debian/rules>, para o fazer ter efeito onde o seu é compilado.

note: type: textblock
en: Multiple things to exclude can be separated with colons, as in B<DH_ALWAYS_EXCLUDE=CVS:.svn>
pt: Várias coisas a excluir podem ser separadas com "dois pontos", como em B<DH_ALWAYS_EXCLUDE=CVS:.svn>

note: type: textblock
en: If set, this adds the specified dh addons to be run in the appropriate places in the sequence of commands. This is equivalent to specifying the addon to run with the --with flag in the debian/rules file. Any --without calls specifying an addon in this environment variable will not be run.
pt: Se definido, isto adiciona os addons especificados do dh para serem corridos nos lugares apropriados na sequência de comandos. Isto é equivalente a especificar o addon a correr coma  bandeira --with no ficheiro debian/rules file. Qualquer chamada --without que especifique um addon nesta variável de ambiente não será executada.

note: type: textblock
en: This is intended to be used by downstreams or specific local configurations that require a debhelper addon to be run during multiple builds without having to patch a large number of rules file. If at all possible, this should be avoided in favor of a --with flag in the rules file.
pt: Isto destina-se a ser usado por downstreams ou configurações locais especificas que requeiram a execução dum addon do debhelper durante múltiplas compilações sem terem que aplica patch a um grande número de ficheiros de regras. Se de todo possível, isto deve ser evitado em favor de uma bandeira --with no ficheiro rules.

note: type: textblock
en: These variables can be used to control whether debhelper commands should use colors in their textual output.  Can be set to "always", "auto" (the default), or "never".
pt: Estas variáveis podem ser usadas para controlar se os comandos do debhelper devem usar cores nos resultados textuais. Podem ser definidas para "always", "auto" (a predefinição), ou "never".

note: type: textblock
en: Note that B<DPKG_COLOR> also affects a number of dpkg related tools and debhelper uses it on the assumption that you want the same color setting for dpkg and debhelper.  In the off-hand chance you want different color setting for debhelper, you can use B<DH_COLORS> instead or in addition to B<DPKG_COLORS>.
pt: Note que B<DPKG_COLOR> também afecta um número de ferramentas relacionadas ao dpkg e o debhelper usa-o na suposição que você quer a mesma definição de cor para o dpkg e debhelper. Na hipótese de você querer definição de cor diferente para o debhelper, pode usar B<DH_COLORS> em vez disso ou em adição a B<DPKG_COLORS>.

note: type: textblock
en: If no explicit request for color has been given (e.g. B<DH_COLORS> and B<DPKG_COLORS> are both unset), the presence of this environment variable cause the default color setting to be "never".
pt: Se não for fornecido um pedido específico para cor  (ex. B<DH_COLORS> e B<DPKG_COLORS> estão ambos não-definidos), a presença desta variável de ambiente faz com que a definição de cor predefinida seja "never".

note: type: textblock
en: The variable is defined according to L<https://no-color.org/>.  In this project, the environment variables (such as B<DH_COLORS>) are considered an explicit request for color.
pt: A variável é definida de acordo com L<https://no-color.org/>.  Neste projecto, as variáveis de ambiente (tais como B<DH_COLORS>) são consideradas um requisito explícito para cor.

note: type: textblock
en: By default (in any non-deprecated compat level), debhelper will automatically set these flags by using L<dpkg-buildflags(1)>, when they are unset.  If you need to change the default flags, please use the features from L<dpkg-buildflags(1)> to do this (e.g. B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-DCUSTOM_MACRO=true>) rather than setting the concrete variable directly.
pt: Por predefinição (em qualquer nível de compatibilidade não-abandonado). o debhelper irá automaticamente definir estas flags ao usar L<dpkg-buildflags(1)>, quando não estiverem definidas. Se você precisar de modificar as flags predefinidas, por favor use as funcionalidades de L<dpkg-buildflags(1)> para o fazer (ex. B<DEB_BUILD_MAINT_OPTIONS=hardening=all> ou B<DEB_CPPFLAGS_MAINT_APPEND=-DCUSTOM_MACRO=true>) em vez de definir a variável concreta directamente.

note: type: textblock
en: In compat 13 and later, these environment variables are reset before invoking the upstream build system via the B<dh_auto_*> helpers.  The variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> (B<dh_auto_test> only) will be set to a writable directory. All remaining variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be cleared.
pt: Em compatibilidade 13 e posterior, estas variáveis de ambiente são reiniciadas antes de invocar o sistema de compilação do autor via ajudantes do B<dh_auto_*>. As variáveis B<HOME> (todos os ajudantes B<dh_auto_*>) e B<XDG_RUNTIME_DIR> (apenas B<dh_auto_test>) irão ser definidas para um directório gravável. Todas as restantes variáveis e B<XDG_RUNTIME_DIR> (excepto para durante B<dh_auto_test>) irão ser limpas.

note: type: textblock
en: The B<HOME> directory will be created as an empty directory but it will be reused between calls to B<dh_auto_*>.  Any content will persist until explicitly deleted or B<dh_clean>.
pt: O directório B<HOME> será criado como um directório vazio mas ele será reutilizado entre chamadas a B<dh_auto_*>. Qualquer conteúdo irá persistir até ser explicitamente apagado ou B<dh_clean>.

note: type: textblock
en: Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment variable.
pt: Por favor veja L</Bandeiras suportadas em DEB_BUILD_OPTIONS> para esta variável de ambiente.

note: type: textblock
en: Please note that this variable should I<not> be altered by package maintainers inside F<debian/rules> to change the behaviour of debhelper.  Instead, where the package maintainer need these features, they should look disabling the relevant feature directly (e.g. by overriding the concrete tools).
pt: Por favor note que esta variável I<não> deve ser alterada por maintainers de pacote dentro de F<debian/rules> para mudar o comportamento do debhelper. Em vez disso, onde o maintainer do pacote precisar destas funcionalidades, eles devem procurar desactivar a funcionalidade relevante directamente (ex. ao sobrepor as ferramentas concretas).

note: type: textblock
en: This is a dpkg specific environment variable (see e.g. L<dpkg-buildflags(1)>).  The debhelper tool suite silently ignores it.
pt: Esta é uma variável de ambiente especifica do dpkg (veja por ex. L<dpkg-buildflags(1)>). A suite de ferramentas do debhelper ignora-a em silêncio.

note: type: textblock
en: It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, which make some people mistakenly assume that debhelper will also react to this variable.
pt: Está documentada aqui porque tem um nome semelhante a B<DEB_BUILD_OPTIONS>, o que faz com que algumas pessoas assumam em erro que o debhelper também vai reagir a esta variável.

note: type: =head2
en: Supported flags in DEB_BUILD_OPTIONS
pt: Bandeiras suportadas em DEB_BUILD_OPTIONS

note: type: textblock
en: The debhelper tool suite reacts to the following flags in B<DEB_BUILD_OPTIONS>.
pt: A suite de ferramentas debhelper reage às seguintes bandeiras em B<DEB_BUILD_OPTIONS>.

note: type: textblock
en: I<This is a debhelper specific value.>
pt: I<Este é um valor específico do debhelper.>

note: type: textblock
en: When B<dherroron> is present and set to B<obsolete-compat-levels>, then debhelper tools will promote deprecation warnings for usage of old soon to be removed compat levels into errors.
pt: Quando B<dherroron> está presente e definida para B<obsolete-compat-levels>, então as ferramentas debhelper irão promover para erros os avisos de descontinuidade de níveis de compatibilidade antigos e prestes a serem removidos.

note: type: textblock
en: This is useful for automated checking for code relying on deprecated compat levels that is scheduled for removal.
pt: Isto é útil para verificação automática de confiança de código em níveis de compatibilidade descontinuados que estão agendados para remoção.

note: type: textblock
en: This option is intended for testing purposes; not production builds.
pt: Esta opção destina-se a objectivos de teste; não compilações produtivas.

note: type: textblock
en: I<This value will change the content of the debs being built.  The .deb packages built when this is set is therefore not bit-for-bit reproducible with a regular build in the general case.>
pt: I<Este valor irá mudar o conteúdo dos debs a serem compilados. Os pacotes .deb compilados quando isto está definido são por isto não reproduzíveis bit-a-bit com uma compilação regular nas generalidade dos casos.>

note: type: textblock
en: This value will cause the official debhelper tools will skip actions and helpers that either remove, detach or deduplicate debugging symbols in ELF binaries.
pt: Este valor irá fazer com que as ferramentas oficiais debhelper saltem acções e ajudantes que ou removem, desanexam ou duplicam símbolos em binários ELF.

note: type: textblock
en: This value affects L<dh_dwz(1)> and L<dh_strip(1)>.
pt: Este valor afecta L<dh_dwz(1)> e L<dh_strip(1)>.

note: type: textblock
en: This value will cause the official debhelper build systems to skip runs of upstream test suites.
pt: Este valor irá fazer com que os sistemas de compilação oficiais debhelper saltem execuções de suites de testes do autor original.

note: type: textblock
en: Package maintainers looking to avoid running the upstream tests should B<not> rely on this.  Instead, they can add an empty override target to skip B<dh_auto_test>.
pt: Os maintainers de pacotes que procurem evitar correr os testes do autor B<não> devem confiar nisto. Em vez disto, eles podem adicionar um alvo de sobreposição vazio para saltar o B<dh_auto_test>.

note: type: textblock
en: This value affects L<dh_auto_test(1)>.
pt: Este valor afecta L<dh_auto_test(1)>.

note: type: textblock
en: This value will cause several debhelper tools to skip installation of documentation such as manpages or upstream provided documentation.  Additionally, the tools will also ignore if declared documentation is "missing" on the assumption that the documentation has not been built.
pt: Este valor irá fazer com que várias ferramentas debhelper saltem a instalação de documentação tal como os manuais ou documentação fornecida pelo autor original. Adicionalmente, as ferramentas irão também ignorar se a documentação declarada está "em falta" assumindo que a documentação não foi compilada.

note: type: textblock
en: This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is working with documentation.
pt: Este valor afecta ferramentas do I<tipo> L<dh_installdocs(1)>, que I<sabem> que estão a trabalhar com documentação.

note: type: textblock
en: This value will cause L<dh_installchangelogs(1)> to act as if it had been passed the B<--no-trim> option, forcing it to forgo removing older entries from changelogs.
pt: Este valor irá fazer o L<dh_installchangelogs(1)> actuar como se tivesse passado a opção B<--no-trim>, forçando-o a renunciar a remoção de entradas antigas dos registos de alterações.

note: type: textblock
en: I<The official name is noautodbgsym.  The noddebs variant is accepted for historical reasons.>
pt: I<O nome oficial é noautodbgsym. A variante noddebs é aceite por razões históricas.>

note: type: textblock
en: This value causes debhelper to skip the generation of automatically generated debug symbol packages.
pt: Este valor faz com que o debhelper salte a geração de pacotes de símbolos de depuração gerados automaticamente.

note: type: textblock
en: This value affects L<dh_strip(1)>.
pt: Este valor afecta L<dh_strip(1)>.

note: type: textblock
en: This value enables debhelper to use up to B<N> threads or processes (subject to parameters like B<--no-parallel> and B<--max-parallel=M>).  Not all debhelper tools work with parallel tasks and may silently ignore the request.
pt: Este valor habilita o debhelper a usar até B<N> linhas de processos (sujeitos a parâmetros como B<--no-parallel> e B<--max-parallel=M>). Nem todas as ferramentas  debhelper trabalham com tarefas paralelas e podem ignorar o pedido em silêncio.

note: type: textblock
en: This value affects many debhelper tools.  Most notably B<dh_auto_*>, which will attempt to run the underlying upstream build system with that number of threads.
pt: Este valor afecta muitas ferramentas debhelper. Mais notoriamente B<dh_auto_*>, a qual irá tentar correr o sistema de compilação subjacente do autor com esse número de linhas de execução.

note: type: textblock
en: This value will cause the official debhelper build systems to configure upstream builds to be terse (i.e. reduce verbosity in their output).  This is subject to the upstream and the debhelper build system supporting such features.
pt: Este valor irá fazer com que os sistemas de compilação oficiais debhelper configurem as compilações do autor para serem concisas (isto é, reduzir os detalhes dos seus resultados). Isto está sujeito a que os sistemas de compilação do autor e do debhelper suportem tais funcionalidades.

note: type: textblock
en: This value affects most B<dh_auto_*> tools directly. For commands provided by the debhelper package, it also causes the tools to act like the B<DH_QUIET> environment variable was non-empty.
pt: Este valor afecta a maioria das ferramentas B<dh_auto_*> diretamente. Para comandos fornecidos pelo pacote debhelper, também faz com que as ferramentas actuem como se a variável de ambiente B<DH_QUIET> estiver não-vazia.

note: type: textblock
en: Unknown flags are silently ignored.
pt: Bandeiras desconhecidas são ignoradas em silêncio.

note: type: textblock
en: Note third-party debhelper-like tools or third-party provided build systems may or may not react to the above flags.  This tends to depend on implementation details of the tool.
pt: Note que ferramentas de terceiros estilo-debhelper ou sistemas de compilação fornecidos por terceiros podem não reagir às bandeiras em cima. Isto tende a depender dos detalhes de implementação da ferramenta.

note: type: =head1
en: SEE ALSO
pt: VEJA TAMBÉM

note: type: textblock
en: List of supported compat levels and an upgrade checklist for each of them.
pt: Lista de níveis de compatibilidade suportados e uma lista de verificação de actualização para cada um deles.

note: type: textblock
en: A set of example F<debian/rules> files that use debhelper.
pt: Um conjunto de ficheiros F<debian/rules> exemplo que usam debhelper.

note: type: textblock
en: Debhelper web site.
pt: Sítio web do debhelper.

note: type: =head1
en: AUTHOR
pt: AUTOR

note: type: textblock
en: debhelper-compat-upgrade-checklist - Upgrade checklist for supported debhelper compat levels
pt: debhelper-compat-upgrade-checklist - Actualiza a lista de verificação para níveis de compatibilidade do debhelper suportados.

note: type: textblock
en: Information about how to declare the compat level is in L<debhelper(7)/COMPATIBILITY LEVELS>.
pt: Informação sobre como declarar os níveis de compatibilidade está em L<debhelper(7)/NÍVEIS DE COMPATIBILIDADE>.

note: type: textblock
en: If you are upgrading from a (now) obsolete compat level, then please refer to L<debhelper-obsolete-compat(7)>.
pt: Se você está a actualizar a partir de um nível de compatibilidade (agora) obsoleto, então por favor consulte L<debhelper-obsolete-compat(7)>.

note: type: =head2
en: Upgrade checklist for supported compatibility levels
pt: Actualizar lista de verificação para os níveis de compatibilidade suportados.

note: type: textblock
en: These are the available compatibility levels:
pt: Estes são os níveis de compatibilidade disponíveis:

note: type: textblock
en: This compatibility level is still open for development; use with caution.
pt: Este nível de compatibilidade ainda está aberto em desenvolvimento; use com cuidado.

note: type: textblock
en: Changes from v14 are:
pt: As alterações a partir de v14 são:

note: type: textblock
en: The B<dh_auto_install> tool no longer defaults to B<< --destdir=debian/I<package> >> for source packages only producing a single binary.  If this behaviour is wanted, the package should explicitly activate the B<single-binary> dh addon (e.g., by adding B<dh-sequence-single-binary> to B<Build-Depends>) or pass B<--destdir> to B<dh_auto_install>.
pt: A ferramenta B<dh_auto_install> já não usa por predefinição B<< --destdir=debian/I<package> >> para pacotes fonte que apenas produzem um único binário. Se este comportamento é desejado, o pacote deve activar explicitamente o addon do dh B<single-binary> (ex. ao adicionar B<dh-sequence-single-binary> a B<Build-Depends>) ou passar B<--destdir> a B<dh_auto_install>.

note: type: textblock
en: The rationale for this change is to avoid "surprises" when adding a second binary package later.  Previously, debhelper would silently change behaviour often resulting in empty binary packages being uploaded to the archive by mistake. With the new behaviour, the B<single-binary> addon will detect the mismatch and warn the maintainer of what is about to happen.
pt: A razão para esta alteração é evitar "surpresas" ao adicionar um segundo pacote binário mais tarde. Anteriormente, o debhelper iria em silêncio alterar o comportamento muitas vezes resultado em pacotes binários vazios a serem enviados para o arquivo por engano. Com o novo comportamento, o addon B<single-binary> irá detectar a discrepância e avisar o maintainer do que está prestes a acontecer.

note: type: textblock
en: Changes from v13 are:
pt: As alterações a partir de v13 são:

note: type: textblock
en: The B<dh_installpam> tool will now install PAM configuration files under F<< /usr/lib/pam.d/I<package> >> instead of F<< /etc/pam.d/I<package> >>.
pt: A ferramenta B<dh_installpam> irá agora instalar ficheiros de configuração do PAM sob F<< /usr/lib/pam.d/I<package> >> em vez de F<< /etc/pam.d/I<package> >>.

note: type: textblock
en: Please consider using the "rm_conffile" feature from L<dh_installdeb(1)> to ensure the proper removal of previous PAM files.
pt: Por favor considere usar a funcionalidade "rm_conffile" de L<dh_installdeb(1)> para assegurar a remoção apropriada dos ficheiros PAM anteriores.

note: type: textblock
en: The tool B<dh_installsysusers> is now included in the default sequence. This helper tool will process systemd sysusers files.
pt: A ferramenta B<dh_installsysusers> está agora incluída na sequência predefinida. Esta ferramenta de ajuda irá processar ficheiros sysusers do systemd.

note: type: textblock
en: Use of the B<dh_gconf> command in override and hook targets now causes an error.  The B<dh_gconf> command has been a no-op for years and was removed in debhelper 13.4.
pt: Usar o comando B<dh_gconf> em alvos de sobreposição e hook agora causa um erro. O comando B<dh_gconf> foi um não-operativo durante anos e foi removido no debhelper 13.4.

note: type: textblock
en: The B<dh_installalternatives> tool will now be run after B<dh_link> rather than after B<dh_installinitramfs> in the default B<dh> sequence.
pt: A ferramenta B<dh_installalternatives> irá agora correr após B<dh_link> em vez de após B<dh_installinitramfs> na sequência predefinida do B<dh>.

note: type: textblock
en: The B<dh> sequencer will warn if the B<single-binary> addon is implicitly activated to warn maintainers of the pending compat 15 change in B<dh_auto_install>.
pt: O sequenciador B<dh> irá avisar se o addon B<single-binary> for activado implicitamente para avisar os maintainers da pendente alteração na compatibilidade 15 em B<dh_auto_install>.

note: type: textblock
en: Maintainers are urged to either explicitly activate the B<single-binary> addon to preserve the existing behaviour (e.g., by adding B<dh-sequence-single-binary> to Build-Depends), or explicitly passing B<--destdir> to B<dh_auto_install> if used and then passing B<--without single-binary> to B<dh> (the latter to silence the warning).
pt: Maintainers são incentivados a ou activar explicitamente o addon B<single-binary> para preservar o comportamento existente (ex. ao adicionar <dh-sequence-single-binary> a Build-Depends), ou passar explicitamente B<--destdir> a B<dh_auto_install> se usado e depois passar B<--without single-binary> a B<dh> (a última para silenciar o aviso).

note: type: textblock
en: The B<cmake> buildsystem now passes B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some reproducibility issues.
pt: O sistema de compilação B<cmake> agora passa B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> a L<cmake(1)> para evitar alguns problemas de reprodutibilidade.

note: type: textblock
en: This is the recommended mode of operation.
pt: Este é o modo de operação recomendado.

note: type: textblock
en: Changes from v12 are:
pt: As alterações a partir de v12 são:

note: type: textblock
en: The B<meson+ninja> build system now uses B<meson test> instead of B<ninja test> when running the test suite.  Any override of B<dh_auto_test> that passes extra parameters to upstream test runner should be reviewed as B<meson test> is not command line compatible with B<ninja test>.
pt: O sistema de compilação B<meson+ninja> agora usa B<meson test> em vez de B<ninja test> quando corre a suite de testes. Qualquer sobreposição de B<dh_auto_test> que passe parâmetros extra ao testador original do autor deve ser revista, pois o B<meson test> não é compatível em linha de comandos com o B<ninja test>.

note: type: textblock
en: All debhelper like tools based on the official debhelper library (including B<dh> and the official B<dh_*> tools) no longer accepts abbreviated command parameters.  At the same time, B<dh> now optimizes out calls to redundant B<dh_*> helpers even when passed long command line options.
pt: Todas as ferramentas tipo debhelper baseadas na biblioteca debhelper oficial (incluindo B<dh> e as ferramentas oficiais B<dh_*>) não aceitam mais parâmetros abreviados de comandos. Ao mesmo tempo, B<dh> agora optimiza as chamadas a ajudantes redundantes B<dh_*> mesmo quando passa opções longas da linha de comandos.

note: type: textblock
en: The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, B<dh_makeshlibs>, B<dh_shlibdeps>) are now only run for arch dependent packages by default (i.e. they are excluded from B<*-indep> targets and are passed B<-a> by default). If you need them for B<*-indep> targets, you can add an explicit Build-Depends on B<dh-sequence-elf-tools>.
pt: As ferramentas debhelper relacionadas com ELF (B<dh_dwz>, B<dh_strip>, B<dh_makeshlibs>, B<dh_shlibdeps>) são agora apenas executadas para os pacotes dependentes de arquitectura por predefinição (isto é, estão excluídas de alvos B<*-indep> e são passadas B<-a> por predefinição). Se você precisar delas para alvos B<*-indep>, você pode adicionar um Build-Depends explícito em B<dh-sequence-elf-tools>.

note: type: textblock
en: The third-party B<gradle> build system (from B<gradle-debian-helper> package) now runs the upstream-provided test suite automatically.  To suppress such behavior, override B<dh_auto_test>.
pt: O sistema de compilação de terceiros B<gradle> (do pacote B<gradle-debian-helper>) agora corre a suite de testes disponibilizada pelo autor automaticamente. Para suprimir tal comportamento, sobreponha B<dh_auto_test>.

note: type: textblock
en: The B<dh_installman> tool now aborts if it sees conflicting definitions of a manpage.  This typically happens if the upstream build system is installing a compressed version and the package lists an uncompressed version of the manpage in F<< debian/I<package>.manpages >>.  Often the easiest fix is to remove the manpage from F<< debian/I<package>.manpages >> (assuming both versions are identical).
pt: A ferramenta B<dh_installman> agora aborta se vir definições conflituosas de uma manpage. Isto tipicamente acontece se o sistema de compilação do autor está a instalar uma versão comprimida e o pacote lista uma versão descomprimida da manpage em F<< debian/I<package>.manpages >>.  Muitas vezes a correção mais fácil é remover a manpage de F<< debian/I<package>.manpages >> (assumindo que ambas as versões são idênticas).

note: type: textblock
en: The B<dh_auto_*> helpers now reset the environment variables B<HOME> and common B<XDG_*> variable.  Please see description of the environment variables in L</ENVIRONMENT> for how this is handled.
pt: Os ajudantes de B<dh_auto_*> agora reiniciam as variáveis de ambiente B<HOME> e variável comum B<XDG_*>. Por favor veja a descrição das variáveis de ambiente em L</ENVIRONMENT> para como lidar com isto.

note: type: textblock
en: I<This feature changed between debhelper 13 and debhelper 13.2.>
pt: I<Esta funcionalidade mudou entre debhelper 13 e debhelper 13.2.>

note: type: textblock
en: The B<dh> command will now error if an override or hook target for an obsolete command are present in F<debian/rules> (e.g. B<override_dh_systemd_enable:>).
pt: O comando B<dh> ir+a agora dar erro se estiver presente um alvo de sobreposição ou hook para um comando obsoleto em F<debian/rules> (ex.B<override_dh_systemd_enable:>).

note: type: textblock
en: The B<dh_missing> command will now default to B<--fail-missing>.  This can be reverted to a non-fatal warning by explicitly passing B<--list-missing> like it was in compat 12.
pt: O comando B<dh_missing> irá agora usar por predefinição B<--fail-missing>. Isto pode ser revertido para um aviso não fatal ao passar explicitamente B<--list-missing> como era na compatibilidade 12.

note: type: textblock
en: If you do not want the warning either, please omit the call to B<dh_missing>.  If you use the B<dh> command sequencer, then you can do this by inserting an empty override target in the F<debian/rules> file of the relevant package.  As an example:
pt: Se você também não quiser o aviso, por favor omita a chamada ao B<dh_missing>.  Se você usar o sequenciador de comandos B<dh>, então pode fazer isto ao inserir um alvo de sobreposição vazio no ficheiro F<debian/rules> do pacote relevante. Como exemplo:

note: type: textblock
en: The B<dh> command sequencer now runs B<dh_installtmpfiles> in the default sequence.  The B<dh_installtmpfiles> takes over handling of tmpfiles.d configuration files.  Related functionality in B<dh_installsystemd> is now disabled.
pt: O sequenciador de comandos B<dh> agora corre B<dh_installtmpfiles> na sequência predefinida. O B<dh_installtmpfiles> assume o manusear dos ficheiros de configuração tmpfiles.d. A funcionalidade relacionada em B<dh_installsystemd> está agora desactivada.

note: type: textblock
en: Note that B<dh_installtmpfiles> responds to F<< debian/I<package>.tmpfiles >> where B<dh_installsystemd> used a name without the trailing "s".
pt: Note que B<dh_installtmpfiles> responde a F<< debian/I<package>.tmpfiles >> onde B<dh_installsystemd> usou um nome sem o "s" final.

note: type: textblock
en: Many B<dh_*> tools now support limited variable expansion via the B<${foo}> syntax.  In many cases, this can be used to reference paths that contain either spaces or L<dpkg-architecture(1)> values.  While this can reduce the need for L<dh-exec(1)> in some cases, it is B<not> a replacement L<dh-exec(1)> in general.  If you need filtering, renaming, etc., the package will still need L<dh-exec(1)>.
pt: Muitas ferramentas B<dh_*> agora suportam expansão de variáveis limitada via sintaxe B<${foo}>. Em muitos casos, isto pode ser usado para referenciar caminhos que contêm ou espaços ou valores L<dpkg-architecture(1)>. Enquanto isto pode reduzir a necessidade de L<dh-exec(1)> em alguns casos, B<não> é um substituto de L<dh-exec(1)> em geral. Se você precisar de filtrar, renomear, etc... o pacote irá continuar a precisar de L<dh-exec(1)>.

note: type: textblock
en: Please see L</Substitutions in debhelper config files> for syntax and available substitution variables.  To B<dh_*> tool writers, substitution expansion occurs as a part of the B<filearray> and B<filedoublearray> functions.
pt: Por favor veja L<Substituições em ficheiros de configuração do debhelper> para sintaxe e variáveis de substituição disponíveis. Para os escritores da ferramenta  B<dh_*>, a expansão de substituição ocorre como parte das funções B<filearray> e B<filedoublearray>.

note: type: textblock
en: The B<dh> command sequencer will now skip all hook and override targets for B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> lists the relevant B<nocheck> / B<nostrip> options.
pt: O sequenciador de comandos B<dh> irá agora saltar todos os alvos hook e de sobreposição para B<dh_auto_test>, B<dh_dwz> e B<dh_strip> quando B<DEB_BUILD_OPTIONS> listar as opções B<nocheck> / B<nostrip> relevantes.

note: type: textblock
en: Any package relying on these targets to always be run should instead move relevant logic out of those targets.  E.g. non-test related packaging code from B<override_dh_auto_test> would have to be moved to B<execute_after_dh_auto_build> or B<execute_before_dh_auto_install>.
pt: Qualquer pacote que se apoie nestes alvos para ser sempre corrido deve, em vez disto, mover a lógica relevante para fora destes alvos. Ex, código de empacotamento não relacionado com testes a partir de B<override_dh_auto_test> deverá ser movido para B<execute_after_dh_auto_build> ou B<execute_before_dh_auto_install>.

note: type: textblock
en: The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> to L<cmake(1)> to speed up automatic installation process. If for some reason you need previous behavior, override the flag:
pt: O sistema de compilação B<cmake> agora passa B<-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> ao L<cmake(1)> para acelerar o processo de instalação automática. Se por alguma razão você precisar do comportamento anterior, sobreponha a flag:

note: type: textblock
en: Changes from v11 are:
pt: As alterações a partir de v11 são:

note: type: textblock
en: The B<dh_makeshlibs> tool now generates shlibs files with versioned dependency by default.  This means that B<-VUpstream-Version> (a.k.a. B<-V>) is now the default.
pt: A ferramenta B<dh_makeshlibs> agora gera ficheiros shlibs com dependência de versão por predefinição. Isto significa que B<-VUpstream-Version> (a.k.a. B<-V>) é agora a predefinição.

note: type: textblock
en: If an unversioned dependency in the shlibs file is wanted, this can be obtained by passing B<-VNone> instead.  However, please see L<dh_makeshlibs(1)> for the caveat of unversioned dependencies.
pt: Se é pedida uma dependência sem versão no ficheiros shlibs, isto pode ser conseguido ao passar B<-VNone> em substituição. No entanto, por favor veja L<dh_makeshlibs(1)> para a  problemática das dependências sem versão.

note: type: textblock
en: The B<-s> (B<--same-arch>) option is removed.  Please use B<-a> (B<--arch>) instead.
pt: A opção B<-s> (B<--same-arch>) foi removida. Por favor use B<-a> (B<--arch>) em vez desta.

note: type: textblock
en: Invoking B<dh_clean -k> now causes an error instead of a deprecation warning.
pt: Invocar B<dh_clean -k> agora causa um erro em vez de um aviso de descontinuação.

note: type: textblock
en: The B<--no-restart-on-upgrade> option in B<dh_installinit> has been removed.  Please use the new name B<--no-stop-on-upgrade>
pt: A opção B<--no-restart-on-upgrade> em B<dh_installinit> foi removida. Por favor use o novo nome B<--no-stop-on-upgrade>

note: type: textblock
en: There was a bug in the B<doit> (and similar) functions from L<Debian::Debhelper::Dh_Lib> that made them spawn a shell in one particular circumstance.  This bug is now removed and will cause helpers that rely on the bug to fail with a "command not found"-error.
pt: Existia um bug nas funções B<doit> (e similares) a partir de L<Debian::Debhelper::Dh_Lib> que fazia aparece uma linha de comandos numa circunstância particular. Este bug foi agora removido e irá fazer com que os ajudantes que contavam com esse bug falhem com um erro de "comando não encontrado".

note: type: textblock
en: The B<--list-missing> and B<--fail-missing> in B<dh_install> has been removed.  Please use B<dh_missing> and its corresponding options, which can also see the files installed by other helpers.
pt: O B<--list-missing> e B<--fail-missing> em B<dh_install> foram removidos. Por favor use B<dh_missing> e as suas opções correspondentes, o qual pode também ver os ficheiros instalados por outros ajudantes.

note: type: textblock
en: The B<dh_installinit> helper no longer installs configuration for the upstart init system.  Instead, it will abort the build if it finds an old upstart configuration file.  The error is there to remind the package maintainer to ensure the proper removal of the conffiles shipped in previous versions of the package (if any).
pt: O ajudante B<dh_installinit> já não instala configuração para o sistema de init upstart. Em vez disso, irá abortar a compilação se encontrar um ficheiro de configuração upstart antigo. O erro está lá para lembrar ao maintainer do pacote para assegurar a remoção apropriada dos ficheiros de configuração empacotados em versões anteriores do pacote (caso existam).

note: type: textblock
en: The B<dh_installdeb> tool will do basic validation of some L<dpkg-maintscript-helper(1)> commands and will error out if the commands appear to be invalid.
pt: A ferramenta B<dh_installdeb> irá fazer validação básica de alguns comandos L<dpkg-maintscript-helper(1)> e irá terminar em erro se os comandos parecerem ser inválidos.

note: type: textblock
en: The B<dh_missing> tool will now default to B<--list-missing>.
pt: A ferramenta B<dh_missing> irá agora usar por predefinição B<--list-missing>.

note: type: textblock
en: The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-gensymbols(1)> if the ELF binary has a SONAME (containing ".so").
pt: A ferramenta B<dh_makeshlibs> irá agora apenas passar bibliotecas para L<dpkg-gensymbols(1)> se o binário ELF tiver um SONAME (contendo ".so").

note: type: textblock
en: The B<dh_compress> tool no longer compresses examples (i.e. anything installed in F<</usr/share/doc/I<package>/examples>>.)
pt: A ferramenta B<dh_compress> não mais comprime exemplos (isto é, nada instalado em F<</usr/share/doc/I<pacote>/examples>>.)

note: type: textblock
en: The standard sequence in B<dh> now includes B<dh_dwz> and B<dh_installinitramfs> by default.  This makes the B<dwz> and B<installinitramfs> sequences obsolete and they will now fail with an error.  If you want to skip these commands, then please insert an empty override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)
pt: A sequência standard em B<dh> agora inclui B<dh_dwz> e B<dh_installinitramfs> por predefinição. Isto tornas as sequências B<dwz> e B<installinitramfs> obsoletas e elas agora irão falhar com um erro. Se desejar saltar estes comandos, por favor insira um alvo de sobreposição vazio para eles em F<debian/rules> (ex. I<override_dh_dwz:>)

note: type: textblock
en: The build systems B<meson> and B<autoconf> no longer explicitly set the B<--libexecdir> variable and thus relies on the build system default - which should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5).
pt: Os sistemas de compilação B<meson> e B<autoconf> não mais definem explicitamente a variável B<--libexecdir> e assim apoia-se na predefinição do sistema de compilação - O qual deve ser B</usr/libexec> (por FHS 3.0, adoptado em Debian Policy 4.1.5).

note: type: textblock
en: If a particular upstream package does not use the correct default, the parameter can often be passed manually via L<dh_auto_configure(1)>.  E.g.  via the following example:
pt: Se um determinado pacote original do autor não usar a predefinição correcta, o parâmetro pode muitas vezes ser passado manualmente  via L<dh_auto_configure(1)>. Por exemplo via seguinte exemplo:

note: type: textblock
en: Note the B<--> before the B<--libexecdir> parameter.
pt: Note o B<--> antes do parâmetro B<--libexecdir>.

note: type: textblock
en: B<Retroactively removed in debhelper/13.5>:
pt: B<Retroativamente removido em debhelper/13.5>:

note: type: textblock
en: The B<dh_installdeb> tool would no longer installs the maintainer provided F<conffiles> file as it was deemed unnecessary.  However, the B<remove-on-upgrade> from dpkg/1.20 made the file relevant again and B<dh_installdeb> now installs it again in compat levels 12+.
pt: A ferramenta B<dh_installdeb> não iria mais instalar o ficheiro F<conffiles> fornecido pelo responsável pois isso foi considerado desnecessário. No entanto, o B<remove-on-upgrade> do dpkg/1.20 tornou o ficheiro relevante de novo e B<dh_installdeb> agora instala-o nos níveis de compatibilidade 12+.

note: type: textblock
en: The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for handling systemd services that have a sysvinit alternative.  Both tools must now be used in such a case to ensure the service is properly started under both sysvinit and systemd.
pt: A ferramenta B<dh_installsystemd> não mais se apoia em B<dh_installinit> para lidar com os serviços do systemd que têm uma alternativa de sysvinit. ambas ferramentas devem agora ser usadas em tais casos para assegurar que o serviço é arrancado correctamente sob ambos sysvinit e systemd.

note: type: textblock
en: If you have an override for B<dh_installinit> (e.g. to call it with B<--no-start>) then you will probably need one for B<dh_installsystemd> as well now.
pt: Se tiver uma sobreposição para B<dh_installinit> (ex. para chama-lo com B<--no-start>) então irá provavelmente precisar agora também de um para B<dh_installsystemd>.

note: type: textblock
en: This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< init-system-helpers (>= 1.54~) >>.  Please ensure that the package lists B<${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to compat 12.
pt: Esta alteração faz B<dh_installinit> injectar um I<misc:Pre-Depends> para B<< init-system-helpers (>= 1.54~) >>.  Por favor assegure que o pacote lista B<${misc:Pre-Depends}> no seu campo B<Pre-Depends> antes de actualizar para a compatibilidade 12.

note: type: textblock
en: The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev packages and not only during the building process. Please set B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples.
pt: Esta ferramenta de terceiros B<dh_golang> (do pacote B<dh-golang>) agora por predefinição honra a variável B<DH_GOLANG_EXCLUDES> para instalação fonte em pacotes -dev e não apenas durante o processo de compilação. Por favor defina B<DH_GOLANG_EXCLUDES_ALL> para falso para reverter para o comportamento anterior. Veja B<Debian::Debhelper::Buildsystem::golang(3pm)> para detalhes e exemplos

note: type: textblock
en: B<dh_installsystemduser> is now included in the B<dh> standard sequence by default.
pt: B<dh_installsystemduser> é agora incluído na sequência standard do B<dh> por predefinição.

note: type: textblock
en: The B<python-distutils> buildsystem is now removed.  Please use the third-party build system B<pybuild> instead.
pt: O sistema de compilação B<python-distutils> foi agora removido. Por favor use o sistema de compilação de terceiros B<pybuild> em substituição.

note: type: textblock
en: This mode is discouraged.
pt: Este modo está desencorajado.

note: type: textblock
en: The compat 11 is discouraged for new packages as it suffers from feature interaction between L<dh_installinit> and L<dh_installsystemd> causing services to not run correctly in some cases.  Please consider using compatibility mode 10 or 12 instead.  More details about the issue are available in Debian#887904 and L<https://lists.debian.org/debian-release/2019/04/msg01442.html>.
pt: A compatibilidade 11 é desencorajada para novos pacotes pois sofre de interação de características entre L<dh_installinit> e L<dh_installsystemd> o que causa com que os serviços não funcionem correctamente em alguns casos. Por favor considere usar modo de  compatibilidade 10 ou 12 em vez deste. Mais detalhes sobre este problema estão disponíveis em Debian#887904 e L<https://lists.debian.org/debian-release/2019/04/msg01442.html>.

note: type: textblock
en: Changes from v10 are:
pt: As alterações a partir de v10 são:

note: type: textblock
en: B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor generates maintainer scripts for those files.  Please use the new B<dh_installsystemd> helper.
pt: B<dh_installinit> já não instala ficheiros F<service> ou F<tmpfile>, nem gera scripts do maintainer para esses ficheiros, Por favor use o novo ajudante B<dh_installsystemd>

note: type: textblock
en: The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced by the new B<dh_installsystemd> helper.  For the same reason, the B<systemd> sequence for B<dh> has also been removed.  If you need to disable the B<dh_installsystemd> helper tool, please use an empty override target.
pt: Os ajudantes B<dh_systemd_enable>e B<dh_systemd_start> foram substituídos pelo novo ajudante B<dh_installsystemd>. Pela mesma razão, a sequência do B<systemd> para B<dh> foi também removida. Se você precisar de desactivar a ferramenta de ajuda B<dh_installsystemd>, por favor use um alvo de sobreposição vazio.

note: type: textblock
en: Please note that the B<dh_installsystemd> tool has a slightly different behaviour in some cases (e.g. when using the B<--name> parameter).
pt: Por favor note que a ferramenta B<dh_installsystemd> tem um comportamento ligeiramente diferente em alguns casos (ex. quando se usa o parâmetro B<--name>).

note: type: textblock
en: B<dh_installdirs> no longer creates debian/I<package> directories unless explicitly requested (or it has to create a subdirectory in it).
pt: B<dh_installdirs> já não cria directórios debian/I<pacote> a menos que tal seja explicitamente pedido (ou se tiver de criar um sub-directório nele).

note: type: textblock
en: The vast majority of all packages will be unaffected by this change.
pt: A grande maioria dos pacotes não serão afectados por esta alteração.

note: type: textblock
en: The B<makefile> buildsystem now passes B<INSTALL="install --strip-program=true"> to L<make(1)>.  Derivative buildsystems (e.g. B<configure> or B<cmake>) are unaffected by this change.
pt: O sistema de compilação B<makefile> agora passa B<INSTALL="install --strip-program=true"> para o L<make(1)>. Sistemas de compilação derivativos (ex. B<configure> ou B<cmake>) não são afectados por esta alteração.

note: type: textblock
en: The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./configure>.
pt: O sistema de compilação B<autoconf> agora passa B<--runstatedir=/run> para F<./configure>.

note: type: textblock
en: The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to L<cmake(1)>.
pt: O sistema de compilação B<cmake> agora passa B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> para L<cmake(1)>.

note: type: textblock
en: B<dh_installman> will now prefer detecting the language from the path name rather than the extension.
pt: B<dh_installman> irá agora preferir detectar a linguagem a partir do nome de caminho em vez de a extensão.

note: type: textblock
en: B<dh_auto_install> will now only create the destination directory it needs.  Previously, it would create the package build directory for all packages.  This will not affect packages that only build with debhelper commands, but it may expose bugs in commands not included in debhelper.
pt: B<dh_auto_install> irá agora apenas criar o directório de destino que precisa. Anteriormente, iria criar o directório de compilação de pacote para todos os pacotes. Isto não vai afectar pacotes que apenas compilam com comandos debhelper, mas pode expor bugs em comandos não incluídos no debhelper.

note: type: textblock
en: The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and B<dh_installman> now error out if their config has a pattern that does not match anything or reference a path that does not exist.
pt: Os ajudantes B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, e B<dh_installman> agora dão erro se a sua configuração tiver um padrão que não coincida com nada ou faça referência a um caminho que não exista.

note: type: textblock
en: Known exceptions include building with the B<nodoc> profile, where the above tools will silently permit failed matches where the patterns are used to specify documentation.
pt: Excepções conhecidas incluem compilar com o perfil B<nodoc>, onde as ferramentas de cima irão permitir em silêncio correspondências falhadas onde os padrões são usados para especificar documentação.

note: type: textblock
en: The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and B<dh_installman> now accept the parameter B<--sourcedir> with same meaning as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like B<dh_install>.
pt: Os ajudantes B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, e B<dh_installman> agora aceitam o parâmetro B<--sourcedir> com o mesmo significado que B<dh_install>. Mais ainda, eles agora também retornam (em fall back) a F<debian/tmp> como B<dh_install>.

note: type: textblock
en: Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> incorrectly ignore B<--sourcedir>.
pt: Nota de migração: Um bug no debhelper 11 até ao 11.1.5 faz com que B<dh_installinfo> ignore incorrectamente B<--sourcedir>.

note: type: textblock
en: The B<perl-makemaker> and B<perl-build> build systems no longer pass B<-I.> to perl.  Packages that still need this behaviour can emulate it by using the B<PERL5LIB> environment variable.  E.g. by adding B<export PERL5LIB=.> in their debian/rules file (or similar).
pt: Os sistemas de compilação B<perl-makemaker> e B<perl-build> já não passam B<-I.> ao perl. Os pacotes que ainda precisam deste comportamento podem emula-lo ao usar a variável de ambiente B<PERL5LIB>. Ex. ao adicionar B<export PERL5LIB=.> no seu ficheiro debian/rules (ou semelhante).

note: type: textblock
en: The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or any of the B<dh_auto_*> tools.  It was added as a temporary work around to avoid a lot of packages failing to build at the same time.
pt: A variável de ambiente B<PERL_USE_UNSAFE_INC> já não é definida pelo B<dh> ou nenhuma das ferramentas B<dh_auto_*>. Ela foi adicionada como um meio de contorno temporário evitar muitos pacotes a falharem a compilação ao mesmo tempo.

note: type: textblock
en: Note this item will eventually become obsolete as upstream intends to drop support for the B<PERL_USE_UNSAFE_INC> environment variable.  When perl drops support for it, then this variable will be removed retroactively from existing compat levels as well.
pt: Note que este item irá eventualmente tornar-se obsoleto pois o auto pretende abandonar o suporte para a variável de ambiente B<PERL_USE_UNSAFE_INC>. Quando o perl abandonar o para ala, então esta variável será também removida retroactivamente dos níveis de compatibilidade existentes.

note: type: textblock
en: The B<dh_makeshlibs> helper will now exit with an error if objdump returns a non-zero exit from analysing a given file.
pt: O ajudante B<dh_makeshlibs> irá agora terminar em erro se objdump retornar uma saída não-zero a partir da análise de um determinado ficheiro.

note: type: textblock
en: The B<dh_installdocs> and B<dh_installexamples> tools may now install I<most> of the documentation in a different path to comply with the recommendation from Debian policy §12.3 (since version 3.9.7).
pt: As ferramentas B<dh_installdocs> e B<dh_installexamples> podem agora instalar I<a maioria> da documentação num caminho diferente para cumprir com a recomendação da política Debian §12.3 (desde versão 3.9.7).

note: type: textblock
en: Note that if a given source package only contains a single binary package in F<debian/control> or none of the packages are I<-doc> packages, then this change is not relevant for that source package and you can skip to the next change.
pt: Note que um dado pacote fonte apenas contém um único pacote binário em F<debian/control> ou nenhum dos pacotes são pacotes I<-doc>, então esta alteração não é relevante para esse pacote fonte e você pode saltar a próxima alteração.

note: type: textblock
en: By default, these tools will now attempt to determine a "main package for the documentation" (called a I<doc-main-package> from here on) for every I<-doc> package.  If they find such a I<doc-main-package>, they will now install the documentation into the path F<< /usr/share/doc/I<doc-main-package> >> in the given doc package.  I.e. the path can change but the documentation is still shipped in the I<-doc> package.
pt: Por predefinição, estas ferramentas irão agora tentar determinar um "pacote principal para a documentação" (chamado um I<doc-main-package> daqui em diante) para cada pacote I<-doc>. Se  encontrarem o tal I<doc-main-package>, irão agora instalar a documentação em F<< /usr/share/doc/I<doc-main-package> >> no pacote doc fornecido. Isto é, o caminho pode mudar mas a documentação será na mesma enviada no pacote I<-doc>.

note: type: textblock
en: The B<--doc-main-package> option can be used when the auto-detection is insufficient or to reset the path to its previous value if there is a reason to diverge from Debian policy recommendation.
pt: A opção B<--doc-main-package> pode ser usada quando a auto-detecção é insuficiente ou para reiniciar o caminho para o seu valor anterior se existir razão para divergir da recomendação da política Debian.

note: type: textblock
en: Some documentation will not be affected by this change.  These exceptions include the copyright file, changelog files, README.Debian, etc.  These files will still be installed in the path F<< /usr/share/doc/I<package> >>.
pt: Alguma documentação não será afectada por esta alteração. Estas excepções incluem o ficheiro copyright, ficheiros changelog, README.Debian, etc. Estes ficheiros serão na mesma instalados no caminho F<< /usr/share/doc/I<pacote> >>.

note: type: textblock
en: The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns to determine which files to process.  Instead, they open the file and look for an ELF header to determine if a given file is an shared object or an ELF executable.
pt: As ferramentas B<dh_strip> e B<dh_shlibdeps> já não usam mais padrões de nomes de ficheiros para determinar quais ficheiros processar. Em vez disso, elas abrem o ficheiro e procuram um cabeçalho ELF para determinar se um dado ficheiro é um objecto partilhado ou um executável ELF.

note: type: textblock
en: This change may cause the tools to process more files than previously.
pt: Esta alteração fazer com que as ferramentas processem mais ficheiros que anteriormente.

note: type: textblock
en: Changes from v9 are:
pt: As alterações a partir de v9 são:

note: type: textblock
en: B<dh_installinit> will no longer installs a file named debian/I<package> as an init script.
pt: B<dh_installinit> não irá mais instalar um ficheiro chamado debian/I<pacote> como um script de iniciação (init).

note: type: textblock
en: B<dh_installdocs> will error out if it detects links created with --link-doc between packages of architecture "all" and non-"all" as it breaks binNMUs.
pt: O B<dh_installdocs> irá dar erro se detectar links criados com --link-doc entre pacotes de arquitectura "all" e não-"all" porque isso faz quebrar binNMUs.

note: type: textblock
en: B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>.shlibs file.  This is now done by B<dh_makeshlibs> instead.
pt: O B<dh_installdeb> já não instala um ficheiro debian/I<pacote>.shlibs disponibilizado pelo maintainer. Em vez disso, isto agora é feito pelo B<dh_makeshlibs>.

note: type: textblock
en: B<dh_installwm> refuses to create a broken package if no man page can be found (required to register for the x-window-manager alternative).
pt: O B<dh_installwm> recusa-se a criar um pacote quebrado se não encontrar nenhuma página de manual (necessário para registo para a alternativa do x-window-manager).

note: type: textblock
en: Debhelper will default to B<--parallel> for all buildsystems that support parallel building.  This can be disabled by using either B<--no-parallel> or passing B<--max-parallel> with a value of 1.
pt: Debhelper irá predefinir para B<--parallel> em todos os sistemas de compilação que suportam compilação paralela. Isto pode ser desactivado usando B<--no-parallel> ou passando B<--max-parallel> com o valor de 1.

note: type: textblock
en: The B<dh> command will not accept any of the deprecated "manual sequence control" parameters (B<--before>, B<--after>, etc.).  Please use override targets instead.
pt: O comando B<dh> não irá aceitar nenhum dos parâmetros de "controle de sequência manua" descontinuados (B<--before>, B<--after>, etc.). Por favor utilize alvos de sobreposição em vez destes.

note: type: textblock
en: B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts any of these since debhelper/12.4.
pt: B<Retroactively applied to earlier compat levels>: B<dh> já não aceita nenhum destes desde o debhelper/12.4.

note: type: textblock
en: The B<dh> command will no longer use log files to track which commands have been run.  The B<dh> command I<still> keeps track of whether it already ran the "build" sequence and skip it if it did.
pt: O comando B<dh> não irá mais usar ficheiros log para seguir quais comandos foram executados. O comando B<dh> I<ainda> mantêm o seguimento se já correu a sequência de "compilação" e salta-a se já o fez.

note: type: textblock
en: The main effects of this are:
pt: Os principais efeitos disto são:

note: type: textblock
en: With this, it is now easier to debug the I<install> or/and I<binary> sequences because they can now trivially be re-run (without having to do a full "clean and rebuild" cycle)
pt: Com isto, é agora mais fácil de depurar as sequências I<install> ou/e I<binary> porque agora podem ser trivialmente re-executadas (sem ter que fazer um ciclo de "limpar e recompilar" completo.

note: type: textblock
en: The main caveat is that B<dh_*> now only keeps track of what happened in a single override target.  When all the calls to a given B<dh_cmd> command happens in the same override target everything will work as before.
pt: O principal embargo é que B<dh_*> agora apenas mantêm acompanhamento do que aconteceu num alvo de sobreposição singular. Quanto todas as chamadas a um dado comando B<dh_cmd> acontecem no mesmo alvo de sobreposição tudo irá funcionar como dantes.

note: type: textblock
en: Example of where it can go wrong:
pt: Exemplo de onde pode falhar:

note: type: textblock
en: In this case, the call to B<dh_foo --remaining> will I<also> include I<my-pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target.  This issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc.
pt: Neste caso, a chamada a B<dh_foo --remaining> irá I<também> incluir I<my-pkg>, desde que B<dh_foo -pmy-pkg> tenha corrido num alvo de sobreposição separado. Este problema não está imitado a B<--remaining>, mas também inclui B<-a>, B<-i>, etc.

note: type: textblock
en: The B<dh_installdeb> command now shell-escapes the lines in the F<maintscript> config file.  This was the original intent but it did not work properly and packages have begun to rely on the incomplete shell escaping (e.g. quoting file names).
pt: O comando B<dh_installdeb> agora faz "escape de shell" às linhas no ficheiro de configuração de F<maintscript>. Esta foi a intenção original mas não trabalhava correctamente e os pacotes começaram a confiar no "escapar de shell" incompleto (ex. ao mencionar nomes de ficheiros).

note: type: textblock
en: The B<dh_installinit> command now defaults to B<--restart-after-upgrade>.  For packages needing the previous behaviour, please use B<--no-restart-after-upgrade>.
pt: O comando B<dh_installinit> agora usa por predefinição B<--restart-after-upgrade>. Para pacotes que precisam do comportamento anterior, por favor use B<--no-restart-after-upgrade>.

note: type: textblock
en: The B<autoreconf> sequence is now enabled by default.  Please pass B<--without autoreconf> to B<dh> if this is not desirable for a given package
pt: A sequência B<autoreconf> é agora activada por predefinição. Por favor passe B<--without autoreconf> ao B<dh> se isto não for desejável para um determinado pacote

note: type: textblock
en: The B<systemd> sequence is now enabled by default.  Please pass B<--without systemd> to B<dh> if this is not desirable for a given package.
pt: A sequência B<systemd> é agora activada por predefinição. Por favor passe B<--without systemd> ao B<dh> se isto não for desejável para um determinado pacote.

note: type: textblock
en: B<Retroactively removed>: B<dh> no longer creates the package build directory when skipping running debhelper commands. This will not affect packages that only build with debhelper commands, but it may expose bugs in commands not included in debhelper.
pt: B<Retroactively removed> B<dh> já não cria o directório de compilação do pacote quando salta a execução de comandos debhelper. Isto não vai afectar pacotes que apenas compilam com comandos debhelper, mas pode expor bugs em comandos não incluídos no debhelper.

note: type: textblock
en: This compatibility feature had a bug since its inception in debhelper/9.20130516 that made it fail to apply in compat 9 and earlier.  As there has been no reports of issues caused by this bug in those ~5 years, this item have been removed rather than fixed.
pt: Esta funcionalidade de compatibilidade tinha um bug desde a sua inserção no debhelper/9.20130516 que o fazia falhar ao aplicar em compatibilidade 9 e anteriores. Como não tem havido relatórios de problemas causados por este bug nesses -5 anos, este item foi removido em vez de corrigido.

note: type: textblock
en: Changes from v8 are:
pt: As alterações a partir de v8 são:

note: type: textblock
en: Multiarch support. In particular, B<dh_auto_configure> passes multiarch directories to autoconf in --libdir and --libexecdir.
pt: Suporte a multi-arquitectura. Em particular, B<dh_auto_configure> passa directórios de multi-arquitectura ao autoconf em --libdir e --libexecdir.

note: type: textblock
en: dh is aware of the usual dependencies between targets in debian/rules.  So, "dh binary" will run any build, build-arch, build-indep, install, etc targets that exist in the rules file. There's no need to define an explicit binary target with explicit dependencies on the other targets.
pt: O dh tem conhecimento das dependências habituais entre alvos em debian/rules. Por isso, o "dh binary" irá correr quaisquer alvos de build, build-arch, build-indep, install, etc que existam no ficheiro de regras. Não há necessidade de definir um alvo binário explícito com dependências explícitas em outros alvos.

note: type: textblock
en: B<dh_strip> compresses debugging symbol files to reduce the installed size of -dbg packages.
pt: B<dh_strip> comprime ficheiros de símbolos de depuração para reduzir o tamanho instalado dos pacotes -dbg.

note: type: textblock
en: B<dh_auto_configure> does not include the source package name in --libexecdir when using autoconf.
pt: B<dh_auto_configure> não inclui o nome do pacote fonte em --libexecdir quando usa autoconf.

note: type: textblock
en: B<dh> does not default to enabling --with=python-support
pt: B<dh> não tem por predefinição a activação de --with=python-support

note: type: textblock
en: (Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch.  Since debhelper/10.3, B<dh> no longer enables this sequence add-on regardless of compat level)
pt: (Obsoleto: Pois a ferramenta B<dh_pysupport> foi removida a partir de Debian stretch. Desde o debhelper/10.3, B<dh> já não se activa esta sequência add-on independentemente do nível de compatibilidade)

note: type: textblock
en: All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment variables listed by B<dpkg-buildflags>, unless they are already set.
pt: Todos os programas debhelper B<dh_auto_>I<*> e B<dh> definem variáveis de ambiente listadas por B<dpkg-buildflags>, a menos que elas estejam já definidas.

note: type: textblock
en: B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS to perl F<Makefile.PL> and F<Build.PL>
pt: B<dh_auto_configure> passa as B<dpkg-buildflags> CFLAGS, CPPFLAGS, e LDFLAGS para F<Makefile.PL> e F<Build.PL> de perl.

note: type: textblock
en: B<dh_strip> puts separated debug symbols in a location based on their build-id.
pt: B<dh_strip> põe símbolos de depuração separados numa localização baseada no seu build-id.

note: type: textblock
en: Executable debhelper config files are run and their output used as the configuration.
pt: Os ficheiros de configuração executáveis do debhelper são corridos e os seus resultados usados como configuração.

note: type: textblock
en: This mode is deprecated.
pt: Este modo está descontinuado.

note: type: textblock
en: Changes from v7 are:
pt: As alterações a partir de v7 são:

note: type: textblock
en: Commands will fail rather than warning when they are passed unknown options.
pt: Os comandos irão falhar em vez de emitirem avisos quando lhes são passadas opções desconhecidas.

note: type: textblock
en: B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it generates shlibs files for. So B<-X> can be used to exclude libraries.  Also, libraries in unusual locations that B<dpkg-gensymbols> would not have processed before will be passed to it, a behavior change that can cause some packages to fail to build.
pt: B<dh_makeshlibs> irá correr B<dpkg-gensymbols> em todas as bibliotecas partilhadas para as quais gera ficheiros shlibs. Portanto o B<-X> pode ser usado para excluir bibliotecas. Também, as bibliotecas em localizações fora do habitual que o B<dpkg-gensymbols> não tenha processado antes serão passadas para ele, uma alteração no comportamento que pode causar que alguns pacotes falhem a compilar.

note: type: textblock
en: B<dh> requires the sequence to run be specified as the first parameter, and any switches come after it. Ie, use "B<dh $@ --foo>", not "B<dh --foo $@>".
pt: B<dh> requer que a sequência a correr seja especificada como o primeiro parâmetro, e quaisquer switches que venham depois dela. Isto é, use B<dh $@ --foo>", e não "B<dh --foo $@>

note: type: textblock
en: B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to F<Makefile.PL>.
pt: B<dh_auto_>I<*> prefere usar o B<Module::Build> do Perl em preferência de F<Makefile.PL>.

note: type: textblock
en: This is the lowest supported compatibility level.
pt: Este é o nível de compatibilidade mais baixo suportado.

note: type: textblock
en: If you are upgrading from an earlier compatibility level, please review L<debhelper-obsolete-compat(7)>.
pt: Se você está a actualizar a partir de um nível de compatibilidade anterior, por favor reveja L<debhelper-obsolete-compat(7)>.

note: type: textblock
en: Upgrading from a (now) obsolete compatibility level? This document covers the upgrade checklist up to the earliest supported level.
pt: A actualizar a partir de um nível de compatibilidade (agora) obsoleto? Este documento a lista de verificação de actualização até ao nível suportado mais recente.

note: type: textblock
en: General information about the debhelper framework. This document also covers how to declare your chosen debhelper compat level.
pt: Informação geral acerca da estrutura do debhelper. Este documento também cobre como declarar o seu nível de compatibilidade debhelper escolhido.

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

note: type: textblock
en: debhelper-obsolete-compat - List of no longer supported compat levels
pt: debhelper-obsolete-compat - Lista dos níveis de compatibilidade não mais suportados

note: type: textblock
en: This document contains the upgrade guidelines from all compat levels which are no longer supported.  Accordingly it is mostly for historical purposes and to assist people upgrading from a non-supported compat level to a supported level.
pt: Este documento contém o guião de actualização a partir de todos os níveis de compatibilidade que já não são suportados. Consequentemente é principalmente para objectivos históricos e para ajudar pessoas a actualizarem a partir de um nível de compatibilidade não suportado para um nível suportado.

note: type: textblock
en: For upgrades from supported compat levels, please see L<debhelper(7)>.
pt: Para actualizações a partir de níveis de compatibilidade suportados, por favor veja L<debhelper(7)>.

note: type: =head1
en: UPGRADE LIST FOR COMPAT LEVELS
pt: ACTUALIZAÇÃO DE LISTA PARA NÍVEIS DE COMPATIBILIDADE

note: type: textblock
en: The following is the list of now obsolete compat levels and their changes.
pt: O seguinte é a lista dos níveis de compatibilidade agora obsoletos e as suas alterações.

note: type: textblock
en: Changes from v6 are:
pt: As alterações a partir de v6 são:

note: type: textblock
en: B<dh_install>, will fall back to looking for files in F<debian/tmp> if it doesn't find them in the current directory (or wherever you tell it look using B<--sourcedir>). This allows B<dh_install> to interoperate with B<dh_auto_install>, which installs to F<debian/tmp>, without needing any special parameters.
pt: B<dh_install>, irá regressar a procurar por ficheiros em F<debian/tmp> se não os encontrar no directório actual (ou onde você lhe disser para procurar usando B<--sourcedir>). Isto permite ao B<dh_install> inter-operar com o B<dh_auto_install>, o qual instala para F<debian/tmp>, sem precisar de nenhuns parâmetros especiais.

note: type: textblock
en: B<dh_clean> will read F<debian/clean> and delete files listed there.
pt: B<dh_clean> irá ler F<debian/clean> e apagar os ficheiros listados lá.

note: type: textblock
en: B<dh_clean> will delete toplevel F<*-stamp> files.
pt: B<dh_clean> irá apagar ficheiros F<*-stamp> do nível de topo.

note: type: textblock
en: B<dh_installchangelogs> will guess at what file is the upstream changelog if none is specified.
pt: B<dh_installchangelogs> irá adivinhar qual ficheiro está no relatório de alterações da origem se nenhum for especificado.

note: type: textblock
en: Changes from v5 are:
pt: As alterações a partir de v5 são:

note: type: textblock
en: Commands that generate maintainer script fragments will order the fragments in reverse order for the F<prerm> and F<postrm> scripts.
pt: Os comandos que geram fragmentos de script de maintainer irão ordenar os fragmentos em ordem reversa para os scripts F<prerm> e F<postrm>.

note: type: textblock
en: B<dh_installwm> will install a slave manpage link for F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> in the package build directory.
pt: B<dh_installwm> irá instalar uma ligação escrava de manual para F<x-window-manager.1.gz>, se vir o manual em F<usr/share/man/man1> no directório de compilação do pacote.

note: type: textblock
en: B<dh_builddeb> did not previously delete everything matching B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as B<CVS:.svn:.git>. Now it does.
pt: O B<dh_builddeb> anteriormente não apagava nada que correspondesse a B<DH_ALWAYS_EXCLUDE>, se estivesse definida uma lista de coisas  a excluir, como B<CVS:.svn:.git>. Mas agora fá-lo.

note: type: textblock
en: B<dh_installman> allows overwriting existing man pages in the package build directory. In previous compatibility levels it silently refuses to do this.
pt: B<dh_installman> permite a sobreposição de manuais existentes no directório de compilação do pacote. Nos níveis de compatibilidade anteriores recusava-se em silêncio a fazer isto.

note: type: textblock
en: Changes from v4 are:
pt: As alterações a partir de v4 são:

note: type: textblock
en: Comments are ignored in debhelper config files.
pt: Comentários são ignorados nos ficheiros de configuração do debhelper.

note: type: textblock
en: B<dh_strip --dbg-package> now specifies the name of a package to put debugging symbols in, not the packages to take the symbols from.
pt: Agora B<dh_strip --dbg-package> especifica o nome de um pacote onde colocar símbolos de depuração, e não os pacotes de onde tirar os símbolos.

note: type: textblock
en: B<dh_installdocs> skips installing empty files.
pt: B<dh_installdocs> evita a instalação de ficheiros vazios.

note: type: textblock
en: B<dh_install> errors out if wildcards expand to nothing.
pt: B<dh_install> resulta em erro se as "wildcards" expandirem para nada.

note: type: textblock
en: Changes from v3 are:
pt: As alterações a partir de v3 são:

note: type: textblock
en: B<dh_makeshlibs -V> will not include the Debian part of the version number in the generated dependency line in the shlibs file.
pt: B<dh_makeshlibs -V> não irá incluir a parte Debian do número de versão na linha de dependência gerada no ficheiro shlibs.

note: type: textblock
en: You are encouraged to put the new B<${misc:Depends}> into F<debian/control> to supplement the B<${shlibs:Depends}> field.
pt: Você é encorajado a colocar o novo B<${misc:Depends}> em F<debian/control> para suplementar o campo B<${shlibs:Depends}>.

note: type: textblock
en: B<dh_fixperms> will make all files in F<bin/> directories and in F<etc/init.d> executable.
pt: B<dh_fixperms> irá tornar em executáveis todos os ficheiros nos directórios F<bin/> e em F<etc/init.d>.

note: type: textblock
en: B<dh_link> will correct existing links to conform with policy.
pt: B<dh_link> irá corrigir os links existentes para ficarem em conformidade com a política.

note: type: textblock
en: This mode works like v2, with the following additions:
pt: Este modo funciona como v2, com as seguintes adições:

note: type: textblock
en: Debhelper config files support globbing via B<*> and B<?>, when appropriate. To turn this off and use those characters raw, just prefix with a backslash.
pt: Os ficheiros de configuração do debhelper suportam englobamentos via B<*> e B<?>, onde apropriado. Para desligar isto e usar esses caracteres a cru, basta antecede-los com uma barra invertida (backslash "").

note: type: textblock
en: B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call B<ldconfig>.
pt: B<dh_makeshlibs> faz com que os scripts F<postinst> e F<postrm> chamem B<ldconfig>.

note: type: textblock
en: Every file in F<etc/> is automatically flagged as a conffile by B<dh_installdeb>.
pt: Qualquer ficheiro em F<etc/> é marcado automaticamente como um conffile (ficheiro de configuração) pelo B<dh_installdeb>.

note: type: textblock
en: In this mode, debhelper will consistently use debian/I<package> as the package tree directory for every package that is built.
pt: Neste modo, o debhelper irá consistentemente usar debian/I<pacote> como o directório da árvore do pacote para cada pacote que é compilado.

note: type: textblock
en: This is the original debhelper compatibility level, and so it is the default one. In this mode, debhelper will use F<debian/tmp> as the package tree directory for the first binary package listed in the control file, while using debian/I<package> for all other packages listed in the F<control> file.
pt: Este é o nível de compatibilidade original do debhelper, e por isso é o predefinido. Neste modo, o debhelper irá usar F<debian/tmp> como o directório da árvore do pacote para o primeiro pacote binário listado no ficheiro de controle, enquanto usa debian/I<pacote> para todos os outros pacotes listados no ficheiro F<control>.

note: type: textblock
en: dh - debhelper command sequencer
pt: dh - sequenciador de comandos do debhelper

note: type: textblock
en: B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] [S<I<debhelper options>>]
pt: B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] [S<I<debhelper opções>>]

note: type: textblock
en: B<dh> runs a sequence of debhelper commands. The supported I<sequence>s correspond to the targets of a F<debian/rules> file: B<build-arch>, B<build-indep>, B<build>, B<clean>, B<install-indep>, B<install-arch>, B<install>, B<binary-arch>, B<binary-indep>, and B<binary>.
pt: B<dh> corre uma sequência de comandos do debhelper. As I<sequência>s suportadas correspondem aos alvos de um ficheiro F<debian/rules>: B<build-arch>, B<build-indep>, B<build>, B<clean>, B<install-indep>, B<install-arch>, B<install>, B<binary-arch>, B<binary-indep>, e B<binary>.

note: type: =head1
en: OVERRIDE AND HOOK TARGETS
pt: ALVOS DE SOBREPOSIÇÃO E HOOK

note: type: textblock
en: A F<debian/rules> file using B<dh> can override the command that is run at any step in a sequence, by defining an override target.  It is also possible to inject a command before or after any step without affecting the step itself.
pt: Um ficheiro F<debian/rules> que use B<dh> pode sobrepor o comando que é executado em qualquer passo numa sequência, ao se definir um alvo de sobreposição. É também possível injectar um comando antes ou depois de qualquer passo sem afectar o próprio passo.

note: type: =head2
en: Injecting commands before or after a step
pt: Injectando comandos antes e depois de um passo

note: type: textblock
en: I<Note>: This feature requires debhelper 12.8 or later plus the package must use compatibility mode 10 or later.
pt: I<Nota>: Esta funcionalidade requer debhelper 12.8 ou posterior e o pacote tem de usar modo de compatibilidade 10 ou posterior.

note: type: textblock
en: To inject commands before I<dh_command>, add a target named B<execute_before_>I<dh_command> to the rules files.  Similarly, if you want to inject commands after I<dh_command>, add the target B<execute_after_>I<dh_command>.  Both targets can be used for the same I<dh_command> and also even if the command is overridden (as described in L</Overriding a command> below).
pt: Para injectar comandos antes de I<dh_command>, adicione um alvo chamado B<execute_before_>I<dh_command> aos ficheiros rules. De modo semelhante, se precisar de injectar comandos após I<dh_command>, adicione o alvo B<execute_after_>I<dh_command>. Ambos alvos podem ser usados para o mesmo I<dh_command> e também mesmo que o comando seja sobreposto (como descrito em L</Sobrepor um comando> em baixo).

note: type: textblock
en: When these targets are defined, B<dh> will call the targets respectively before or after it would invoke I<dh_command> (or its override target).
pt: Quando estes alvos estão definidos, B<dh> irá chamar os alvos respetivamente antes ou depois de quando iria invocar I<dh_command> (ou os seus alvos de sobreposição).

note: type: =head2
en: Overriding a command
pt: Sobrepor um comando

note: type: textblock
en: To override I<dh_command>, add a target named B<override_>I<dh_command> to the rules file. When it would normally run I<dh_command>, B<dh> will instead call that target. The override target can then run the command with additional options, or run entirely different commands instead. See examples below.
pt: Para sobrepor o I<dh_command>, adicione um alvo chamado B<override_>I<dh_command> ao ficheiro de regras. Em vez de correr normalmente I<dh_command>, o B<dh> irá chamar esse alvo. O alvo de sobreposição pode depois correr o comando com opções adicionais, ou em vez disso correr comandos completamente diferentes. Veja exemplos em baixo.

note: type: =head2
en: Architecture dependent/independent override and hook targets
pt: Alvos de sobreposição e hook dependentes/independentes da arquitectura

note: type: textblock
en: The override and hook targets can also be defined to run only when building architecture dependent or architecture independent packages. Use targets with names like B<override_>I<dh_command>B<-arch> and B<execute_after_>I<dh_command>B<-indep>.
pt: Os alvos de sobreposição e hook também podem ser definidos para correr apenas quando se compila pacotes dependentes ou independentes da arquitectura. Use alvos com nomes como B<override_>I<dh_command>B<-arch> e B<execute_after_>I<dh_command>B<-indep>.

note: type: textblock
en: This feature is available since debhelper 8.9.7 (for override targets)  and 12.8 (for hook targets).
pt: Esta funcionalidade está disponível desde debhelper 8.9.7 (para alvos de sobreposição) e 12.8 (para alvos hook).

note: type: =head2
en: Completely empty targets
pt: Alvos completamente vazios

note: type: textblock
en: As a special optimization, B<dh> will skip a target if it is completely empty and does not depend on any other target.  This is mostly useful for override targets, where the command will simply be skipped without the overhead of invoking a dummy target.
pt: Como uma optimização especial, B<dh> irá saltar um alvo se este estiver completamente vazio e não depender de nenhum outro alvo. Isto é muito útil para alvos de sobreposição, onde o comando irá simplesmente ser saltado sem a sobrecarga de invocar um alvo fantoche.

note: type: textblock
en: Note that the target has to be completely empty for this to work:
pt: Note que o alvo tem de estar completamente vazio para isto funcionar:

note: type: =head2
en: Verifying targets are picked up by dh
pt: Verificando se os alvos são apanhados pelo dh

note: type: textblock
en: As of debhelper 13.10, you can use L<dh_assistant(1)> to see which override and hook targets will be seen by B<dh>.  Here is an example run of L<dh_assistant(1)> along with its output:
pt: A partir do debhelper 13.10, você pode usar L<dh_assistant(1)> para ver quais alvos de sobreposição e hook irão ser vistos pelo B<dh>.  Aqui está um exemplo de execução do L<dh_assistant(1)> juntamente com os seus resultados:

note: type: textblock
en: The B<commands-not-in-path> is useful for spotting mistakes in the hook target names.  A non-empty value implies one of more hook targets are related to a command that is either not installed or no command with that name exists at all.  It is generally worth double checking these.
pt: O B<commands-not-in-path> é útil para detetar enganos nos nomes de alvo hook. Um valor não-vazio implica que um ou mais alvos hook estão relacionados com um comando que ou não está instalado ou não existe de todo um comando com esse nome. Geralmente é de valor verificar bem estes casos.

note: type: textblock
en: Additionally, the B<is-empty> attribute for each hook target can be used for seeing whether a hook target triggers the L</Completely empty targets> optimization.
pt: Adicionalmente, o atributo B<is-empty> para cada alvo hook pode ser usado para se ver se um alvo hook despoleta a optimização L</Completely empty targets>.

note: type: textblock
en: If you are interested in the other attributes, please read the L<dh_assistant(1)> for the details.
pt: Se você está interessado noutros atributos, por favor leia o L<dh_assistant(1)> para detalhes.

note: type: =head3
en: Verifying targets are picked up by dh (when debhelper is older than 13.10)
pt: Verificando se os alvos são apanhados pelo dh (quando o debhelper é mais antigo que 13.10)

note: type: textblock
en: On older versions of debhelper, you have to use B<dh> with B<--no-act>.  You can use the following command as an example:
pt: Em versões antigas do debhelper, você tem de usar B<dh> com B<--no-act>.  Você pode usar o seguinte comando como um exemplo:

note: type: textblock
en: The B<debian/rules execute_after_dh_install> in the output, which signals that B<dh> registered a B<execute_after_dh_install> target and would run it directly after L<dh_install(1)>.
pt: O B<debian/rules execute_after_dh_install> no resultado, que assinala que B<dh> registou um alvo B<execute_after_dh_install> e o iria correr directamente após L<dh_install(1)>.

note: type: textblock
en: Note that L</Completely empty targets> will be omitted in the listing above.  This makes it a bit harder to spot as you are looking for the omission of a command name.  But otherwise, the principle remains the same.
pt: Note que L</Alvos completamente vazios> irão ser omitidos na listagem em cima. Isto torna um pouco mais difícil detectar se você está a olhar para a omissão de um nome de comando. Mas caso contrário, o princípio continua o mesmo.

note: type: =head2
en: Caveats with hook targets and makefile conditionals
pt: Ressalvas com alvos hook e condicionais makefile

note: type: textblock
en: If you choose to wrap a hook target in makefile conditionals, please be aware that B<dh> computes all the hook targets a head of time and caches the result for that run.  Furthermore, the conditionals will be invoked again when B<dh> calls the hook target later and will assume the answer did not change.
pt: Se você escolher envolver um alvo hook em condicionais makefile, por favor tenha em mente que B<dh> computa todos os alvos hook em adiantado e guarda em cache o resultado para essa execução. Mais ainda, as condicionais serão invocadas novamente quando B<dh> chamar o alvo hook mais tarde e irá assumir que a resposta não mudou.

note: type: textblock
en: The parsing and caching I<often> happens before B<dh> knows whether it will build arch:any (-a) or/and arch:all (-i) packages, which can produce confusing results - especially when L<dh_listpackages(1)> is part of the conditional.
pt: A análise e cache ocorre I<muitas vezes> entes de B<dh> saber se vai compilar pacotes arch:any (-a) ou/e arch:all (-i), o que pode produzir resultados confusos - especialmente quando L<dh_listpackages(1)> é parte da condicional.

note: type: textblock
en: Most of the problems can be avoided by making the hook target unconditional and then have the "body" be partially or completely conditional.  As an example:
pt: A maioria dos problemas podem ser evitados ao tornar o alvo hook incondicional e depois ter o "corpo" a ser parcial ou completamente condicional. Com exemplo:

note: type: textblock
en: These recipes are also relevant for conditional dependency targets, which are often seen in a variant of the following example:
pt: Estas receitas são também relevantes para alvos de dependência condicional, os quais são muitas vezes vistos numa variante do seguinte exemplo:

note: type: textblock
en: When in doubt, pick the relevant B<SIMPLE> case in the examples above that match your need.
pt: Em caso de dúvida, escolha o caso B<SIMPLE> relevante nos exemplos em cima que corresponda à sua necessidade.

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

note: type: textblock
en: Add the debhelper commands specified by the given addon to appropriate places in the sequence of commands that is run. This option can be repeated more than once, or multiple addons can be listed, separated by commas.  This is used when there is a third-party package that provides debhelper commands. See the F<PROGRAMMING> file for documentation about the sequence addon interface.
pt: Adiciona os comandos debhelper especificados pelo addon indicado aos lugares apropriados na sequência de comandos que é executada. Esta opção pode ser repetida mais do que uma vez, ou pode-se listar múltiplos addons separados por vírgulas. Isto é usado quando existe um pacote de terceiros que disponibiliza comandos do debhelper. Veja o ficheiro F<PROGRAMMING> para documentação acerca da sequência de interface de addons.

note: type: textblock
en: A B<Build-Depends> relation on the package B<dh-sequence->I<addon> implies a B<--with> I<addon>. This avoids the need for an explicit B<--with> in F<debian/rules> that only duplicates what is already declared via the build dependencies in F<debian/control>.  The relation can (since 12.5) be made optional via e.g.  build-profiles.  This enables you to easily disable an addon that is only useful with certain profiles (e.g. to facilitate bootstrapping).
pt: Uma relação B<Build-Depends> no pacote B<dh-sequence->I<addon> implica um I<addon> B<--with>. Isto evita a necessidade de um B<--with> explícito em F<debian/rules> que apenas duplica o que já está declarado via dependências de compilação em F<debian/control>. A relação pode (desde 12.5) ser feita opcionalmente via por exemplo, build-profiles.  Isto permite-lhe facilmente desativar um addon que é apenas útil com certos perfis (ex. para facilitar bootstrapping).

note: type: textblock
en: Since debhelper 12.5, addons can also be activated in B<indep>-only mode (via B<Build-Depends-Indep>) or B<arch>-only mode (via B<Build-Depends-Arch>). Such addons are only active in the particular sequence (e.g. B<binary-indep>) which simplifies dependency management for cross-builds.
pt: Desde o debhelper 12.5, que addons podem ser também activados em modo B<indep>-only (via B<Build-Depends-Indep>) ou modo B<arch>-only (via B<Build-Depends-Arch>). Tais addons estão apenas activos na sequência particular (ex. B<binary-indep>) o qual simplifica a gestão de dependências para compilações cruzadas (cross-builds).

note: type: textblock
en: Please note that addons activated via B<Build-Depends-Indep> or B<Build-Depends-Arch> are subject to additional limitations to ensure the result is deterministic even when the addon is unavailable (e.g. during clean).  This implies that some addons are incompatible with these restrictions and can only be used via B<Build-Depends> (or manually via F<debian/rules>).  Currently, such addons can only add commands to sequences.
pt: Por favor note que os addons activados via B<Build-Depends-Indep> ou B<Build-Depends-Arch> estão sujeitos a limitações adicionais para assegurar que o resultado é determinista mesmo quando o addon está indisponível (ex. durante limpeza). Isto sugere que alguns addons são incompatíveis com essas restrições e só podem ser usadas via B<Build-Depends> (ou manualmente via F<debian/rules>). Actualmente, tais addons podem apenas adicionar comandos a sequências.

note: type: textblock
en: The inverse of B<--with>, disables using the given addon. This option can be repeated more than once, or multiple addons to disable can be listed, separated by commas.
pt: O inverso de B<--with>, desactiva a utilização do addon indicado. Esta opção pode ser repetida mais do que uma vez, ou pode desactivar vários addons se os listar separados por vírgulas.

note: type: textblock
en: List all available addons.
pt: Lista todos os addons disponíveis.

note: type: textblock
en: When called only with this option, B<dh> can be called from any directory (i.e. it does not need access to files from a source package).
pt: Quando chamado apenas com esta opção, o B<dh> pode ser chamado a partir de qualquer directório (isto é, não precisa de acesso a ficheiros de um pacote fonte).

note: type: textblock
en: Prints commands that would run for a given sequence, but does not run them.
pt: Escreve comandos que iriam correr para uma determinada sequência, mas não os corre.

note: type: textblock
en: Note that dh normally skips running commands that it knows will do nothing.  With --no-act, the full list of commands in a sequence is printed.
pt: Note que o dh normalmente evita correr comandos que sabe que não fazem nada. Com --no-act, é escrito em sequência a lista completa dos comandos.

note: type: textblock
en: Other options passed to B<dh> are passed on to each command it runs. This can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for more specialised options.
pt: Outras opções passadas a B<dh> são passadas a cada comando que ele corre. Isto pode ser usado para definir uma opção como B<-v> ou B<-X> ou B<-N>, assim como para opções mais especializadas.

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

note: type: textblock
en: To see what commands are included in a sequence, without actually doing anything:
pt: Para ver quais comandos estão incluídos numa sequência, sem realmente fazer nada:

note: type: textblock
en: This is a very simple rules file, for packages where the default sequences of commands work with no additional options.
pt: Este é um ficheiro de regras muito simples, para pacotes onde as sequências de comandos predefinidas funcionam sem opções adicionais.

note: type: textblock
en: Often you'll want to pass an option to a specific debhelper command. The easy way to do with is by adding an override target for that command.
pt: Muitas vezes você vai querer passar uma opção a um comando debhelper específico. A maneira mais fácil de o fazer é adicionar um alvo de sobreposição a esse comando.

note: type: textblock
en: Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> can't guess what to do for a strange package. Here's how to avoid running either and instead run your own commands.
pt: Por vezes os automatismos L<dh_auto_configure(1)> e L<dh_auto_build(1)> não conseguem adivinhar  que fazer com um pacote estranho. Aqui está como evitar correr outros comandos quaisquer e em vez disso correr os seus próprios comandos.

note: type: textblock
en: Another common case is wanting to do something manually before or after a particular debhelper command is run.
pt: Outro caso comum é esperar fazer algo manualmente antes ou depois de um comando debhelper particular ser executado.

note: type: textblock
en: If you are on an older debhelper or compatibility level, the above example would have to be written as.
pt: Se você está num debhelper ou nível de compatibilidade antigo, o exemplo de cima terá que ser escrito assim:

note: type: textblock
en: Python tools are not run by dh by default, due to the continual change in that area. Here is how to use B<dh_python2>.
pt: Por predefinição, as ferramentas Python não são acionadas, devido às alterações contínuas nessa área. Aqui está como usar o B<dh_python2>.

note: type: textblock
en: Here is how to force use of Perl's B<Module::Build> build system, which can be necessary if debhelper wrongly detects that the package uses MakeMaker.
pt: Aqui está como forçar o uso do sistema de compilação B<Module::Build> do Perl, o qual pode ser necessário e o debhelper erradamente detectar que o pacote usa MakeMaker.

note: type: textblock
en: Here is an example of overriding where the B<dh_auto_>I<*> commands find the package's source, for a package where the source is located in a subdirectory.
pt: Aqui está um exemplo de criar uma sobreposição ao local onde os comandos B<dh_auto_>I<*> encontram a fonte do pacote, para um pacote cuja fonte está localizada num sub-directório.

note: type: textblock
en: And here is an example of how to tell the B<dh_auto_>I<*> commands to build in a subdirectory, which will be removed on B<clean>.
pt: E aqui está um exemplo de como dizer aos comandos B<dh_auto_>I<*> para compilarem num sub-directório, o qual será removido em B<clean>.

note: type: textblock
en: If your package can be built in parallel, please either use compat 10 or pass B<--parallel> to dh. Then B<dpkg-buildpackage -j> will work.
pt: Se o seu pacote poder ser compilado em paralelo, por favor use compatibilidade 10 ou passe B<--parallel> ao dh. Assim o B<dpkg-buildpackage -j> irá funcionar.

note: type: textblock
en: If your package cannot be built reliably while using multiple threads, please pass B<--no-parallel> to dh (or the relevant B<dh_auto_>I<*> command):
pt: Se o seu pacote não pode ser compilado correctamente usando múltiplos processos, por favor passe B<--no-parallel> ao dh (ou ao comando B<dh_auto_>I<*> relevante):

note: type: textblock
en: Here is a way to prevent B<dh> from running several commands that you don't want it to run, by defining empty override targets for each command.
pt: Aqui está um modo de prevenir que o B<dh> corra vários comandos que você não quer que corram, ao definir alvos de sobreposição vazios para cada comando.

note: type: verbatim
en: 	# Commands not to run:
    	override_dh_auto_test override_dh_compress override_dh_fixperms:
pt: 	# Comandos a não correr:
    	override_dh_auto_test override_dh_compress override_dh_fixperms:

note: type: textblock
en: A long build process for a separate documentation package can be separated out using architecture independent overrides.  These will be skipped when running build-arch and binary-arch sequences.
pt: Pode-se separar um processo de compilação longo para um pacote de documentação separado usando sobreposições independentes da arquitectura. Estes serão saltados quando se corre as sequências build-arch e binary-arch.

note: type: verbatim
en: 	# No tests needed for docs
    	override_dh_auto_test-indep:
pt: 	# Nenhum teste necessário para documentação
    	override_dh_auto_test-indep:

note: type: textblock
en: Adding to the example above, suppose you need to chmod a file, but only when building the architecture dependent package, as it's not present when building only documentation.
pt: Adicionando ao exemplo em cima, suponha que precisa de fazer chmod a um ficheiro, mas apenas quando compila o pacote dependente da arquitectura, pois ele não está presente quando compila apenas a documentação.

note: type: =head1
en: DEBHELPER PROVIDED DH ADDONS
pt: ADDONS DH FORNECIDOS PELO DEBHELPER

note: type: textblock
en: The primary purpose of B<dh> addons is to provide easy integration with third-party provided features for debhelper.  However, debhelper itself also provide a few sequences that can be useful in some cases.  These are documented in this list:
pt: O objetivo principal dos addons do B<dh> é fornecer integração fácil com funcionalidades fornecidas por terceiros para o debhelper. No entanto, o próprio debhelper também fornece algumas sequências que podem ser úteis em alguns casos. Estas estão documentadas nesta lista:

note: type: textblock
en: A special addon for controlling whether B<dh> (in compat 10 or later)  will create stamp files to tell whether the build target has been run successfully. See L</INTERNALS> for more details.
pt: Um addon especial para controlar se B<dh> (em compatibilidade 10 ou posterior) irá criar ficheiros stamp para dizer se o alvo de compilação correu com sucesso. Veja L</INTERNOS> para mais detalhes.

note: type: textblock
en: This addon is active by default but can disabled by using B<dh $@ --without build-stamp>
pt: Este addon está activo por predefinição mas pode ser desactivado ao usar B<dh $@ --without build-stamp>

note: type: =item
en: dwz (obsolete)
pt: dwz (obsoleto)

note: type: textblock
en: Adds L<dh_dwz(1)> to the sequence in compat level 11 or below.  Obsolete in compat 12 or later.
pt: Adiciona L<dh_dwz(1)> à sequência em compatibilidade 11 ou inferior. Obsoleto compatibilidade 12 ou posterior.

note: type: textblock
en: This addon adds tools related to ELF files to the sequence such as L<dh_strip(1)> and L<dh_shlibdeps(1)>
pt: Este addon adiciona ferramentas relativas a ficheiros ELF à sequência tal como L<dh_strip(1)> e L<dh_shlibdeps(1)>

note: type: textblock
en: This addon is I<conditionally> active by default for architecture specific packages - that is, it is skipped for arch:all packages.  In the special case where you need these tools to work on arch:all packages, you can use B<--with elf-tools> to activate it unconditionally.
pt: Este addon está activo I<condicionalmente> por predefinição para pacotes específicos de arquitectura - isto é, é saltado para pacotes arch:all. Num caso especial que você precise destas ferramentas a funcionar em pacotes arch:all, você pode usar B<--with elf-tools> para o activar incondicionalmente.

note: type: =item
en: installinitramfs (obsolete)
pt: installinitramfs (obsoleto)

note: type: textblock
en: Adds L<dh_installinitramfs(1)> to the sequence in compat level 11 or below.  Obsolete in compat 12 or later.
pt: Adiciona L<dh_installinitramfs(1)> à sequência em compatibilidade 11 ou inferior. Obsoleto compatibilidade 12 ou posterior.

note: type: =item
en: root-sequence (internal)
pt: root-sequence (interno)

note: type: textblock
en: This is reserved for internal usage.
pt: Isto está reservado para uso interno.

note: type: textblock
en: A special-purpose addon that makes debhelper run in "single binary" mode.
pt: Um addon de objetivo-especial que faz o debhelper em modo "binário único".

note: type: textblock
en: When active, it will pass B<< --destdir=debian/I<package>/ >> to L<dh_auto_install(1)>.  This makes every file "installed" by the upstream build system part of the (only) binary package by default without having to use other helpers such as L<dh_install(1)>.
pt: Quando activo, irá passar B<< --destdir=debian/I<package>/ >> ao L<dh_auto_install(1)>. Isto faz com que todos os ficheiros "instalados" pelo sistema de compilação do autor façam parte do (único) pacote binário por predefinição sem ter que se usar outros ajudantes como o L<dh_install(1)>.

note: type: textblock
en: The addon will refuse to activate when the source package lists 2 or more binary packages in F<debian/control> as a precaution.
pt: Como precaução o addon irá recusar activar-se quando o pacote fonte listar 2 ou mais pacotes binários em F<debian/control>.

note: type: textblock
en: Before compat 15. this behaviour was the default when there was only a single binary package listed in F<debian/control>.  In compat 15 and later, this addon must explicitly be activated for this feature to work.
pt: Antes da compatibilidade 15, este comportamento era o predefinido quando havia apenas um único pacote binário listado em F<debian/control>. Em compatibilidade 15 e posterior, este addon tem de ser activado explicitamente para que esta funcionalidade funcione.

note: type: textblock
en: The rationale for requiring this as an explicit choice is that if it is implicit then debhelper will silently change behaviour on adding a new binary package.  This has caused many RC bugs when maintainers renamed a binary and added transitional packages with the intention of supporting seamless upgrades.  The result would often be two empty binary packages that were uploaded to archive with users frustrated as their "upgrade" removed their programs.
pt: A razão para se requerer isto como uma escolha explícita é que se fosse implícita então o debhelper iria mudar o comportamento em silêncio ao se adicionar um novo pacote binário. Isto causou muitos bugs RC quando os maintainers renomeavam um binário e adicionavam pacotes de transição com a intenção de suportar actualizações perfeitas. O resultado era muitas vezes dois pacotes binários vazios que eram enviados para o arquivo com os utilizadores frustrados pois a sua "actualização" removeu os seus programas.

note: type: =item
en: systemd (obsolete)
pt: systemd (obsoleto)

note: type: textblock
en: Adds L<dh_systemd_enable(1)> and L<dh_systemd_start(1)> to the sequence in compat level 10 or below.  Obsolete in compat 11 or later.
pt: Adiciona L<dh_systemd_enable(1)> e L<dh_systemd_start(1)> à sequência em nível de compatibilidade 10 ou inferior. Obsoleto em compatibilidade 11 ou posterior.

note: type: =head1
en: INTERNALS
pt: INTERNOS

note: type: textblock
en: If you're curious about B<dh>'s internals, here's how it works under the hood.
pt: Se você está curioso sobre o funcionamento interno do B<dh>, aqui está como funciona por baixo da capota.

note: type: textblock
en: In compat 10 (or later), B<dh> creates a stamp file F<debian/debhelper-build-stamp> after the build step(s) are complete to avoid re-running them.  It is possible to avoid the stamp file by passing B<--without=build-stamp> to B<dh>.  This makes "no clean" builds behave more like what some people expect at the expense of possibly running the build and test twice (the second time as root or under L<fakeroot(1)>).
pt: No modo compatibilidade 10 (ou posterior), o B<dh> cria um ficheiro stamp <debian/debhelper-build-stamp> após os passo(s) de compilação estarem completos para evitar voltar a corre-los. É possível evitar o ficheiro stamp ao passar B<--without=build-stamp> para  B<dh>.  Isto faz com que compilações "não limpas" se comportem mais como o que algumas pessoas esperam à custa de possivelmente correrem a compilação e testa-la duas vezes (a segunda vez como root ou sob L<fakeroot(1)>).

note: type: textblock
en: Inside an override target, B<dh_*> commands will create a log file F<debian/package.debhelper.log> to keep track of which packages the command(s) have been run for.  These log files are then removed once the override target is complete.
pt: Dentro de um alvo de sobreposição, os comandos B<dh_*> irão criar um ficheiro de registo F<debian/package.debhelper.log> para manter acompanhamento de para quais pacotes os comando(s) têm corrido. Estes ficheiros log são depois removidos assim que o alvo de sobreposição estiver completo.

note: type: textblock
en: In compat 9 or earlier, each debhelper command will record when it's successfully run in F<debian/package.debhelper.log>. (Which B<dh_clean> deletes.) So B<dh> can tell which commands have already been run, for which packages, and skip running those commands again.
pt: No modo de compatibilidade 9 e anteriores, cada comando do debhelper irá gravar em F<debian/pacote.debhelper.log> quando é corrido com sucesso. (O qual B<dh_clean> apaga.) Portanto o B<dh> consegue dizer quais comandos já foram corridos, para quais pacotes, e evita correr esses comandos de novo.

note: type: textblock
en: Each time B<dh> is run (in compat 9 or earlier), it examines the log, and finds the last logged command that is in the specified sequence. It then continues with the next command in the sequence.
pt: De cada vez que B<dh> corre (no nível de compatibilidade 9 ou anterior), examina o relatório, e encontra o último comando registado que está na sequência especificada. Depois continua com o próximo comando da sequência.

note: type: textblock
en: A sequence can also run dependent targets in debian/rules.  For example, the "binary" sequence runs the "install" target.
pt: Uma sequência também pode correr alvos dependentes em debian/rules. Por exemplo, a sequência "binary" corre o alvo "install".

note: type: textblock
en: B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass information through to debhelper commands that are run inside override targets. The contents (and indeed, existence) of this environment variable, as the name might suggest, is subject to change at any time.
pt: B<dh> usa a variável de ambiente B<DH_INTERNAL_OPTIONS> para passar informação através dos comandos debhelper que são corridos dentro de alvos de sobreposição. O conteúdo (e de facto a existência) desta variável de ambiente. como o nome sugere, está sujeito a alterações em qualquer altura.

note: type: textblock
en: Commands in the B<build-indep>, B<install-indep> and B<binary-indep> sequences are passed the B<-i> option to ensure they only work on architecture independent packages, and commands in the B<build-arch>, B<install-arch> and B<binary-arch> sequences are passed the B<-a> option to ensure they only work on architecture dependent packages.
pt: Aos comandos nas sequências B<build-indep>, B<install-indep> e B<binary-indep> é passada a opção B<-i> para assegurar que eles apenas trabalham em pacotes independentes da arquitectura, e aos comandos nas sequências B<build-arch>, B<install-arch> e B<binary-arch> é passada a opção B<-a> para assegurar que eles apenas trabalham em pacotes dependentes da arquitectura.

note: type: textblock
en: This program is a part of debhelper.
pt: Este programa é parte do debhelper.

note: type: textblock
en: dh_auto_build - automatically builds a package
pt: dh_auto_build - compila automaticamente um pacote

note: type: textblock
en: B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
pt: B<dh_auto_build> [S<I<opções do sistema de compilação>>] [S<I<opções do debhelper>>] [S<B<--> I<parâmetros>>]

note: type: textblock
en: B<dh_auto_build> is a debhelper program that tries to automatically build a package. It does so by running the appropriate command for the build system it detects the package uses. For example, if a F<Makefile> is found, this is done by running B<make> (or B<MAKE>, if the environment variable is set). If there's a F<setup.py>, or F<Build.PL>, it is run to build the package.
pt: B<dh_auto_build> é um programa debhelper que tenta compilar automaticamente um pacote. Fá-lo ao correr o comando apropriado para o sistema que compilação que detecta que o pacote usa. Por exemplo, se for encontrado um F<Makefile>, isto é feito ao correr B<make> (ou B<MAKE>, se a variável de ambiente estiver definida). Se existir um F<setup.py>, ou F<Build.PL>, o mesmo é executado para compilar o pacote.

note: type: textblock
en: This is intended to work for about 90% of packages. If it doesn't work, you're encouraged to skip using B<dh_auto_build> at all, and just run the build process manually.
pt: Isto entende-se que deve funcionar com cerca de 90% dos pacotes. Se não funcionar, você é encorajado não usar mesmo o B<dh_auto_build>, e apenas executar o processo de compilação manualmente.

note: type: textblock
en: See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build system selection and control options.
pt: Veja L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> para uma lista de selecção de sistemas de compilação comuns e opções de controle.

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_build> usually passes.
pt: Passa I<params> para o programa que é executado, após os parâmetros que o B<dh_auto_build> normalmente passa.

note: type: textblock
en: dh_auto_clean - automatically cleans up after a build
pt: dh_auto_clean - limpa tudo automaticamente após uma compilação

note: type: textblock
en: B<dh_auto_clean> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
pt: B<dh_auto_clean> [S<I<opções do sistema de compilação>>] [S<I<opções do debhelper>>] [S<B<--> I<parâmetros>>]

note: type: textblock
en: B<dh_auto_clean> is a debhelper program that tries to automatically clean up after a package build. It does so by running the appropriate command for the build system it detects the package uses. For example, if there's a F<Makefile> and it contains a B<distclean>, B<realclean>, or B<clean> target, then this is done by running B<make> (or B<MAKE>, if the environment variable is set). If there is a F<setup.py> or F<Build.PL>, it is run to clean the package.
pt: B<dh_auto_clean> é um programa debhelper que tenta fazer limpeza automática após a compilação de um pacote. Fá-lo ao correr o comando apropriado para o sistema que compilação que detecta que o pacote usa. Por exemplo, se existir um F<Makefile> e se conter um alvo B<distclean>, B<realclean>, ou B<clean>, então isto é feito ao correr B<make> (ou B<MAKE>, se a variável de ambiente estiver definida). Se existir um F<setup.py>, ou F<Build.PL>, o mesmo é executado para limpar o pacote.

note: type: textblock
en: This is intended to work for about 90% of packages. If it doesn't work, or tries to use the wrong clean target, you're encouraged to skip using B<dh_auto_clean> at all, and just run B<make clean> manually.
pt: Isto entende-se que deve funcionar com cerca de 90% dos pacotes. Se não funcionar, ou tentar usar o alvo de limpeza errado,  você é encorajado não usar mesmo o B<dh_auto_clean>, e correr o B<make clean> manualmente.

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_clean> usually passes.
pt: Passa I<params> para o programa que é executado, após os parâmetros que o B<dh_auto_clean> normalmente passa.

note: type: textblock
en: dh_auto_configure - automatically configure a package prior to building
pt: dh_auto_configure - configura um pacote automaticamente antes da compilação

note: type: textblock
en: B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
pt: B<dh_auto_configure> [S<I<opções do sistema de compilação>>] [S<I<opções do debhelper>>] [S<B<--> I<parâmetros>>]

note: type: textblock
en: B<dh_auto_configure> is a debhelper program that tries to automatically configure a package prior to building. It does so by running the appropriate command for the build system it detects the package uses.  For example, it looks for and runs a F<./configure> script, F<Makefile.PL>, F<Build.PL>, or F<cmake>. A standard set of parameters is determined and passed to the program that is run. Some build systems, such as make, do not need a configure step; for these B<dh_auto_configure> will exit without doing anything.
pt: B<dh_auto_configure> é um programa debhelper que tenta configurar automaticamente um pacote antes da compilação. Fá-lo ao correr o comando apropriado para o sistema que compilação que detecta que o pacote usa. Por exemplo, procura e executa um script F<./configure>, o F<Makefile.PL>, F<Build.PL>, ou o F<cmake>. É determinado um conjunto de parâmetros standard e passado ao programa que é executado. Alguns sistemas de compilação como o make, não precisam de um passo de configuração; para estes o B<dh_auto_configure> irá terminar sem ter feito nada.

note: type: textblock
en: This is intended to work for about 90% of packages. If it doesn't work, you're encouraged to skip using B<dh_auto_configure> at all, and just run F<./configure> or its equivalent manually.
pt: Isto entende-se que deve funcionar com cerca de 90% dos pacotes. Se não funcionar, você é encorajado a não usar B<dh_auto_configure>, e correr F<./configure> ou o seu equivalente manualmente.

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_configure> usually passes. For example:
pt: Passa I<params> para o programa que é executado, após os parâmetros que o B<dh_auto_configure> normalmente passa. Por exemplo:

note: type: textblock
en: dh_auto_install - automatically runs make install or similar
pt: dh_auto_install - corre automaticamente "make install" ou semelhante

note: type: textblock
en: B<dh_auto_install> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
pt: B<dh_auto_install> [S<I<opções do sistema de compilação>>] [S<I<opções do debhelper>>] [S<B<--> I<parâmetros>>]

note: type: textblock
en: B<dh_auto_install> is a debhelper program that tries to automatically install built files. It does so by running the appropriate command for the build system it detects the package uses. For example, if there's a F<Makefile> and it contains a B<install> target, then this is done by running B<make> (or B<MAKE>, if the environment variable is set). If there is a F<setup.py> or F<Build.PL>, it is used. Note that the Ant build system does not support installation, so B<dh_auto_install> will not install files built using Ant.
pt: B<dh_auto_install> é um programa debhelper que tenta instalar automaticamente ficheiros compilados. Fá-lo ao correr o comando apropriado para o sistema de compilação que detecta que o pacote usa. Por exemplo, se existir um F<Makefile> e este conter um alvo B<install>, então isto é feito ao correr B<make> (ou B<MAKE>, se a variável de ambiente estiver definida). Se existir um F<setup.py> ou F<Build.PL>, ele é usado. Note que o sistema de compilação Ant não suporta instalação, portanto o B<dh_auto_install> não irá instalar ficheiros compilados usando o Ant.

note: type: textblock
en: In compat 15 or later, B<dh_auto_install> will use F<debian/tmp> as the default B<--destdir> and should be moved from there to the appropriate package build directory using L<dh_install(1)> or similar tools. Though if the B<single-binary> addon for L<dh(1)> is activated, then it will pass an explicit B<< --destdir=debian/I<package>/ >> to B<dh_auto_install>.
pt: Em compatibilidade 15 ou posterior, B<dh_auto_install> irá usar F<debian/tmp> como B<--destdir> predefinida e deve ser movida de lá para o directório de compilação de pacote apropriado usando L<dh_install(1)> ou ferramentas semelhantes. Contudo, se o addon B<single-binary> para L<dh(1)> estiver activo, então irá passar um B<< --destdir=debian/I<package>/ >> explícito para B<dh_auto_install>.

note: type: textblock
en: For earlier compat levels then unless B<--destdir> option is specified, the files are installed into debian/I<package>/ if there is only one binary package. In the multiple binary package case, the files are instead installed into F<debian/tmp/>, and should be moved from there to the appropriate package build directory using L<dh_install(1)> or similar tools.
pt: Para níveis de compatibilidade anteriores então a menos que a opção B<--destdir> seja especificada, os ficheiros são instalados em debian/I<pacote>/ se existir apenas um pacote binário. No caso de pacote de múltiplos binários, em vez disso os ficheiros são instalados em F<debian/tmp/>, e deverão ser movidos daí para o directório apropriado de compilação de pacote usando o L<dh_install(1)> ou ferramentas semelhantes.

note: type: textblock
en: B<DESTDIR> is used to tell make where to install the files.  If the Makefile was generated by MakeMaker from a F<Makefile.PL>, it will automatically set B<PREFIX=/usr> too, since such Makefiles need that.
pt: B<DESTDIR> é usado para dizer ao make onde instalar os ficheiros. Se o Makefile foi gerado pelo MakeMaker a partir de um F<Makefile.PL>, irá automaticamente definir B<PREFIX=/usr> também, pois tais Makefiles precisam disso.

note: type: textblock
en: This is intended to work for about 90% of packages. If it doesn't work, or tries to use the wrong install target, you're encouraged to skip using B<dh_auto_install> at all, and just run make install manually.
pt: Isto entende-se que deve funcionar com cerca de 90% dos pacotes. Se não funcionar, ou tente usar o alvo de instalação errado, você é encorajado a não usar o B<dh_auto_install>, e correr o make install manualmente.

note: type: =item
en: B<--destdir=>I<directory>
pt: B<--destdir=>I<directório>

note: type: textblock
en: Install files into the specified I<directory>. If this option is not specified, destination directory is determined automatically as described in the L</B<DESCRIPTION>> section.
pt: Instala ficheiros no I<directório> especificado. Se esta opção não for especificada, o directório de destino é determinado automaticamente como descrito na secção L</B<DESCRIÇÃO>>

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_install> usually passes.
pt: Passa I<params> para o programa que é executado, após os parâmetros que o B<dh_auto_install> normalmente passa.

note: type: textblock
en: dh_auto_test - automatically runs a package's test suites
pt: dh_auto_test - corre automaticamente os conjuntos de testes dum pacote

note: type: textblock
en: B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
pt: B<dh_auto_test> [S<I<opções do sistema de compilação>>] [S<I<opções do debhelper>>] [S<B<--> I<parâmetros>>]

note: type: textblock
en: B<dh_auto_test> is a debhelper program that tries to automatically run a package's test suite. It does so by running the appropriate command for the build system it detects the package uses. For example, if there's a Makefile and it contains a B<test> or B<check> target, then this is done by running B<make> (or B<MAKE>, if the environment variable is set). If the test suite fails, the command will exit nonzero. If there's no test suite, it will exit zero without doing anything.
pt: B<dh_auto_test> é um programa debhelper que tenta correr automaticamente uma suite de teste de um pacote. Fá-lo ao correr o comando apropriado para o sistema de compilação que detecta que o pacote usa. Por exemplo, Se existir um Makefile e conter um alvo B<test> ou B<check>, então é feito ao correr B<make> (ou B<MAKE>, se a variável de ambiente estiver definida). Se a suite de teste falhar, o comando irá terminar com não-zero. Se não existir uma suite de teste, irá terminar com zero sem fazer nada.

note: type: textblock
en: This is intended to work for about 90% of packages with a test suite. If it doesn't work, you're encouraged to skip using B<dh_auto_test> at all, and just run the test suite manually.
pt: Isto entende-se que deve funcionar com cerca de 90% dos pacotes numa suite de teste. Se não funcionar, você é encorajado não usar o B<dh_auto_test>, e correr a suite de teste manualmente.

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_test> usually passes.
pt: Passa I<params> para o programa que é executado, após os parâmetros que o B<dh_auto_test> normalmente passa.

note: type: textblock
en: If the B<DEB_BUILD_OPTIONS> environment variable contains B<nocheck>, no tests will be performed.
pt: Se a variável de ambiente B<DEB_BUILD_OPTIONS> conter B<nocheck>, nenhum teste será executado.

note: type: textblock
en: dh_bugfiles - install bug reporting customization files into package build directories
pt: dh_bugfiles - instala ficheiros de personalização de relatório de bugs nos directórios de compilação de pacotes.

note: type: textblock
en: B<dh_bugfiles> [B<-A>] [S<I<debhelper options>>]
pt: B<dh_bugfiles> [B<-A>] [S<I<debhelper opções>>]

note: type: textblock
en: B<dh_bugfiles> is a debhelper program that is responsible for installing bug reporting customization files (bug scripts and/or bug control files and/or presubj files) into package build directories.
pt: B<dh_bugfiles> é um programa debhelper que é responsável por instalar ficheiros de personalização de relatórios de bugs (scripts de bugs e/ou ficheiros de controle de bugs e/ou ficheiros presubj) nos directórios de compilação de pacotes.

note: type: =head1
en: FILES
pt: FICHEIROS

note: type: =item
en: debian/I<package>.bug-script
pt: debian/I<pacote>.bug-script

note: type: textblock
en: This is the script to be run by the bug reporting program for generating a bug report template. This file is installed as F<usr/share/bug/package> in the package build directory if no other types of bug reporting customization files are going to be installed for the package in question. Otherwise, this file is installed as F<usr/share/bug/package/script>. Finally, the installed script is given execute permissions.
pt: Este é o script a ser corrido pelo programa de reportar bugs para gerar um modelo de relatório de bug. Este ficheiro é instalado como F<usr/share/bug/package> no directório de compilação do pacote se não existirem outros ficheiros de tipos personalizados de relatórios de bugs para serem instalados no pacote em questão. Caso contrário, este ficheiro é instalado como F<usr/share/bug/package/script>. Finalmente, ao script instalado é dada permissão de execução.

note: type: =item
en: debian/I<package>.bug-control
pt: debian/I<pacote>.bug-control

note: type: textblock
en: It is the bug control file containing some directions for the bug reporting tool. This file is installed as F<usr/share/bug/package/control> in the package build directory.
pt: É o ficheiro de controle de bug que contém algumas direcções para a ferramenta de reportar bugs. Este ficheiro é instalado como F<usr/share/bug/package/control> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.bug-presubj
pt: debian/I<pacote>.bug-presubj

note: type: textblock
en: The contents of this file are displayed to the user by the bug reporting tool before allowing the user to write a bug report on the package to the Debian Bug Tracking System. This file is installed as F<usr/share/bug/package/presubj> in the package build directory.
pt: O conteúdo deste ficheiro é mostrado ao utilizador pela ferramenta de reportar bugs antes de permitir ao utilizador escrever um relatório de bug sobre o pacote no Bug Tracking System de Debian. Este ficheiro é instalado como F<usr/share/bug/package/presubj> no directório de compilação do pacote.

note: type: textblock
en: Install F<debian/bug-*> files to ALL packages acted on when respective F<debian/package.bug-*> files do not exist. Normally, F<debian/bug-*> will be installed to the first package only.
pt: Instala ficheiros F<debian/bug-*> em TODOS os pacotes actuados quando os respectivos ficheiros F<debian/package.bug-*> não existem. Normalmente, F<debian/bug-*> será instalado apenas no primeiro pacote.

note: type: textblock
en: dh_builddeb - build Debian binary packages
pt: dh_builddeb - compila pacotes binários Debian

note: type: textblock
en: B<dh_builddeb> simply calls L<dpkg-deb(1)> to build a Debian package or packages.  It will also build dbgsym packages when L<dh_strip(1)> and L<dh_gencontrol(1)> have prepared them.
pt: B<dh_builddeb> chama simplesmente L<dpkg-deb(1)> para compilar um pacote ou vários pacotes Debian. Também compila pacotes dbgsym quando foram preparados por L<dh_strip(1)> e L<dh_gencontrol(1)>.

note: type: textblock
en: It supports building multiple binary packages in parallel, when enabled by DEB_BUILD_OPTIONS.
pt: Suporta a compilação de múltiplos pacotes binários em paralelo, quando activado por DEB_BUILD_OPTIONS.

note: type: textblock
en: When the I<Rules-Requires-Root> field is not (effectively)  I<binary-targets>, B<dh_builddeb> will pass B<--root-owner-group> to L<dpkg-deb(1)>.
pt: Quando o campo I<Rules-Requires-Root> não for (efectivamente) I<binary-targets>, B<dh_builddeb> passará B<--root-owner-group> para L<dpkg-deb(1)>.

note: type: textblock
en: Use this if you want the generated F<.deb> files to be put in a directory other than the default of "F<..>".
pt: Use isto se deseja que os ficheiros F<.deb> gerados sejam colocados num directório diferente da predefinição "F<..>".

note: type: =item
en: B<--filename=>I<name>
pt: B<--filename=>I<nome>

note: type: textblock
en: Use this if you want to force the generated .deb file to have a particular file name. Does not work well if more than one .deb is generated!
pt: Use isto se desejar forçar que o ficheiro .deb gerado tenha um nome de ficheiro particular. Não funciona bem se for gerado mais do que um .deb!

note: type: textblock
en: Pass I<params> to L<dpkg-deb(1)> when it is used to build the package.
pt: Passa I<params> para L<dpkg-deb(1)> quando é usado para compilar o pacote.

note: type: textblock
en: This is another way to pass I<params> to L<dpkg-deb(1)>.  It is deprecated; use B<--> instead.
pt: Este é outro modo de passar I<params> para L<dpkg-deb(1)>.  Está descontinuado; use B<--> em vez deste.

note: type: textblock
en: dh_clean - clean up package build directories
pt: dh_clean - limpa os directórios de compilação de pacotes

note: type: textblock
en: B<dh_clean> is a debhelper program that is responsible for cleaning up.  It should be the last step of the B<clean> target and other debhelper commands generally assume that B<dh_clean> will clean up after them.
pt: B<dh_clean> é um programa debhelper que é responsável pela limpeza. Ele deve estar no último passo do alvo B<clean> e o outros comandos debhelper geralmente assumem que B<dh_clean> irá limpar tudo depois deles.

note: type: textblock
en: It does not run "make clean" to clean up after the build process. Use L<dh_auto_clean(1)> to do things like that.
pt: Não corre o "make clean" para limpara após o processo de compilação. Use L<dh_auto_clean(1)> para fazer as coisas dessa maneira.

note: type: textblock
en: Can list other paths to be removed.
pt: Pode listar outros caminhos para serem removidos.

note: type: textblock
en: Note that directories listed in this file B<must> end with a trailing slash.  Any content in these directories will be removed as well.
pt: Note que os directórios listados neste ficheiro B<devem> terminar com uma barra final. Qualquer conteúdo nestes directórios será também removido.

note: type: textblock
en: Supports substitution variables in compat 13 and later as documented in L<debhelper(7)>.
pt: Suporta variáveis de substituição em compatibilidade 13 e posterior como documentado em L<debhelper(7)>.

note: type: textblock
en: This is deprecated, use L<dh_prep(1)> instead.
pt: Isto está descontinuado, use L<dh_prep(1)> em vez deste.

note: type: textblock
en: The option is removed in compat 12.
pt: A opção foi removida no nível de compatibilidade 12.

note: type: textblock
en: Only clean the package build directories, do not clean up any other files at all.
pt: Apenas limpa os directórios de compilação do pacote, não limpa mais nenhuns outros ficheiros.

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being deleted, even if they would normally be deleted. You may use this option multiple times to build up a list of things to exclude.
pt: Exclui ficheiros que contenham I<item> em qualquer ponto do seu nome de ficheiro de serem apagados, mesmo se estes fossem normalmente apagados. Você pode usar esta opção várias vezes para construir uma lista de coisas a excluir.

note: type: textblock
en: Delete these I<path>s too.
pt: Apaga estes I<caminho>s também.

note: type: textblock
en: Note that directories passed as arguments B<must> end with a trailing slash.  Any content in these directories will be removed as well.
pt: Note que os directórios passados como argumentos B<devem> terminar com uma barra final. Qualquer conteúdo nestes directórios será também removido.

note: type: textblock
en: dh_compress - compress files and fix symlinks in package build directories
pt: dh_compress - comprime ficheiro e corrige links simbólicos em directórios de compilação de pacotes

note: type: textblock
en: B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file> ...>]
pt: B<dh_compress> [S<I<debhelper opções>>] [B<-X>I<item>] [B<-A>] [S<I<ficheiro> ...>]

note: type: textblock
en: B<dh_compress> is a debhelper program that is responsible for compressing the files in package build directories, and makes sure that any symlinks that pointed to the files before they were compressed are updated to point to the new files.
pt: B<dh_compress> é um programa debhelper que é responsável por comprimir os ficheiros nos directórios de compilação de pacotes, e certificar-se que todos os links simbólicos estavam apontados aos ficheiros antes de eles serem comprimidos são actualizados para apontar para os novos ficheiros.

note: type: textblock
en: By default, B<dh_compress> compresses files that Debian policy mandates should be compressed, namely all files in F<usr/share/info>, F<usr/share/man>, files in F<usr/share/doc> that are larger than 4k in size, (except the F<copyright> file, F<.html> and other web files, image files, and files that appear to be already compressed based on their extensions), and all F<changelog> files. Plus PCF fonts underneath F<usr/share/fonts/X11/>
pt: Por predefinição, o B<dh_compress> comprime ficheiros que a política Debian diz que deverão ser comprimidos, nomeadamente todos os ficheiros em F<usr/share/info>, F<usr/share/man>, ficheiros em F<usr/share/doc> que são maiores que 4k, (excepto o ficheiro F<copyright>, F<.html> e outros ficheiros web, ficheiros de imagens, e ficheiros que aparentam já estarem comprimidos com base nas suas extensões), e todos os ficheiros F<changelog>. Mais as fonts PCF à frente de F<usr/share/fonts/X11/>.

note: type: =item
en: debian/I<package>.compress
pt: debian/I<pacote>.compress

note: type: textblock
en: These files are deprecated.
pt: Estes ficheiros estão descontinuados.

note: type: textblock
en: If this file exists, the default files are not compressed. Instead, the file is ran as a shell script, and all filenames that the shell script outputs will be compressed. The shell script will be run from inside the package build directory. Note though that using B<-X> is a much better idea in general; you should only use a F<debian/package.compress> file if you really need to.
pt: Se este ficheiro existir, os ficheiros predefinidos não são comprimidos. Em vez disso, o ficheiro é corrido como um script de shell, e todos os nomes de ficheiros que o script de shell lança serão comprimidos. O script shell será accionado a partir de dentro do directório de compilação do pacote. Note contudo que usar B<-X> é uma ideia muito melhor no geral; você deve usar um ficheiro F<debian/package.compress> apenas se realmente precisa de o fazer.

note: type: textblock
en: Exclude files that contain F<item> anywhere in their filename from being compressed. For example, B<-X.tiff> will exclude TIFF files from compression.  You may use this option multiple times to build up a list of things to exclude.
pt: Exclui ficheiros que contêm I<item> em qualquer ponto do seu nome de ficheiro, de serem comprimidos. Por exemplo, B<-X.tiff> irá excluir ficheiros TIFF da compressão. Você pode usar esta opção várias vezes para construir uma lista de coisas a excluir.

note: type: textblock
en: Compress all files specified by command line parameters in ALL packages acted on.
pt: Comprime todos os ficheiros especificados por parâmetros de linha de comandos em TODOS os pacotes que actua.

note: type: =item
en: I<file> ...
pt: I<ficheiro> ...

note: type: textblock
en: Add these files to the list of files to compress.
pt: Adiciona estes ficheiros à lista de ficheiros para comprimir.

note: type: =head1
en: CONFORMS TO
pt: EM CONFORMIDADE COM

note: type: textblock
en: Debian policy, version 3.0
pt: Debian policy, versão 3.0

note: type: textblock
en: dh_dwz - optimize DWARF debug information in ELF binaries via dwz
pt: dh_dwz - optimiza informação de depuração DWARF em binários ELF via dwz

note: type: textblock
en: B<dh_dwz> [S<I<debhelper options>>] [B<-X>I<item>] [S<B<--> I<params>>]
pt: B<dh_dwz> [S<I<debhelper opções>>] [B<-X>I<item>] [S<B<--> I<parâmetros>>]

note: type: textblock
en: B<dh_dwz> is a debhelper program that will optimize the (uncompressed)  size of the DWARF debug information in ELF binaries.  It does so by running L<dwz(1)> on all the ELF binaries in the package.
pt: B<dh_dwz> é um programa de debhelper que irá optimizar o tamanho (não comprimido) da informação de depuração DWARF nos binários ELF. Fá-lo ao correr L<dwz(1)> em todos os binários ELF no pacote.

note: type: textblock
en: Whether L<dwz(1)> should generate a I<multifile> from the ELF binaries in the same package.  When enabled, if a package ships at least 2 ELF binaries, B<dh_dwz> will instruct L<dwz(1)> to generate a multifile for the package.
pt: Se L<dwz(1)> deve gerar um I<multifile> a partir de binários ELF no mesmo pacote. Quando activado, se um pacote conter pelo menos 2 binários ELF, B<dh_dwz> irá instruir L<dwz(1)> a gerar um multifile para o pacote.

note: type: textblock
en: By default, B<dh_dwz> will attempt to create a multifile but will continue without if L<dwz(1)> does not create one (but succeeds anyway).  This commonly happens when the debug files do not contain debug symbols (e.g. a missing -g to the compiler) or when the debug symbols are compressed (see Debian bug #931891).  If B<--dwz-multifile> is passed, then B<dh_dwz> will abort with an error if L<dwz(1)> does not create a multifile.
pt: Por predefinição, B<dh_dwz> irá tentar criar um multi-ficheiro mas irá continuar sem o fazer se L<dwz(1)> não criar um (mas mesmo assim acabar com sucesso). Isto é comum acontecer quando os ficheiros debug não contêm símbolos de depuração (ex. um -g em falta no compilador), ou quando os símbolos de depuração estão comprimidos (veja Debian bug #931891). Se B<--dwz-multifile> for passado, então B<dh_dwz> irá abortar com um erro se L<dwz(1)> não criar um multi-ficheiro.

note: type: textblock
en: Note this options may not work if a package contains more ELF binaries than can fit on a single command line.  If this becomes a problem, please pass B<--no-dwz-multifile> to work around the issue.
pt: Note que estas opções podem não funcionar se um pacote conter mais binários ELF que possam caber numa única linha de comandos. Se isto for um problema, por favor passe B<--no-dwz-multifile> para contornar este problema.

note: type: textblock
en: The generated multifile will be compressed with B<objcopy --compress-debug-sections>.
pt: O multifile gerado será comprimido com B<objcopy --compress-debug-sections>.

note: type: textblock
en: Note for B<udeb> packages: B<dh_dwz> will never generate multifiles for B<udeb> packages.  It will still use B<dwz> to reduce the file size of debug files if it finds any.
pt: Nota para pacotes B<udeb>: B<dh_dwz> nunca irá gerar multi-ficheiros para pacotes B<udeb>. Irá continuar a usar B<dwz> para reduzir o tamanho de ficheiros debug se encontrar algum.

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being stripped. You may use this option multiple times to build up a list of things to exclude.
pt: Exclui ficheiros que contenham I<item> em qualquer ponto do seu nome de serem despojados. Você pode usar esta opção várias vezes para construir uma lista de coisas a excluir.

note: type: textblock
en: Pass I<params> to L<dwz(1)> when it processes ELF binaries.  This is mostly useful for setting memory related parameters (e.g. -l and -L).
pt: Passa I<parâmetros> para L<dwz(1)> quando processa binários ELF. Isto é maioritariamente útil para definir parâmetros relacionados com memória (ex. -l e -L).

note: type: textblock
en: If the B<DEB_BUILD_OPTIONS> environment variable contains B<nostrip>, nothing will be stripped, in accordance with Debian policy (section 10.1 "Binaries").
pt: Se a variável de ambiente B<DEB_BUILD_OPTIONS> conter B<nostrip>,  nada será despojado, em conformidade com a política Debian (secção 10.1 "Binários").

note: type: textblock
en: While this tool technically does not remove debug information from binaries, it is still skipped when the B<DEB_BUILD_OPTIONS> environment variable contains B<nostrip>.  This is because B<nostrip> is often used to optimize build times (e.g. for "build and test"-cycles) rather than optimizing for size.
pt: Embora esta ferramenta tecnicamente não remover informação de depuração dos binários, é na mesma incluída quando a variável de ambiente B<DEB_BUILD_OPTIONS> contém B<nostrip>. Isto é assim porque B<nostrip> é muito usado para optimizar tempos de compilação (ex. para -cycles de "compilar e testar") em vez de optimizar para tamanho.

note: type: textblock
en: dh_fixperms - fix permissions of files in package build directories
pt: dh_fixperms - corrige permissões nos ficheiros em directórios de compilação de pacotes

note: type: textblock
en: B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]
pt: B<dh_fixperms> [S<I<debhelper opções>>] [B<-X>I<item>]

note: type: textblock
en: B<dh_fixperms> is a debhelper program that is responsible for setting the permissions of files and directories in package build directories to a sane state -- a state that complies with Debian policy.
pt: B<dh_fixperms> é um programa debhelper que é responsável por definir as permissões dos ficheiros e directórios nos directórios de compilação de pacotes para um estado são -- um estado em conformidade com a política de Debian.

note: type: textblock
en: B<dh_fixperms> makes all files in F<usr/share/doc> in the package build directory (excluding files in the F<examples/> directory) be mode 644. It also changes the permissions of all man pages to mode 644. It removes group and other write permission from all files. It removes execute permissions from any libraries, headers, Perl modules, or desktop files that have it set. It makes all files in the standard F<bin> and F<sbin> directories, F<usr/games/> and F<etc/init.d> executable (since v4). Finally, it removes the setuid and setgid bits from all files in the package.
pt: B<dh_fixperms> faz com que todos os ficheiros em F<usr/share/doc> no directório de compilação do pacote (excluindo os ficheiros no directório F<examples/>) fiquem em modo 644. Também muda as permissões de todos os manuais para 644. Remove o grupo e outras permissões de escrita de todos os ficheiros. Remove permissões de executável de todas as bibliotecas, cabeçalhos, módulos Perl, ou ficheiro desktop que as têm definidas. Faz todos os ficheiros nos directórios F<bin> e F<sbin> standard, F<usr/games/> e F<etc/init.d> executáveis (desde v4). Finalmente, remove os bits setuid e setgid de todos os ficheiros do pacote.

note: type: textblock
en: When the I<Rules-Requires-Root> field has the (effective) value of I<binary-targets>, B<dh_fixperms> will also reset the ownership of all paths to "root:root".
pt: Quando o campo I<Rules-Requires-Root> tem o valor (efectivo) de I<binary-targets>, B<dh_fixperms> irá também reiniciar o proprietário de todos os caminhos para "root:root".

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from having their permissions changed. You may use this option multiple times to build up a list of things to exclude.
pt: Exclui ficheiros que contêm I<item> em qualquer ponto do seu nome de ficheiro, de terem as suas permissões alteradas. Você pode usar esta opção várias vezes para construir uma lista de coisas a excluir.

note: type: textblock
en: dh_gencontrol - generate and install control file
pt: dh_gencontrol - gera e instala ficheiro de controle

note: type: textblock
en: B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]
pt: B<dh_gencontrol> [S<I<debhelper opções>>] [S<B<--> I<params>>]

note: type: textblock
en: B<dh_gencontrol> is a debhelper program that is responsible for generating control files, and installing them into the I<DEBIAN> directory with the proper permissions.
pt: B<dh_gencontrol> é um programa debhelper que é responsável por gerar ficheiros de controle, e instala-los no directório I<DEBIAN> com as permissões apropriadas.

note: type: textblock
en: This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls it once for each package being acted on (plus related dbgsym packages), and passes in some additional useful flags.
pt: Este programa é meramente um wrapper em volta de L<dpkg-gencontrol(1)>, o qual o chama uma vez por cada pacote em que actua (mais os pacotes dbgsym relacionados), e passa para ele algumas bandeiras adicionais úteis.

note: type: textblock
en: B<Note> that if you use B<dh_gencontrol>, you must also use L<dh_builddeb(1)> to build the packages.  Otherwise, your build may fail to build as B<dh_gencontrol> (via L<dpkg-gencontrol(1)>) declares which packages are built.  As debhelper automatically generates dbgsym packages, it some times adds additional packages, which will be built by L<dh_builddeb(1)>.
pt: B<Note> que se você usar B<dh_gencontrol>, você também tem de usar L<dh_builddeb(1)> para compilar os pacotes. Caso contrário, a sua compilação pode falhar pois o B<dh_gencontrol> (via L<dpkg-gencontrol(1)>) declara quais pacotes são compilados. Como o debhelper gera automaticamente pacotes dbgsym, por vezes adiciona pacotes adicionais, que serão compilados por L<dh_builddeb(1)>.

note: type: textblock
en: Pass I<params> to L<dpkg-gencontrol(1)>.
pt: Passa I<params> para L<dpkg-gencontrol(1)>.

note: type: textblock
en: This is another way to pass I<params> to L<dpkg-gencontrol(1)>.  It is deprecated; use B<--> instead.
pt: Este é outro modo de passar I<params> para L<dpkg-gencontrol(1)>.  Está descontinuado, use B<--> em vez deste.

note: type: textblock
en: dh_icons - Update caches of Freedesktop icons
pt: dh_icons - Actualiza a cache de ícones de Freedesktop

note: type: textblock
en: B<dh_icons> [S<I<debhelper options>>] [B<-n>]
pt: B<dh_icons> [S<I<debhelper opções>>] [B<-n>]

note: type: textblock
en: B<dh_icons> is a debhelper program that updates caches of Freedesktop icons when needed, using the B<update-icon-caches> program provided by GTK+2.12.  Currently this program does not handle installation of the files, though it may do so at a later date, so should be run after icons are installed in the package build directories.
pt: B<dh_icons> é um programa debhelper que actualiza caches de ícones Freedesktop quando necessário, usando o programa B<update-icon-caches> disponibilizado pelo GTK+2.12. Presentemente este programa não lida com a instalação dos ficheiros, apesar de o poder vir a fazer numa data posterior, por isso deve ser accionado após os ícones estarem instalados nos directórios de compilação dos pacotes.

note: type: textblock
en: It takes care of adding maintainer script fragments to call B<update-icon-caches> for icon directories. (This is not done for gnome and hicolor icons, as those are handled by triggers.)  These commands are inserted into the maintainer scripts by L<dh_installdeb(1)>.
pt: Trata de adicionar fragmentos de script de maintainer para chamar B<update-icon-caches> para directórios de ícones. (Isto não é feito para ícones de gnome ou hicolor, pois esses são manuseados por triggers.) Estes comandos são inseridos nos scripts de maintainer pelo L<dh_installdeb(1)>.

note: type: textblock
en: Do not modify maintainer scripts.
pt: Não modifique os scripts do maintainer.

note: type: textblock
en: dh_install - install files into package build directories
pt: dh_install - instala ficheiros em directórios de compilação de pacotes

note: type: textblock
en: B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] [S<I<debhelper options>>] [S<I<file|dir> ... I<destdir>>]
pt: B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<directório>] [S<I<opções do debhelper>>] [S<I<ficheiro|directório> ... I<directório de destino>>]

note: type: textblock
en: B<dh_install> is a debhelper program that handles installing files into package build directories. There are many B<dh_install>I<*> commands that handle installing specific types of files such as documentation, examples, man pages, and so on, and they should be used when possible as they often have extra intelligence for those particular tasks. B<dh_install>, then, is useful for installing everything else, for which no particular intelligence is needed. It is a replacement for the old B<dh_movefiles> command.
pt: B<dh_install> é um programa debhelper que lida com a instalação de ficheiros em directórios de compilação de pacotes. Existem muitos comandos B<dh_install>I<*> que lidam com a instalação de tipos de ficheiros específicos como documentação, exemplos, manuais, e por ai fora, e esses devem ser usados sempre que possível pois geralmente eles têm inteligência extra para essas tarefas particulares. Então, o  B<dh_install> é útil para instalar tudo o resto, para qual não é necessária inteligência particular. É um substituto do antigo comando B<dh_movefiles>.

note: type: textblock
en: This program may be used in one of two ways. If you just have a file or two that the upstream Makefile does not install for you, you can run B<dh_install> on them to move them into place. On the other hand, maybe you have a large package that builds multiple binary packages. You can use the upstream F<Makefile> to install it all into F<debian/tmp>, and then use B<dh_install> to copy directories and files from there into the proper package build directories.
pt: Este programa pode ser usado de uma ou duas maneiras. Se você tem apenas um ficheiro ou dois que o Makefile do autor não instala por si, pode correr o B<dh_install> neles para os mover para a localização. Por outro lado, talvez você tenha um pacote grande que compila vários pacotes binários. Você pode usar o Makefile do autor para os instalar todos em F<debian/tmp>, e depois usar o B<dh_install> para copiar directórios e ficheiros de lá para para os directórios apropriados de compilação de pacotes.

note: type: textblock
en: From debhelper compatibility level 7 on, B<dh_install> will fall back to looking in F<debian/tmp> for files, if it does not find them in the current directory (or wherever you've told it to look using B<--sourcedir>).
pt: Desde nível de compatibilidade 7 do debhelper em diante, o B<dh_install> irá procurar os ficheiros em F<debian/tmp>, se não os encontrar no directório actual (ou onde você o mandou procurar usando B<--sourcedir>).

note: type: =item
en: debian/I<package>.install
pt: debian/I<pacote>.install

note: type: textblock
en: List the files to install into each package and the directory they should be installed to. The format is a set of lines, where each line lists a file or files to install, and at the end of the line tells the directory it should be installed in. The name of the files (or directories) to install should be given relative to the current directory, while the installation directory is given relative to the package build directory. You may use wildcards in the names of the files to install.
pt: Lista os ficheiros a instalar em cada pacote e o directório onde eles devem ser instalados. O formato é um conjunto de linhas, onde cada linha lista um ficheiro ou ficheiros a instalar, e no fim da linha diz o directório onde deverão ser instalados. O nome dos ficheiros (ou directórios) a instalar devem ser fornecidos relativamente ao directório actual, enquanto que o directório de instalação é fornecido relativamente ao directório de compilação do pacote. Você pode usar wildcards nos nomes dos ficheiros a instalar.

note: type: textblock
en: Note that if you list exactly one filename or wildcard-pattern on a line by itself, with no explicit destination, then B<dh_install> will automatically guess the destination to use, the same as if the --autodest option were used.
pt: Note que se você lista exactamente um nome de ficheiro ou um padrão de wildcard numa linha sozinho, sem um destino explícito, então o B<dh_install> irá adivinhar automaticamente o destino a usar, do mesmo modo em que se a opção --autodest fosse usada.

note: type: textblock
en: Used with the deprecated B<--list-missing> and B<--fail-missing> options.  Please refer to L<dh_missing(1)> for the documentation of this file.
pt: Usado com as opções B<--list-missing> e B<--fail-missing> descontinuadas. Por favor consulte L<dh_missing(1)> para a documentação deste ficheiro.

note: type: textblock
en: B<Deprecated>: Please use B<dh_missing --list-missing> instead.  If you use this option, B<dh_install> will call B<dh_missing> with that option after it has processed all the files.  Please see L<dh_missing(1)> for the documentation of this option.
pt: B<Descontinuado>: Por favor use B<dh_missing --list-missing> em vez deste. Se usar esta opção, o B<dh_install> irá chamar B<dh_missing> com essa opção após ter processado todos os ficheiros. Por favor veja L<dh_missing(1)> para a documentação sobre esta opção.

note: type: textblock
en: B<Deprecated>: Please use B<dh_missing --fail-missing> instead.  If you use this option, B<dh_install> will call B<dh_missing> with that option after it has processed all the files.  Please see L<dh_missing(1)> for the documentation of this option.
pt: B<Descontinuado>: Por favor use B<dh_missing --fail-missing> em vez deste. Se usar esta opção, B<dh_install> irá chamar B<dh_missing> com essa opção após ter processado todos os ficheiros. Por favor veja L<dh_missing(1)> para a documentação sobre esta opção.

note: type: =item
en: B<--sourcedir=>I<dir>
pt: B<--sourcedir=>I<directório>

note: type: textblock
en: Look in the specified directory for files to be installed.
pt: Procura no directório especificado por ficheiros a instalar.

note: type: textblock
en: Note that this is not the same as the B<--sourcedirectory> option used by the B<dh_auto_>I<*> commands. You rarely need to use this option, since B<dh_install> automatically looks for files in F<debian/tmp> in debhelper compatibility level 7 and above.
pt: Note que isto não é o mesmo que a opção B<--sourcedirectory> usada pelos comandos B<dh_auto_>I<*>. Você raramente vai precisar de usar esta opção, pois o B<dh_install> procura automaticamente por ficheiros em F<debian/tmp> no nível de compatibilidade 7 e superiores do debhelper.

note: type: textblock
en: Guess as the destination directory to install things to. If this is specified, you should not list destination directories in F<debian/package.install> files or on the command line. Instead, B<dh_install> will guess as follows:
pt: Adivinha o directório de destino para onde instalar as coisas. Se isto for especificado, você não deve listar directórios de destino nos ficheiros F<debian/package.install> nem na linha de comandos. Em vez disso, o B<dh_install> irá adivinhar no método que se segue:

note: type: textblock
en: Strip off F<debian/tmp> (or the sourcedir if one is given) from the front of the filename, if it is present, and install into the dirname of the filename. So if the filename is F<debian/tmp/usr/bin>, then that directory will be copied to F<debian/package/usr/>. If the filename is F<debian/tmp/etc/passwd>, it will be copied to F<debian/package/etc/>.
pt: Despoja F<debian/tmp> (ou o sourcedir se for fornecido um) da frente do nome de ficheiro, se estiver presente, e instala-lo no nome de directório do nome de ficheiro. Então, se o nome de ficheiro for F<debian/tmp/usr/bin>, então esse directório será copiado para F<debian/package/usr/>. Se o nome de ficheiro for F<debian/tmp/etc/passwd>, será copiado para F<debian/package/etc/>.

note: type: =item
en: I<file|dir> ... I<destdir>
pt: I<ficheiro|dir> ... I<destdir>

note: type: textblock
en: Lists files (or directories) to install and where to install them to.  The files will be installed into the first package F<dh_install> acts on.
pt: Lista ficheiros (ou directórios) a instalar e onde os instalar. Os  ficheiros serão instalados no primeiro pacote em que o F<dh_install> actua.

note: type: textblock
en: Here are some small examples of configuration files for dh_install.
pt: Aqui estão alguns pequenos exemplos de ficheiros de configuração para dh_install.

note: type: =head1
en: LIMITATIONS
pt: LIMITAÇÕES

note: type: textblock
en: B<dh_install> cannot rename files or directories, it can only install them with the names they already have into wherever you want in the package build tree.
pt: B<dh_install> não pode renomear ficheiros ou directórios, pode apenas instala-los com os nomes que já têm para onde você os deseja na árvore de compilação do pacote.

note: type: textblock
en: Please remember the following three things:
pt: Por favor lembre-se das três coisas seguintes:

note: type: =item
en: * The package must be using compatibility level 9 or later (see L<debhelper(7)>)
pt: * O pacote tem se usar nível de compatibilidade 9 ou superior veja L<debhelper(7)>)

note: type: =item
en: * The package will need a build-dependency on dh-exec.
pt: * O pacote irá precisar de uma dependência de compilação em dh-exec.

note: type: =item
en: * The install file must be marked as executable.
pt: * O ficheiro install tem de ser marcado como executável.

note: type: textblock
en: dh_installcatalogs - install and register SGML Catalogs
pt: dh_installcatalogs - instala e regista Catálogos SGML

note: type: textblock
en: B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]
pt: B<dh_installcatalogs> [S<I<debhelper opções>>] [B<-n>]

note: type: textblock
en: B<dh_installcatalogs> is a debhelper program that installs and registers SGML catalogs. It complies with the Debian XML/SGML policy.
pt: B<dh_installcatalogs> é um programa debhelper que instala e regista catálogos SGML. Está em conformidade com a política XML/SGML de Debian.

note: type: textblock
en: Catalogs will be registered in a supercatalog, in F</etc/sgml/I<package>.cat>.
pt: Catálogos podem ser registados num super-catálogo, em F</etc/sgml/I<pacote>.cat>.

note: type: textblock
en: This command automatically adds maintainer script snippets for registering and unregistering the catalogs and supercatalogs (unless B<-n> is used). These snippets are inserted into the maintainer scripts and the B<triggers> file by B<dh_installdeb>; see L<dh_installdeb(1)> for an explanation of Debhelper maintainer script snippets.
pt: Este comando adiciona automaticamente fragmentos de script de maintainer para registar e remover o registo de catálogos e super-catálogos (a menos que B<-n> seja usado). Estes fragmentos são inseridos nos scripts de maintainer e o ficheiro B<triggers> pelo B<dh_installdeb>; veja L<dh_installdeb(1)> para uma explicação sobre fragmentos de script de maintainer do Debhelper.

note: type: textblock
en: A dependency on B<sgml-base> will be added to B<${misc:Depends}>, so be sure your package uses that variable in F<debian/control>.
pt: Será adicionada uma dependência em B<sgml-base> a B<${misc:Depends}>, portanto certifique-se que o seu pacote usa essa variável em F<debian/control>.

note: type: =item
en: debian/I<package>.sgmlcatalogs
pt: debian/I<pacote>.sgmlcatalogs

note: type: textblock
en: Lists the catalogs to be installed per package. Each line in that file should be of the form C<I<source> I<dest>>, where I<source> indicates where the catalog resides in the source tree, and I<dest> indicates the destination location for the catalog under the package build area. I<dest> should start with F</usr/share/sgml/>.
pt: Lista os catálogos a serem instalados por pacote. Cada linha nesse ficheiro deve ser do formato C<I<fonte> I<destino>>, onde I<fonte> indica onde o catálogo reside na árvore fonte, e I<destino> indica a localização de destino para o catálogo sob a área de compilação do pacote. <destino> deverá começar com F</usr/share/sgml/>.

note: type: textblock
en: Do not modify F<postinst>/F<postrm>/F<prerm> scripts nor add an activation trigger.
pt: Não modifique os scripts F<postinst>/F<postrm>/F<prerm> nem adicionem um trigger de activação.

note: type: textblock
en: Note that this command is not idempotent. L<dh_prep(1)> should be called between invocations of this command. Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.
pt: Note que este comando não é idempotente. O L<dh_prep(1)> deve ser chamado entre invocações deste comando. Caso contrário, pode causar múltiplas instâncias do mesmo texto a ser adicionado aos scripts do maintainer.

note: type: textblock
en: dh_installchangelogs - install changelogs into package build directories
pt: dh_installchangelogs - instala relatórios de alterações (changelogs) em directórios de compilação de pacotes.

note: type: textblock
en: B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] [B<--no-trim>] [I<upstream>]
pt: B<dh_installchangelogs> [S<I<debhelper opções>>] [B<-k>] [B<-X>I<item>] [B<--no-trim>] [I<upstream>]

note: type: textblock
en: B<dh_installchangelogs> is a debhelper program that is responsible for installing changelogs into package build directories.
pt: B<dh_installchangelogs> é um programa debhelper que é responsável por instalar relatórios de alterações (changelogs) nos directórios de compilação de pacotes.

note: type: textblock
en: An upstream F<changelog> file may be specified as an option. If none is specified, B<dh_installchangelogs> may look for files with names that seem likely to be changelogs as described in the next paragraphs.
pt: Pode ser especificado como uma opção um ficheiro F<changelog> do autor original (upstream) Se nenhum for especificado, B<dh_installchangelogs> pode procurar por ficheiros cujos nomes apontam provavelmente para relatórios de alterações como descrito nos próximos parágrafos.

note: type: textblock
en: In non-native packages, B<dh_installchangelogs> will first look for changelog files installed by the upstream build system into F<< usr/share/doc/I<package> >> (of the package build directory) and rename the most likely candidate (if any) to F<< usr/share/doc/I<package>/changelog >>.  Note that B<dh_installchangelogs> does I<not> look into any source directory (such as F<debian/tmp>). Otherwise, B<dh_installchangelogs> (at compatibility level 7 or any later) will look for changelog files in the source directory (e.g. the root or the F<docs> subdirectory).  It will look for F<changelog>, F<changes> and F<history> optionally with common extensions (such as F<.txt>, F<.md> and F<.rst>).
pt: Em pacotes não-nativos, o B<dh_installchangelogs> irá primeiro procurar por ficheiros changelog instalados pelo sistema de compilação do autor em F<< usr/share/doc/I<package> >> (do directório de compilação do pacote) e renomear o melhor candidato (se existir algum) para F<< usr/share/doc/I<pacote>/changelog >>. Note que B<dh_installchangelogs> I<não> procura nenhum directório fonte (tal como F<debian/tmp>). Caso contrário, B<dh_installchangelogs> (no nível de compatibilidade 7 ou posterior) irá procurar por ficheiros changelog no directório fonte (ex. a raiz do sub-directório F<docs>). Irá procurar por F<changelog>, F<changes> e F<history> opcionalmente com extensões comuns (tais como F<.txt>, F<.md> e F<.rst>).

note: type: textblock
en: If a changelog file is specified and is an F<html> file (determined by file extension), it will be installed as F<usr/share/doc/package/changelog.html> instead. If the html changelog is converted to plain text, that variant can be specified as a second parameter. When no plain text variant is specified, a short F<usr/share/doc/package/changelog> is generated, pointing readers at the html changelog file.
pt: Se um ficheiro changelog for especificado e se for um ficheiro F<html> (determinado pela extensão do ficheiro), em vez disso será instalado como F<usr/share/doc/package/changelog.html>. Se o relatório html for convertido para texto simples, essa variante pode ser especificada como um segundo parâmetro. Quando nenhuma variante de texto simples é especificada, é gerado um curto F<usr/share/doc/package/changelog>, apontando os leitores para o ficheiro de relatório em html.

note: type: textblock
en: The B<debchange>-style Debian changelogs are trimmed to include only entries more recent than the release date of I<oldstable>.  No trimming will be performed if the B<--no-trim> option is passed or if the B<DEB_BUILD_OPTIONS> environment variable contains B<notrimdch>.
pt: Os registos de alterações Debian estilo-B<debchange> são cortados para incluir apenas entradas mais recentes que a data de lançamento de I<oldstable>.  Nenhum corte será executado se a opção B<--no-trim> for passada ou se a variável de ambiente B<DEB_BUILD_OPTIONS> conter B<notrimdch>.

note: type: =item
en: debian/I<package>.changelog
pt: debian/I<pacote>.changelog

note: type: =item
en: debian/I<package>.NEWS
pt: debian/I<pacote>.NEWS

note: type: textblock
en: Automatically installed into usr/share/doc/I<package>/ in the package build directory.
pt: Instalado automaticamente em usr/share/doc/I<pacote>/ no directório de compilação do pacote.

note: type: textblock
en: Use the package specific name if I<package> needs a different F<NEWS> or F<changelog> file.
pt: Usa o nome específico do pacote se o I<pacote> precisar de um ficheiro F<NEWS> ou F<changelog> diferente.

note: type: textblock
en: The F<changelog> file is installed with a name of changelog for native packages, and F<changelog.Debian> for non-native packages.  The F<NEWS> file is always installed with a name of F<NEWS.Debian>.
pt: O ficheiro F<changelog> é instalado com o nome changelog para os pacotes nativos, e F<changelog.Debian> para pacotes não-nativos. O ficheiro de F<NOTICIAS> é sempre instalado com o nome F<NEWS.Debian>.

note: type: textblock
en: Keep the original name of the upstream changelog. This will be accomplished by installing the upstream changelog as F<changelog>, and making a symlink from that to the original name of the F<changelog> file. This can be useful if the upstream changelog has an unusual name, or if other documentation in the package refers to the F<changelog> file.
pt: Mantêm o nome original do registo de alterações do autor. Isto será conseguido ao instalar o registo de alterações do autor como F<changelog>, e criando um link simbólico daí para o nome original do ficheiro F<changelog>. Isto pode ser útil se o registo de alterações do autor tiver um nome fora do usual, ou se outra documentação no pacote faça referência ao ficheiro F<changelog>.

note: type: textblock
en: Exclude upstream F<changelog> files that contain I<item> anywhere in their filename from being installed.
pt: Exclui ficheiros F<changelog> do autor que contenham I<item> em qualquer ponto do seu nome de ficheiro, de serem instalados.

note: type: textblock
en: Note that directory name of the changelog is also part of the match.
pt: Note que o nome de directório do changelog é também parte correspondente.

note: type: textblock
en: Install the full changelog, not its trimmed version that includes only recent entries.
pt: Instala o registo de alterações completo, não a sua versão cortada que só inclui as entradas recentes.

note: type: textblock
en: Install this file as the upstream changelog.
pt: Instala este ficheiro como o registo de alterações (changelog) da origem.

note: type: textblock
en: dh_installcron - install cron scripts into etc/cron.*
pt: dh_installcron - instala scripts do cron em etc/cron.*

note: type: textblock
en: B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]
pt: B<dh_installcron> [S<B<debhelper opções>>] [B<--name=>I<nome>]

note: type: textblock
en: B<dh_installcron> is a debhelper program that is responsible for installing cron scripts.
pt: B<dh_installcron> é um programa debhelper que é responsável por instalar scripts do cron.

note: type: =item
en: debian/I<package>.cron.daily
pt: debian/I<pacote>.cron.daily

note: type: =item
en: debian/I<package>.cron.weekly
pt: debian/I<pacote>.cron.weekly

note: type: =item
en: debian/I<package>.cron.monthly
pt: debian/I<pacote>.cron.monthly

note: type: =item
en: debian/I<package>.cron.yearly
pt: debian/I<pacote>.cron.yearly

note: type: =item
en: debian/I<package>.cron.hourly
pt: debian/I<pacote>.cron.hourly

note: type: =item
en: debian/I<package>.cron.d
pt: debian/I<pacote>.cron.d

note: type: textblock
en: Installed into the appropriate F<etc/cron.*/> directory in the package build directory.
pt: Instalado no directório F<etc/cron.*/> apropriado no directório de compilação do pacote.

note: type: =item
en: B<--name=>I<name>
pt: B<--name=>I<nome>

note: type: textblock
en: Look for files named F<debian/package.name.cron.*> and install them as F<etc/cron.*/name>, instead of using the usual files and installing them as the package name.
pt: Procura ficheiros chamados F<debian/package.name.cron.*> e instala-os como F<etc/cron.*/name>, em vez de usar os ficheiros habituais e instala-los como o nome do pacote.

note: type: textblock
en: dh_installdeb - install files into the DEBIAN directory
pt: dh_installdeb - instala ficheiros no directório DEBIAN

note: type: textblock
en: B<dh_installdeb> [S<I<debhelper options>>]
pt: B<dh_installdeb> [S<I<debhelper opções>>]

note: type: textblock
en: B<dh_installdeb> is a debhelper program that is responsible for installing files into the F<DEBIAN> directories in package build directories with the correct permissions.
pt: B<dh_installdeb> é um programa debhelper que é responsável por instalar ficheiros nos directórios F<DEBIAN> nos directórios de compilação de pacotes com as permissões correctas.

note: type: =item
en: I<package>.postinst
pt: I<pacote>.postinst

note: type: =item
en: I<package>.preinst
pt: I<pacote>.preinst

note: type: =item
en: I<package>.postrm
pt: I<pacote>.postrm

note: type: =item
en: I<package>.prerm
pt: I<pacote>.prerm

note: type: textblock
en: These maintainer scripts are installed into the F<DEBIAN> directory.
pt: Estes scripts de maintainer são instalados no directório F<DEBIAN>.

note: type: textblock
en: B<dh_installdeb> will perform substitution of known tokens of the pattern B<#TOKEN#>.  In generally, scripts will want to include the B<#DEBHELPER#> to benefit from the shell scripts generated by debhelper commands (including those from B<dh_installdeb> when it processes I<package>.maintscript files).
pt: B<dh_installdeb> irá executar a substituição de tokens conhecidos do padrão B<#TOKEN#>.  Em geral, os scripts irão querer incluir o B<#DEBHELPER#> para beneficiar dos scripts de shell gerados pelos comandos debhelper (incluindo  commands (including aqueles de B<dh_installdeb> quando processa ficheiros I<package>.maintscript).

note: type: textblock
en: The B<#DEBHELPER#> token should be placed on its own line as it is often replaced by a multi-line shell script.
pt: O token B<#DEBHELPER#> deve ser colocado na sua linha própria pois é muitas vezes substituído por um script de shell de multi-linhas.

note: type: =item
en: I<package>.triggers
pt: I<pacote>.triggers

note: type: =item
en: I<package>.shlibs
pt: I<pacote>.shlibs

note: type: textblock
en: These control files are installed into the F<DEBIAN> directory.
pt: Estes ficheiros de controle são instalados no directório F<DEBIAN>.

note: type: textblock
en: Note that I<package>.shlibs is only installed in compat level 9 and earlier.  In compat 10, please use L<dh_makeshlibs(1)>.
pt: Note que o I<pacote>.shlibs é apenas instalado em nível de compatibilidade 9 e anteriores. Em compatibilidade 10, use L<dh_makeshlibs(1)>.

note: type: =item
en: I<package>.conffiles
pt: I<pacote>.conffiles

note: type: textblock
en: This file will be installed into the F<DEBIAN> directory. The provided file will be enriched by debhelper to include all the B<conffiles> auto-detected by debhelper (the maintainer should not list anything there as debhelper assumes it should handle that part).
pt: este ficheiro será instalado no directório F<DEBIAN>. O ficheiro fornecido será enriquecido pelo debhelper para incluir todos os B<conffiles> auto-detetados pelo debhelper (o responsável deve estar listado lá pois o debhelper assume que deve lidar com essa parte.)

note: type: textblock
en: This file is primarily useful for using "special" entries such as the B<< remove-on-upgrade >> feature from dpkg.
pt: Este ficheiro é principalmente útil para usar entradas "especiais" tais como a funcionalidade B<< remove-on-upgrade >> do dpkg.

note: type: =item
en: I<package>.maintscript
pt: I<pacote>.maintscript

note: type: textblock
en: Lines in this file correspond to L<dpkg-maintscript-helper(1)> commands and parameters.  However, the "maint-script-parameters" should I<not> be included as debhelper will add those automatically.
pt: As linhas neste ficheiro correspondem a comandos e parâmetros de L<dpkg-maintscript-helper(1)>. No entanto, os "maint-script-parameters" I<não> devem ser incluídos pois o debhelper irá adicionar esses automaticamente.

note: type: textblock
en: Example:
pt: Exemplo:

note: type: textblock
en: In compat 10 or later, any shell metacharacters will be escaped, so arbitrary shell code cannot be inserted here.  For example, a line such as C<mv_conffile /etc/oldconffile /etc/newconffile> will insert maintainer script snippets into all maintainer scripts sufficient to move that conffile.
pt: No nível de compatibilidade 10 ou posterior, quaisquer meta-caracteres de shell serão "escapados" então não se pode inserir aqui código arbitrário de shell. Por exemplo, uma linha como C<mv_conffile /etc/oldconffile /etc/newconffile> irá inserir fragmentos de script de maintainer em todos os scripts de maintainer suficientes para mover esse ficheiro de configuração.

note: type: textblock
en: It was also the intention to escape shell metacharacters in previous compat levels.  However, it did not work properly and as such it was possible to embed arbitrary shell code in earlier compat levels.
pt: Foi também intenção de fazer escape de shell a meta-caracteres nos níveis de compatibilidade anteriores. No entanto, não funcionava correctamente e como tal era possível embeber código de shell arbitrário nos níveis de compatibilidade anteriores.

note: type: textblock
en: The B<dh_installdeb> tool will do some basic validation of some of the commands listed in this file to catch common mistakes.  The validation is enabled as a warning since compat 10 and as a hard error in compat 12.
pt: A ferramenta B<dh_installdeb> irá fazer alguma validação básica a alguns dos comandos listados neste ficheiro para apanhar enganos comuns. A validação é activada como um aviso desde compatibilidade 10 e como um erro a resolver na compatibilidade 12.

note: type: textblock
en: Where possible, B<dh_installdeb> may choose to rewrite some or all of the entries into equivalent features supported in dpkg without relying on maintainer scripts at its sole discretion (examples include rewriting B<rm_conffile> into dpkg's B<remove-on-upgrade>).  The minimum requirement for activating this feature is that debhelper runs in compat 10 or later.
pt: Onde possível, o B<dh_installdeb> pode escolher rescrever algumas ou todas as entradas em funcionalidades equivalentes suportadas no dpkg sem se apoiar nos scripts do maintainer scripts  a seu exclusivo critério (exemplos incluem rescrever B<rm_conffile> em B<remove-on-upgrade> do dpkg). O requerimento mínimo para activar esta funcionalidade é que o debhelper corra  em compatibilidade 10 ou posterior.

note: type: textblock
en: Define tokens to be replaced inside the maintainer scripts when it is generated.  Please note that the limitations described in L</Limitations in token names> also applies to tokens defined on the command line.  Invalid token names will trigger an error.
pt: Define tokens a serem substituídos dentro dos scripts do maintainer quando são gerados. Por favor note as limitações descritas em L</Limitações nos nomes dos tokens> também se aplicam a tokens definidos na linha de comandos. Nomes de tokens inválidos irão despoletar um erro.

note: type: textblock
en: In the simple case, this parameter will cause B<< #I<TOKEN># >> to be replaced by I<VALUE>.  If I<VALUE> starts with a literal I<@>-sign, then I<VALUE> is expected to point to a file containing the actual value to insert.
pt: No caso simples, este parâmetro irá causar com que B<< #I<TOKEN># >> seja substituído por I<VALUE>. Se I<VALUE> começar com um I<@>-sign literal, então espera-se que I<VALUE> aponte para um ficheiro que contém o valor real a inserir.

note: type: textblock
en: An explicit declared token with this parameter will replace built-in tokens.
pt: Um token declarado explicitamente com este parâmetro irá substituir tokens embutidos.

note: type: textblock
en: Test examples to aid with the understanding:
pt: Exemplos de testes para ajuda na compreensão:

note: type: textblock
en: In this example, B<#SIMPLE#> will expand to B<direct> and B<#FILEBASED#> will expand to B<Complex value>.
pt: Neste exemplo, B<#SIMPLE#> irá expandir para B<direct> e B<#FILEBASED#> irá expandir para B<Complex value>.

note: type: textblock
en: It is also possible to set package-specific values for a given token.  This is useful when B<dh_installdeb> is acting on multiple packages that need different values for the same token.  This is done by prefixing the token name with B<< pkg.I<package-name>. >>.
pt: É também possível definir valores específicos-de-pacote para um dado token. Isto é útil quando B<dh_installdeb> está a actuar em múltiplos pacotes que precisam de valores diferentes para o mesmo token. Isto é feito ao prefixar o nome do token com B<< pkg.I<nome-do-pacote>. >>.

note: type: textblock
en: This can be used as in the following example:
pt: Isto pode ser usado como no exemplo seguinte:

note: type: textblock
en: In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo.postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and to B<unique-baz-value> in F<debian/baz.postinst>.
pt: Neste exemplo, B<#TOKEN#> irá expandir para B<default> em F<debian/foo.postinst>, para B<unique-bar-value> em F<debian/bar.postinst> e para B<unique-baz-value> em F<debian/baz.postinst>.

note: type: textblock
en: Note that the B<#pkg.*#> tokens will be visible in all scripts acted on.  E.g.  you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> and it will be replaced by B<unique-bar-value>.
pt: Note que os tokens B<#pkg.*#> irão ser visíveis em todos os scripts que actuem. Ex, você pode referir a B<#pkg.bar.TOKEN#> dentro de F<debian/foo.postinst> e ele será substituído por B<unique-bar-value>.

note: type: =head1
en: SUBSTITUTION IN MAINTAINER SCRIPTS
pt: SUBSTITUIÇÃO EM SCRIPTS DE MAINTAINER

note: type: textblock
en: The B<dh_installdeb> will automatically replace the following tokens inside a provided maintainer script (if not replaced via B<-D>/B<--define>):
pt: O B<dh_installdeb> irá substituir automaticamente os seguintes tokens dentro de um script disponibilizado pelo maintainer (se não for substituído via B<-D>/B<--define>):

note: type: textblock
en: This token is by default replaced with generated shell snippets debhelper commands.  This includes the snippets generated by B<dh_installdeb> from I<package>.maintscript file (if present).
pt: Este token é por predefinição substituído por excertos de shell de comandos debhelper gerados. Isto inclui os excertos gerados pelo B<dh_installdeb> a partir do ficheiro I<package>.maintscript (se presente).

note: type: textblock
en: These tokens are replaced with the respective variable from L<dpkg-architecture(1)>.  In almost all cases, you will want use the B<< #DEB_HOST_I<NAME> >> variant in a script to ensure you get the right value when cross-building.
pt: Estes tokens são substituídos pela variável respectiva a partir de L<dpkg-architecture(1)>.  Em quase todos os casos, você vai querer usar a variante B<< #DEB_HOST_I<NAME> >> num script para assegurar que obtêm o valor correcto quando faz compilação cruzada.

note: type: textblock
en: On a best effort, tokens of this pattern that do not match a variable in L<dpkg-architecture(1)> will be left as-is.
pt: Na melhor das hipóteses, tokens deste padrão que não correspondam a uma variável em L<dpkg-architecture(1)> serão deixados como estão.

note: type: textblock
en: These tokens of this form will be replaced with value of the corresponding environment variable.  If the environment variable is unset, the token is replaced with the empty string.
pt: Estes tokens deste formato serão substituídos pelo valor da variável de ambiente correspondente. Se a variável de ambiente não estiver definida, o token é substituído pela string vazia.

note: type: textblock
en: Note that there are limits on which names can be used (see L</Limitations in token names>).
pt: Note que existem limites em quais nomes podem ser usados (veja L</Limitações nos nomes dos token>).

note: type: textblock
en: This token is by default replaced by the package name, which will contain the concrete script.
pt: Este token é por predefinição substituído pelo nome do pacote, o qual irá conter o script concreto.

note: type: =head2
en: Limitations in token names
pt: Limitações nos nomes dos token

note: type: textblock
en: All tokens intended to be substituted must match the regex: #[A-Za-z0-9_.+]+#
pt: Todos os tokens que se destinam a ser substituídos têm de corresponder ao regex: #[A-Za-z0-9_.+]+#

note: type: textblock
en: Tokens that do not match that regex will be silently ignored if found in the script template.  Invalid token names passed to B<-D> or B<--define> will cause B<dh_installdeb> to reject the command with an error in most cases.
pt: Tokens que não correspondam a esse regex serão ignorados em silêncio se encontrados no script modelo. Nomes de token inválidos passados a B<-D> ou B<--define> irão causar que o B<dh_installdeb> rejeite o comando com um erro na maioria dos casos.

note: type: textblock
en: dh_installdebconf - install files used by debconf in package build directories
pt: dh_installdebconf - instala ficheiros usados pelo debconf nos directórios de compilação de pacotes

note: type: textblock
en: B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]
pt: B<dh_installdebconf> [S<I<debhelper opções>>] [B<-n>] [S<B<--> I<params>>]

note: type: textblock
en: B<dh_installdebconf> is a debhelper program that is responsible for installing files used by debconf into package build directories.
pt: B<dh_installdebconf> é um programa debhelper que é responsável por instalar ficheiros usados pelo debconf em directórios de compilação de pacotes.

note: type: textblock
en: It also automatically generates the F<postrm> commands needed to interface with debconf. The commands are added to the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how that works.
pt: Também gera automaticamente os comandos F<postrm> necessários para a interface com o debconf. Os comandos são adicionados aos scripts do maintainer pelo B<dh_installdeb>. Veja L<dh_installdeb(1)> para uma explicação de como isso funciona.

note: type: textblock
en: Note that if you use debconf, your package probably needs to depend on it (it will be added to B<${misc:Depends}> by this program).
pt: Note que se você usar debconf, provavelmente o seu pacote precisa de depender disso (será adicionado a B<${misc:Depends}> por este programa).

note: type: textblock
en: Note that for your config script to be called by B<dpkg>, your F<postinst> needs to source debconf's confmodule. B<dh_installdebconf> does not install this statement into the F<postinst> automatically as it is too hard to do it right.
pt: Note que para o seu script de configuração ser chamado pelo <dpkg>, o seu F<postinst> precisa de partir do módulo de configuração do debconf, o B<dh_installdebconf> não instala esta declaração no F<postinst> automaticamente porque é muito difícil de o fazer correctamente.

note: type: =item
en: debian/I<package>.config
pt: debian/I<pacote>.config

note: type: textblock
en: This is the debconf F<config> script, and is installed into the F<DEBIAN> directory in the package build directory.
pt: Este é o script F<config> de debconf, e é instalado no directório F<DEBIAN> no directório de compilação do pacote.

note: type: textblock
en: Inside the script, the token B<#DEBHELPER#> is replaced with shell script snippets generated by other debhelper commands.
pt: Dentro do script, o token B<#DEBHELPER#> é substituído por fragmentos de script shell gerados por outros comandos do debhelper.

note: type: =item
en: debian/I<package>.templates
pt: debian/I<pacote>.templates

note: type: textblock
en: This is the debconf F<templates> file, and is installed into the F<DEBIAN> directory in the package build directory.
pt: Este é o ficheiro F<templates> de debconf, e é instalado no directório F<DEBIAN> no directório de compilação do pacote.

note: type: textblock
en: If this directory is present, this program will automatically use L<po2debconf(1)> to generate merged templates files that include the translations from there.
pt: Se este directório estiver presente, este programa irá usar automaticamente o L<po2debconf(1)> para gerar ficheiros de modelos fundidos que incluem as traduções de lá.

note: type: textblock
en: For this to work, your package should build-depend on F<po-debconf>.
pt: Para que isto funcione, o seu pacote deve compilar dependendo de F<po-debconf>.

note: type: textblock
en: Do not modify F<postrm> script.
pt: Não modifique o script F<postrm>.

note: type: textblock
en: Pass the params to B<po2debconf>.
pt: Passa os params para B<po2debconf>.

note: type: textblock
en: It is also possible to set package-specific values for a given token.  This is useful when B<dh_installdebconf> is acting on multiple packages that need different values for the same token.  This is done by prefixing the token name with B<< pkg.I<package-name>. >>.
pt: É também possível definir valores específicos-de-pacote para um dado token. Isto é útil quando B<dh_installdebconf> está a actuar em múltiplos pacotes que precisam de valores diferentes para o mesmo token. Isto é feito ao prefixar o nome do token com B<< pkg.I<nome-do-pacote>. >>.

note: type: textblock
en: In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo.config>, to B<unique-bar-value> in F<debian/bar.config> and to B<unique-baz-value> in F<debian/baz.config>.
pt: Neste exemplo, B<#TOKEN#> irá expandir para B<default> em F<debian/foo.config>, para B<unique-bar-value> em F<debian/bar.config> e para B<unique-baz-value> em F<debian/baz.config>.

note: type: textblock
en: Note that the B<#pkg.*#> tokens will be visible in all scripts acted on.  E.g.  you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.config> and it will be replaced by B<unique-bar-value>.
pt: Note que os tokens B<#pkg.*#> irão ser visíveis em todos os scripts que actuem. Ex, você pode referir a B<#pkg.bar.TOKEN#> dentro de F<debian/foo.config> e ele será substituído por B<unique-bar-value>.

note: type: textblock
en: The B<dh_installdebconf> will automatically replace the following tokens inside a provided maintainer script (if not replaced via B<-D>/B<--define>):
pt: O B<dh_installdebconf> irá substituir automaticamente os seguintes tokens dentro de um script disponibilizado pelo maintainer (se não for substituído via B<-D>/B<--define>):

note: type: textblock
en: Tokens that do not match that regex will be silently ignored if found in the script template.  Invalid token names passed to B<-D> or B<--define> will cause B<dh_installdebconf> to reject the command with an error in most cases.
pt: Tokens que não correspondam a esse regex serão ignorados em silêncio se encontrados no script modelo. Nomes de token inválidos passados a B<-D> ou B<--define> irão causar que o B<dh_installdebconf> rejeite o comando com um erro na maioria dos casos.

note: type: textblock
en: dh_installdirs - create subdirectories in package build directories
pt: dh_installdirs - cria sub-directórios nos directórios de compilação de pacotes

note: type: textblock
en: B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [B<--sourcedir=>I<dir>] [B<--create-in-sourcedir>] [S<I<dir> ...>]
pt: B<dh_installdirs> [S<I<debhelper opções>>] [B<-A>] [B<--sourcedir=>I<dir>] [B<--create-in-sourcedir>] [S<I<dir> ...>]

note: type: textblock
en: B<dh_installdirs> is a debhelper program that is responsible for creating subdirectories in package build directories.
pt: B<dh_installdirs> é um programa debhelper que é responsável por criar sub-directórios nos directórios de compilação de pacotes.

note: type: textblock
en: Many packages can get away with omitting the call to B<dh_installdirs> completely.  Notably, other B<dh_*> commands are expected to create directories as needed.
pt: Muitos pacotes conseguem omitir completamente a chamada a B<dh_installdirs>. De notar, é de esperar que outros comandos B<dh_*> criem directórios quando é necessário.

note: type: =item
en: debian/I<package>.dirs
pt: debian/I<pacote>.dirs

note: type: textblock
en: Lists directories to be created in I<package>.
pt: Lista directórios a serem criados em I<pacote>.

note: type: textblock
en: Generally, there is no need to list directories created by the upstream build system or directories needed by other B<debhelper> commands.
pt: Geralmente, não há necessidade de listar os directórios criados pelo sistema de compilação do autor ou os directórios necessários por outros comandos B<debhelper>.

note: type: textblock
en: Create any directories specified by command line parameters in ALL packages acted on, not just the first.
pt: Cria quaisquer directórios especificados por parâmetros de linha de comandos em TODOS os pacotes em que actua, e não apenas no primeiro.

note: type: textblock
en: Whether to create the specified directories in the source directory (usually F<debian/tmp>) I<in addition to> in the package build directory (usually F<< debian/I<package> >>).
pt: Ou para criar os directórios especificados no directório fonte (geralmente F<debian/tmp>) I<em adição para> no directório de compilação do pacote (geralmente F<< debian/I<package> >>).

note: type: textblock
en: The default is B<--no-create-in-sourcedir>.
pt: A predefinição é B<--no-create-in-sourcedir>.

note: type: textblock
en: Consider I<dir> the source directory for the packages acted on instead of the default (which is usually F<debian/tmp>).
pt: Considera I<dir> o directório fonte para os pacotes em actuação em vez da predefinição (que geralmente é F<debian/tmp>).

note: type: textblock
en: Please note that this option is dependent on the B<--create-in-sourcedir> option (when B<--no-create-in-sourcedir> is in effect, this option does nothing in B<dh_installdirs>).
pt: Por favor note que esta opção é dependente da opção B<--create-in-sourcedir> (quando B<--no-create-in-sourcedir> está em efeito, esta opção não faz nada em B<dh_installdirs>).

note: type: textblock
en: Create these directories in the package build directory of the first package acted on. (Or in all packages if B<-A> is specified.)
pt: Cria estes directórios no directório de compilação do pacote do primeiro pacote em que actua. (Ou em todos os pacotes se for especificado B<-A>.)

note: type: textblock
en: dh_installdocs - install documentation into package build directories
pt: dh_installdocs - instala documentação em directórios de compilação de pacotes

note: type: textblock
en: B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<file> ...>]
pt: B<dh_installdocs> [S<I<debhelper opções>>] [B<-A>] [B<-X>I<item>] [S<I<ficheiro> ...>]

note: type: textblock
en: B<dh_installdocs> is a debhelper program that is responsible for installing documentation into F<usr/share/doc/package> in package build directories.
pt: B<dh_installdocs> é um programa debhelper que é responsável por instalar documentação em F<usr/share/doc/package> nos directórios de compilação de pacotes.

note: type: textblock
en: In compat 10 and earlier, L<dh_install(1)> may be a better tool for handling the upstream documentation, when upstream's own build system installs all the desired documentation correctly.  In this case, B<dh_installdocs> is still useful for installing packaging related documentation (e.g. the F<debian/copyright> file).
pt: Em compatibilidade 10 e anterior, L<dh_install(1)> pode ser a melhor ferramenta para lidar com a documentação do autor, quando o sistema de compilação próprio do autor instala toda a documentação desejada correctamente Neste caso, o B<dh_installdocs> ainda é útil para instalar documentação relacionada com o empacotamento (ex. o ficheiro F<debian/copyright>).

note: type: textblock
en: From debhelper compatibility level 11 on, B<dh_install> will fall back to looking in F<debian/tmp> for files, if it does not find them in the current directory (or wherever you've told it to look using B<--sourcedir>).
pt: Desde nível de compatibilidade 11 do debhelper em diante, o B<dh_install> irá procurar os ficheiros em F<debian/tmp>, se não os encontrar no directório actual (ou onde você o mandou procurar usando B<--sourcedir>).

note: type: textblock
en: In compat 11 and later, B<dh_installdocs> offers many of the features that L<dh_install(1)> also has.  Furthermore, B<dh_installdocs> also supports the B<nodoc> build profile to exclude documentation (regardless of compat level).
pt: Em compatibilidade 11 e posterior, B<dh_installdocs> oferece muitas das características que o L<dh_install(1)> também tem. Mais ainda, o B<dh_installdocs> também suporta o perfil de compilação B<nodoc> para excluir documentação (independentemente do nível de compatibilidade).

note: type: =item
en: debian/I<package>.docs
pt: debian/I<pacote>.docs

note: type: textblock
en: List documentation files to be installed into I<package>.
pt: Lista os ficheiros de documentação a serem instalados em I<pacote>.

note: type: textblock
en: The copyright file is installed into all packages, unless a more specific copyright file is available.
pt: O ficheiro de copyright é instalado em todos os pacotes, a menos que esteja disponível um ficheiro de copyright mais específico.

note: type: =item
en: debian/I<package>.copyright
pt: debian/I<pacote>.copyright

note: type: =item
en: debian/I<package>.README.Debian
pt: debian/I<pacote>.README.Debian

note: type: =item
en: debian/I<package>.TODO
pt: debian/I<pacote>.TODO

note: type: textblock
en: Each of these files is automatically installed if present for a I<package>.
pt: Cada um destes ficheiros são instalados automaticamente se presentes para um I<pacote>.

note: type: textblock
en: These files are installed into the first binary package listed in debian/control.
pt: Estes ficheiros são instalados no primeiro pacote binário listado em debian/control.

note: type: textblock
en: Note that F<README.debian> files are also installed as F<README.Debian>, and F<TODO> files will be installed as F<TODO.Debian> in non-native packages.
pt: Note que os ficheiros F<README.debian> são também instalados como F<README.Debian>, e os ficheiro F<TODO> serão instalados como F<TODO.Debian> em pacotes não nativos.

note: type: =item
en: debian/I<package>.doc-base
pt: debian/I<pacote>.doc-base

note: type: textblock
en: Installed as doc-base control files. Note that the doc-id will be determined from the B<Document:> entry in the doc-base control file in question. In the event that multiple doc-base files in a single source package share the same doc-id, they will be installed to usr/share/doc-base/package instead of usr/share/doc-base/doc-id.
pt: instalado como ficheiros de controle doc-base. Note que o doc-id será determinado a partir da entrada B<Document:> no ficheiro de controle de doc-base em questão. Na eventualidade de múltiplos ficheiros doc-base num pacote fonte partilharem o mesmo doc-id, eles serão instalados em usr/share/doc-base/package em vez de usr/share/doc-base/doc-id.

note: type: =item
en: debian/I<package>.doc-base.*
pt: debian/I<pacote>.doc-base.*

note: type: textblock
en: If your package needs to register more than one document, you need multiple doc-base files, and can name them like this. In the event that multiple doc-base files of this style in a single source package share the same doc-id, they will be installed to usr/share/doc-base/package-* instead of usr/share/doc-base/doc-id.
pt: Se o seu pacote precisa de registar mais do que um documento, você precisa de vários ficheiros baseados em doc, e pode-os nomear desta maneira. Na eventualidade de vários ficheiros baseados em doc deste estilo num único pacote fonte partilharem o mesmo doc-id, serão instalados em usr/share/doc-base/package-* em vez de usr/share/doc-base/doc-id.

note: type: textblock
en: Please be aware that this deduplication is currently done in memory only, so for now it requires B<dh_installdocs> to be called no more than once during the package build. Calling B<dh_installdocs -p>I<package> in combination with using F<debian/>I<package>F<.doc-base.*> files can lead to uninstallable packages. See L<https://bugs.debian.org/980903> for details.
pt: Por favor tenha atenção que esta de-duplicação é actualmente feita apenas em memória, assim por agora requer o B<dh_installdocs> seja chamado não mais do que uma vez durante a compilação do pacote. Chamar B<dh_installdocs -p>I<package> em combinação com o uso de ficheiros F<debian/>I<package>F<.doc-base.*> pode levar a pacotes não instaláveis. Veja L<https://bugs.debian.org/980903> para detalhes.

note: type: textblock
en: Install all files specified by command line parameters in ALL packages acted on.
pt: Instala todos os ficheiros especificados pelos parâmetros de linha de comandos em TODOS os pacotes em que actua.

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being installed. Note that this includes doc-base files.
pt: Exclui da instalação ficheiros que contenham I<item> em qualquer ponto do seu nome de ficheiro. Note que isto inclui ficheiros baseados em doc.

note: type: textblock
en: Look in the specified directory for files to be installed.  This option requires compat 11 or later (it is silently ignored in compat 10 or earlier).
pt: Procura no directório especificado por ficheiros para serem instalados. Esta opção requer compatibilidade 11 ou posterior (é ignorada em silêncio na compatibilidade 10 ou anterior).

note: type: textblock
en: Note that this is not the same as the B<--sourcedirectory> option used by the B<dh_auto_>I<*> commands. You rarely need to use this option, since B<dh_installman> automatically looks for files in F<debian/tmp> in debhelper compatibility level 11 and above.
pt: Note que isto não é o mesmo que a opção B<--sourcedirectory> usada pelos comandos B<dh_auto_>I<*>. Você raramente vai precisar de usar esta opção, pois o B<dh_installman> procura automaticamente por ficheiros em F<debian/tmp> no nível de compatibilidade 11 e superiores do debhelper.

note: type: textblock
en: Set the main package for a documentation package.  This is used to install the documentation of the documentation package in F<< /usr/share/doc/I<main-package> >> as recommended by the Debian policy manual 3.9.7 in §12.3.
pt: Define o pacote principal para pacote de documentação. Isto é usado para a documentação do pacote de documentação em F<< /usr/share/doc/I<main-package> >> como recomendado pelo manual de políticas Debian 3.9.7 em §12.3.

note: type: textblock
en: In compat 11 (or later), this option is only useful if debhelper's auto-detection of the main package is wrong.  The option can also be used to silence a warning from debhelper when the auto-detection fails but the default happens to be correct.
pt: Em compatibilidade 11 (ou posterior), esta opção apenas é útil se a auto-detecção do debhelper do pacote principal está errada. A opção também pode ser usada para silenciar um aviso do debhelper quando a auto-detecção falha mas acontece a predefinição estar correcta.

note: type: textblock
en: This option cannot be used when B<dh_installdocs> is instructed to act on multiple packages.  If you need this option, you will generally need to combine it with B<-p> to ensure exactly one package is acted on.
pt: Esta opção não pode ser usada quando o B<dh_installdocs> é instruído a actuar em múltiplos pacotes. Se precisar desta opção, você irá geralmente precisar de combina-la com B<-p> para assegurar exactamente que um pacote é actuado.

note: type: textblock
en: Please keep in mind that some documentation (the copyright file, README.Debian, etc.) will be unaffected by this option.
pt: Por favor tenha em mente que alguma documentação (o ficheiro de copyright, README.Debian, etc.) não serão afectados por esta opção.

note: type: =item
en: B<--link-doc=>I<package>
pt: B<--link-doc=>I<pacote>

note: type: textblock
en: Make the documentation directory of all packages acted on be a symlink to the documentation directory of I<package>. This has no effect when acting on I<package> itself, or if the documentation directory to be created already exists when B<dh_installdocs> is run. To comply with policy, I<package> must be a binary package that comes from the same source package.
pt: Faz com que o directório de documentação de todos os pacotes onde actua seja um link simbólico para o directório de documentação do I<pacote>. Isto não tem nenhum efeito quando se actual no próprio I<pacote>, ou se o directório de documentação a ser criado já existir quando o B<dh_installdocs> é executado. Para estar em conformidade com a política, o I<pacote> tem de ser um pacote binário que vem do mesmo pacote fonte.

note: type: textblock
en: debhelper will try to avoid installing files into linked documentation directories that would cause conflicts with the linked package. The B<-A> option will have no effect on packages with linked documentation directories, and F<copyright>, F<changelog>, F<README.Debian>, and F<TODO> files will not be installed.
pt: O debhelper irá tentar evitar instalar ficheiros em directórios de documentação vinculados que poderão causar conflitos com o pacote vinculado. A opção B<-A> não terá nenhum efeito em pacotes com directórios de documentação vinculados, e os ficheiros F<copyright>, F<changelog>, F<README.Debian>, e F<TODO> não serão instalados.

note: type: textblock
en: (An older method to accomplish the same thing, which is still supported, is to make the documentation directory of a package be a dangling symlink, before calling B<dh_installdocs>.)
pt: (Um outro método de consegui o mesmo, o qual ainda é suportado, é tornar o directório de documentação de um pacote num link simbólico pendente, antes de chamar o B<dh_installdocs>.)

note: type: textblock
en: Please note that this option only applies to the documentation directory for the package itself.  When the package ships documentation for another package (e.g. see B<--doc-main-package>), it will not use a symlink for the documentation of the other package.
pt: Por favor note que esta opção apenas é aplicada ao directório de documentação para o próprio pacote. Quando o pacote embarca documentação para outro pacote (ex. veja B<--doc-main-package>), não irá usar um link simbólico para a documentação do outro pacote.

note: type: textblock
en: B<CAVEAT 1>: If a previous version of the package was built without this option and is now built with it (or vice-versa), it requires a "dir to symlink" (or "symlink to dir") migration.  Since debhelper has no knowledge of previous versions, you have to enable this migration itself.
pt: B<CAVEAT 1>: Se uma versão anterior do pacote foi compilada sem esta opção e for agora compilada com ela (ou vice-versa), precisa de uma migração de dir para symlink" (ou de "symlink para dir"). Como o debhelper não tem conhecimento das versões anteriores, você terá que ser o próprio a activar esta migração.

note: type: textblock
en: This can be done by providing a "debian/I<package>.maintscript" file and using L<dh_installdeb(1)> to provide the relevant maintainer script snippets.
pt: Isto pode ser feito ao fornecer um ficheiro "debian/I<pacote>.maintscript" e usar o L<dh_installdeb(1)> para fornecer os fragmentos relevantes do script do maintainer.

note: type: textblock
en: B<CAVEAT 2>: The use of B<--link-doc> should only be done when the packages have same "architecture" type.  A link from an architecture independent package to an architecture dependent package (or vice versa) will not work.  Since compat 10, debhelper will actively reject unsupported combinations.
pt: B<CAVEAT 2>: O uso de B<--link-doc> apenas deve ser feito quando os pacotes têm o mesmo tipo de "arquitectura". Um link de um pacote independente de uma arquitectura para um pacote depende de uma arquitectura (ou vice-versa) não irá funcionar. Desde compatibilidade 10, o debhelper irá rejeitar activamente combinações não suportadas.

note: type: textblock
en: Install these files as documentation into the first package acted on. (Or in all packages if B<-A> is specified).
pt: Instala estes ficheiros como documentação no primeiro pacote em que se actua. (Ou em todos os pacotes se for especificado B<-A>).

note: type: textblock
en: This is an example of a F<debian/package.docs> file:
pt: Este é um exemplo de um ficheiro F<debian/package.docs>:

note: type: textblock
en: Note that B<dh_installdocs> will happily copy entire directory hierarchies if you ask it to (similar to B<cp -a>). If it is asked to install a directory, it will install the complete contents of the directory.
pt: Note que B<dh_installdocs> irá alegremente copiar as hierarquias completas dos directórios se você lhe pedir (semelhante a B<cp -a>). Se lhe for pedido para instalar um directório, irá instalar o conteúdo completo desse directório.

note: type: textblock
en: dh_installemacsen - register an Emacs add on package
pt: dh_installemacsen - regista uma adição Emacs no pacote

note: type: textblock
en: B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] [B<--flavor=>I<foo>]
pt: B<dh_installemacsen> [S<I<debhelper opções>>] [B<-n>] [B<--priority=>I<n>] [B<--flavor=>I<foo>]

note: type: textblock
en: B<dh_installemacsen> is a debhelper program that is responsible for installing files used by the Debian B<emacsen-common> package into package build directories.
pt: B<dh_installemacsen> é um programa debhelper que é responsável por instalar ficheiros usados pelo pacote Debian B<emacsen-common> em directórios de compilação de pacotes.

note: type: textblock
en: It also automatically generates the F<preinst> F<postinst> and F<prerm> commands needed to register a package as an Emacs add on package. The commands are added to the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how this works.
pt: Também gera automaticamente os comandos F<preinst> F<postinst> e F<prerm> necessários para registar um pacote como uma adição Emacs no pacote. Os comandos são adicionados ao script do maintainer pelo B<dh_installdeb>. Veja L<dh_installdeb(1)> para uma explicação de como isto funciona.

note: type: =item
en: debian/I<package>.emacsen-compat
pt: debian/I<pacote>.emacsen-compat

note: type: textblock
en: Installed into F<usr/lib/emacsen-common/packages/compat/package> in the package build directory.
pt: Instalado em F<usr/lib/emacsen-common/packages/compat/package> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.emacsen-install
pt: debian/I<pacote>.emacsen-install

note: type: textblock
en: Installed into F<usr/lib/emacsen-common/packages/install/package> in the package build directory.
pt: Instalado em F<usr/lib/emacsen-common/packages/install/package> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.emacsen-remove
pt: debian/I<pacote>.emacsen-remove

note: type: textblock
en: Installed into F<usr/lib/emacsen-common/packages/remove/package> in the package build directory.
pt: Instalado em F<usr/lib/emacsen-common/packages/remove/package> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.emacsen-startup
pt: debian/I<pacote>.emacsen-startup

note: type: textblock
en: Installed into etc/emacs/site-start.d/50I<package>.el in the package build directory. Use B<--priority> to use a different priority than 50.
pt: Instalado em etc/emacs/site-start.d/50I<pacote>.el no directório de compilação do pacote. Use B<--priority> para usar uma prioridade diferente de 50.

note: type: textblock
en: Do not modify F<postinst>/F<prerm> scripts.
pt: Não modifique os scripts F<postinst>/F<prerm>.

note: type: textblock
en: Sets the priority number of a F<site-start.d> file. Default is 50.
pt: Define o número de prioridade de um ficheiro F<site-start.d>. O valor predefinido é 50.

note: type: textblock
en: Sets the flavor a F<site-start.d> file will be installed in. Default is B<emacs>, alternatives include B<xemacs> and B<emacs20>.
pt: Define qual variante de ficheiro F<site-start.d> será instalado. A predefinição é B<emacs>, as alternativas incluem B<xemacs> e B<emacs20>.

note: type: textblock
en: dh_installexamples - install example files into package build directories
pt: dh_installexamples - instala ficheiros exemplo em directórios de compilação de pacotes

note: type: textblock
en: B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<file> ...>]
pt: B<dh_installexamples> [S<I<debhelper opções>>] [B<-A>] [B<-X>I<item>] [S<I<ficheiro> ...>]

note: type: textblock
en: B<dh_installexamples> is a debhelper program that is responsible for installing examples into F<usr/share/doc/package/examples> in package build directories.
pt: B<dh_installexamples> é um programa debhelper responsável por instalar exemplos em F<usr/share/doc/package/examples> nos directórios de compilação de pacotes.

note: type: =item
en: debian/I<package>.examples
pt: debian/I<pacote>.examples

note: type: textblock
en: Lists example files or directories to be installed.
pt: Lista ficheiros ou directórios exemplo para serem instalados.

note: type: textblock
en: If upstream provides an F<examples> directory, you will often want to use B<examples/*> rather than B<examples> in this file.  The latter would create F<< /usr/share/doc/I<package>/examples/examples >>, which is rarely what you want.
pt: Se o autor fornecer um directório F<examples>, você vai muitas vezes querer usar B<examples/*> em vez de B<examples> neste ficheiro. O posterior irá criar F<< /usr/share/doc/I<pacote>/examples/examples >>, o que raramente é o que você quer.

note: type: textblock
en: Install any files specified by command line parameters in ALL packages acted on.
pt: Instala quaisquer ficheiros especificados pelos parâmetros de linha de comandos em TODOS os pacotes em que actua.

note: type: textblock
en: Note that this is not the same as the B<--sourcedirectory> option used by the B<dh_auto_>I<*> commands. You rarely need to use this option, since B<dh_installexamples> automatically looks for files in F<debian/tmp> in debhelper compatibility level 11 and above.
pt: Note que isto não é o mesmo que a opção B<--sourcedirectory> usada pelos comandos B<dh_auto_>I<*>. Você raramente vai precisar de usar esta opção, pois o B<dh_installexamples> procura automaticamente por ficheiros em F<debian/tmp> no nível de compatibilidade 11 e superiores do debhelper.

note: type: textblock
en: This option cannot be used when B<dh_installexamples> is instructed to act on multiple packages.  If you need this option, you will generally need to combine it with B<-p> to ensure exactly one package is acted on.
pt: Esta opção não pode ser usada quando B<dh_installexamples> é instruído para actuar em múltiplos pacotes. Se precisar desta opção, você irá geralmente precisar de combina-la com B<-p> para assegurar exactamente que um pacote é actuado.

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being installed.
pt: Exclui de serem instalados ficheiros que tenham I<item> em qualquer ponto no seu nome de ficheiro.

note: type: textblock
en: Install these files (or directories) as examples into the first package acted on. (Or into all packages if B<-A> is specified.)
pt: Instala estes ficheiros (ou directórios) como exemplos no primeiro pacote em que actua. (Ou em todos os pacotes se for especificado B<-A>).

note: type: textblock
en: Note that B<dh_installexamples> will happily copy entire directory hierarchies if you ask it to (similar to B<cp -a>). If it is asked to install a directory, it will install the complete contents of the directory.
pt: Note que B<dh_installexamples> irá alegremente copiar as hierarquias de directórios inteiras se lho pedir (semelhante a B<cp -a>). Se lhe for pedido para instalar um directório, ele irá instalar o conteúdo completo do directório.

note: type: textblock
en: dh_installifupdown - install if-up and if-down hooks
pt: dh_installifupdown - instala os hooks if-up e if-down

note: type: textblock
en: B<dh_installifupdown> [S<I<debhelper options>>] [B<--name=>I<name>]
pt: B<dh_installifupdown> [S<I<debhelper opções>>] [B<--name=>I<nome>]

note: type: textblock
en: B<dh_installifupdown> is a debhelper program that is responsible for installing F<if-up>, F<if-down>, F<if-pre-up>, and F<if-post-down> hook scripts into package build directories.
pt: B<dh_installifupdown> é um programa debhelper que é responsável por instalar os scripts hook F<if-up>, F<if-down>, F<if-pre-up>, e F<if-post-down> em directórios de compilação de pacotes

note: type: =item
en: debian/I<package>.if-up
pt: debian/I<pacote>.if-up

note: type: =item
en: debian/I<package>.if-down
pt: debian/I<pacote>.if-down

note: type: =item
en: debian/I<package>.if-pre-up
pt: debian/I<pacote>.if-pre-up

note: type: =item
en: debian/I<package>.if-post-down
pt: debian/I<pacote>.if-post-down

note: type: textblock
en: These files are installed into etc/network/if-*.d/I<package> in the package build directory.
pt: este ficheiros são instalados em etc/network/if-*.d/I<pacote> no directório de compilação do pacote.

note: type: textblock
en: Look for files named F<debian/package.name.if-*> and install them as F<etc/network/if-*/name>, instead of using the usual files and installing them as the package name.
pt: Procura por ficheiros chamados F<debian/nome.pacote.if-*> e instala-os como F<etc/network/if-*/nome>, em vez de usar os ficheiros usuais e instala-los como o nome do pacote.

note: type: textblock
en: dh_installinfo - install info files
pt: dh_installinfo - instala ficheiros info

note: type: textblock
en: B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [S<I<file> ...>]
pt: B<dh_installinfo> [S<I<debhelper opções>>] [B<-A>] [S<I<ficheiro> ...>]

note: type: textblock
en: B<dh_installinfo> is a debhelper program that is responsible for installing info files into F<usr/share/info> in the package build directory.
pt: B<dh_installinfo> é um programa debhelper que é responsável por instalar ficheiros info em F<usr/share/info> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.info
pt: debian/I<pacote>.info

note: type: textblock
en: List info files to be installed.
pt: Lista ficheiros info a serem instalados.

note: type: textblock
en: Note that this is not the same as the B<--sourcedirectory> option used by the B<dh_auto_>I<*> commands. You rarely need to use this option, since B<dh_installinfo> automatically looks for files in F<debian/tmp> in debhelper compatibility level 11 and above.
pt: Note que isto não é o mesmo que a opção B<--sourcedirectory> usada pelos comandos B<dh_auto_>I<*>. Você raramente vai precisar de usar esta opção, pois o B<dh_installinfo> procura automaticamente por ficheiros em F<debian/tmp> no nível de compatibilidade 11 e superiores do debhelper.

note: type: textblock
en: Install these info files into the first package acted on. (Or in all packages if B<-A> is specified).
pt: Instala estes ficheiros info no primeiro pacote em que actua. (Ou em todos os pacotes se for especificado B<-A>).

note: type: textblock
en: dh_installinit - install service init files into package build directories
pt: dh_installinit - instala ficheiros de iniciação de serviços em directórios de compilação de pacotes

note: type: textblock
en: B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] [B<-R>] [B<-r>] [B<-d>] [S<B<--> I<params>>]
pt: B<dh_installinit> [S<I<debhelper opções>>] [B<--name=>I<nome>] [B<-n>] [B<-R>] [B<-r>] [B<-d>] [S<B<--> I<params>>]

note: type: textblock
en: B<dh_installinit> is a debhelper program that is responsible for installing init scripts with associated defaults files.  In compatibility levels up to and including 10, B<dh_installinit> will also install some systemd related files provided by the debian packaging (see the L</FILES> section below).  In compatibility levels up to and including 11, B<dh_installinit> will also handle upstart jobs provided in the debian packaging (see the L</FILES> for more information on this as well).
pt: B<dh_installinit> é um programa debhelper que é responsável por instalar scripts init com os ficheiros de predefinições associados. Em níveis de compatibilidade até, e incluindo, 10, B<dh_installinit> ira também instalar alguns ficheiros relacionados com o systemd fornecidos pelo empacotamento debian (veja a secção L</FICHEIROS> em baixo). Em níveis de compatibilidade até, e incluindo, 11, B<dh_installinit> irá também lidar com trabalhos de arranque fornecidos pelo empacotamento debian (veja L</FICHEIROS> para mais informação sobre isto também).

note: type: textblock
en: It also automatically generates the F<postinst> and F<postrm> and F<prerm> commands needed to set up the symlinks in F</etc/rc*.d/> to start and stop the init scripts.
pt: Também gera automaticamente os comandos F<postinst> e F<postrm> e F<prerm> necessários para definir os links simbólicos em F</etc/rc*.d/> para iniciar e parar os scripts init.

note: type: textblock
en: In compat 10 or earlier: If a package only ships a systemd service file and no sysvinit script is provided, you may want to exclude the call to dh_installinit for that package (e.g. via B<-N>).  Otherwise, you may get warnings from lintian about init.d scripts not being included in the package.
pt: Em compatibilidade 10 ou anterior: Se um pacote apenas embarcar um ficheiro de serviço do systemd e não for disponibilizado nenhum script de sysvinit, você pode querer excluir a chamada ao dh_installinit para esse pacote (ex. via B<-N>). Caso contrário, você pode obter avisos do lintian acerca de scripts init.d a não serem incluídos no pacote.

note: type: =item
en: debian/I<package>.init
pt: debian/I<pacote>.init

note: type: textblock
en: If this exists, it is installed into etc/init.d/I<package> in the package build directory.
pt: Se isto existir, é instalado em etc/init.d/I<pacote> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.default
pt: debian/I<pacote>.default

note: type: textblock
en: If this exists, it is installed into etc/default/I<package> in the package build directory.
pt: Se isto existir, é instalado em etc/default/I<pacote> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.upstart
pt: debian/I<pacote>.upstart

note: type: textblock
en: In compatibility level 11, this file will trigger an error with a reminder about ensuring the proper removal of the upstart file in the previous package version.  Please consider using the "rm_conffile" feature from L<dh_installdeb(1)> to ensure the proper removal of previous upstart files.
pt: Em nível de compatibilidade 11, este ficheiro irá disparar um erro com uma lembrança para assegurar a remoção apropriada do ficheiro upstart na versão anterior do pacote. Por favor consider usar a funcionalidade "rm_conffile" do L<dh_installdeb(1)> para assegurar a remoção apropriada de ficheiros upstart anteriores.

note: type: textblock
en: In compatibility level 10, if this file exists, it is installed into etc/init/I<package>.conf in the package build directory.
pt: No nível de compatibilidade 10, se este ficheiro existir, é instalado em etc/init/I<pacote>.conf no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.service
pt: debian/I<pacote>.service

note: type: =item
en: debian/I<package>.tmpfile
pt: debian/I<pacote>.tmpfile

note: type: textblock
en: If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in the package build directory. Only used in compat levels 10 and below.
pt: Se isto existir, é instalado em usr/lib/tmpfiles.d/I<pacote>.conf no directório de compilação do pacote. Apenas usado nos níveis de compatibilidade 10 e inferiores.

note: type: textblock
en: Do not modify F<postinst>/F<postrm>/F<prerm> scripts.
pt: Não modifique os scripts F<postinst>/F<postrm>/F<prerm>.

note: type: textblock
en: Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install any init script, default files, upstart job or systemd service file. May be useful if the file is shipped and/or installed by upstream in a way that doesn't make it easy to let B<dh_installinit> find it.
pt: Apenas modifica os scripts F<postinst>/F<postrm>/F<prerm>, não instala na realidade nenhum script de init, ficheiros predefinidos, ficheiros de trabalho upstart ou serviço do systemd. Pode ser útil se o ficheiro é embarcado e/ou instalado pelo autor original num modo que não deixa ser fácil deixar o B<dh_installinit> encontra-lo.

note: type: textblock
en: B<Caveat>: This will bypass all the regular checks and I<unconditionally> modify the scripts.  You will almost certainly want to use this with B<-p> to limit, which packages are affected by the call.  Example:
pt: B<Caveat>: Isto irá passar ao lado de todas as verificações regulares e modificar I<incondicionalmente> os scripts. Quase de certeza que você irá querer usar isto com B<-p> para limitar quais pacotes serão afectados pela chamada. Exemplo:

note: type: textblock
en: Do not stop the init script until after the package upgrade has been completed.  This is the default behaviour in compat 10.
pt: Não para o script de iniciação até que a actualização do pacote estejam completa. Este é o comportamento predefinido no nível compatibilidade 10.

note: type: textblock
en: In early compat levels, the default was to stop the script in the F<prerm>, and starts it again in the F<postinst>.
pt: Nos níveis de compatibilidade anteriores, a predefinição era parar o script em F<prerm>, e depois arranca-lo de novo no F<postinst>.

note: type: textblock
en: This can be useful for daemons that should not have a possibly long downtime during upgrade. But you should make sure that the daemon will not get confused by the package being upgraded while it's running before using this option.
pt: Isto pode ser útil para daemons que não devem ter a possibilidade de ficar em baixo durante muito tempo durante a actualização. Mas você deve certificar-se que o daemon não vai ficar confuso por o pacote estar a ser actualizado enquanto ele está a correr antes de usar esta opção.

note: type: textblock
en: Undo a previous B<--restart-after-upgrade> (or the default of compat 10).  If no other options are given, this will cause the service to be stopped in the F<prerm> script and started again in the F<postinst> script.
pt: Desfaz um B<--restart-after-upgrade> prévio (ou a predefinição do nível de compatibilidade 10). Se não forem dadas mais opções, isto irá causar com que o serviço seja parado no script F<prerm> e arrancado de novo no script F<postinst>.

note: type: textblock
en: Do not stop init script on upgrade.  This has the side-effect of not restarting the service as a part of the upgrade.
pt: Não para o script init na actualização. Isto tem o efeito secundário de não reiniciar o serviço como parte da actualização.

note: type: textblock
en: If you want to restart the service with minimal downtime, please use B<--restart-after-upgrade> (default in compat 10 or later).  If you want the service to be restarted but be stopped during the upgrade, then please use B<--no-restart-after-upgrade> (note the "after-upgrade").
pt: Se desejar reiniciar o serviço com o tempo mínimo de desligado, por favor use B<--restart-after-upgrade> (predefinido em compatibilidade 10 ou posterior). Se desejar que o serviço seja reiniciado mas que fique parado durante a actualização, então por favor use B<--no-restart-after-upgrade> (repare no "after-upgrade").

note: type: textblock
en: Note that the B<--no-restart-on-upgrade> alias is deprecated and will be removed in compat 12.  This is to avoid confusion with the B<--no-restart-after-upgrade> option.  The B<--no-stop-on-upgrade> variant was introduced in debhelper 10.2 (included in Debian stretch).
pt: Note que o alias B<--no-restart-on-upgrade> está descontinuado e será também removido em compatibilidade 12. Isto serve para evitar confusão com a opção B<--no-restart-after-upgrade>. A variante B<--no-stop-on-upgrade> foi introduzida no debhelper 10.2 (incluído em Debian stretch).

note: type: textblock
en: Do not start the init script on install or upgrade, or stop it on removal.  Only call B<update-rc.d>. Useful for rcS scripts.
pt: Não inicia o script de init durante a instalação ou actualização, ou não o para durante a remoção. Apenas chama B<update-rc.d>. Útil para scripts rcS.

note: type: textblock
en: Disable the init script on purge, but do not enable them on install.  This implies a versioned dependency on B<< init-system-helpers (E<gt>= 1.51) >> as it is the first (functional) version that supports B<< update-rc.d E<lt>scriptE<gt> defaults-disabled >>.
pt: Desactiva o script de init na purga, mas não o activa na instalação. Isto implica uma dependência baseada na versão em B<< init-system-helpers (E<gt>= 1.51) >> pois é a primeira versão funcional que suporta B<< update-rc.d E<lt>scriptE<gt> defaults-disabled >>.

note: type: textblock
en: B<Note> that this option does not affect whether the services are started.  Please remember to also use B<--no-start> if the service should not be started.
pt: B<Note> que esta opção não afecta se os serviços são arrancados. Por favor lembre-se de também usar B<--no-start> se o serviço não deverá ser arrancado.

note: type: textblock
en: Cannot be combined with B<-u>I<params>, B<--update-rcd-params=>I<params>, or B<--> I<params>.
pt: Não pode ser combinado com B<-u>I<params>, B<--update-rcd-params=>I<params>, ou B<--> I<params>.

note: type: textblock
en: Remove trailing B<d> from the name of the package, and use the result for the filename the upstart job file is installed as in F<etc/init/> , and for the filename the init script is installed as in etc/init.d and the default file is installed as in F<etc/default/>. This may be useful for daemons with names ending in B<d>. (Note: this takes precedence over the B<--init-script> parameter described below.)
pt: Remove o B<d> final do nome do pacote, e usa o resultado para o nome do ficheiro de trabalho upstart que é instalado em F<etc/init/> , e para o nome do ficheiro de script de iniciação que é instalado em etc/init.d e o ficheiro predefinido é instalado em F<etc/default/>. Isto pode ser útil para daemons com nomes que terminam em B<d>. (Note: isto toma precedência sobre o parâmetro B<--init-script> descrito em baixo).

note: type: textblock
en: Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> (or B<defaults-disabled> with B<--no-enable>) will be passed to L<update-rc.d(8)>.
pt: Passa I<parâmetros> para L<update-rc.d(8)>. Se não especificado, B<defaults> (ou B<defaults-disabled> com B<--no-enable>) será passado para L<update-rc.d(8)>.

note: type: textblock
en: Cannot be combined with B<--no-enable>.
pt: Não pode ser combinado com  B<--no-enable>.

note: type: textblock
en: Install the init script (and default file) as well as upstart job file using the filename I<name> instead of the default filename, which is the package name. When this parameter is used, B<dh_installinit> looks for and installs files named F<debian/package.name.init>, F<debian/package.name.default> and F<debian/package.name.upstart> instead of the usual F<debian/package.init>, F<debian/package.default> and F<debian/package.upstart>.
pt: Instala o script de iniciação (e ficheiro predefinido) assim como o ficheiro de trabalho upstart usando no nome de ficheiro I<nome> em vez do nome predefinido, o qual é o nome do pacote. Quando este parâmetro é usado, o B<dh_installinit> procura e instala ficheiros chamados F<debian/package.name.init>, F<debian/package.name.default> e F<debian/package.name.upstart> em vez dos usuais F<debian/package.init>, F<debian/package.default> e F<debian/package.upstart>.

note: type: =item
en: B<--init-script=>I<scriptname>
pt: B<--init-script=>I<nome-do-script>

note: type: textblock
en: Use I<scriptname> as the filename the init script is installed as in F<etc/init.d/> (and also use it as the filename for the defaults file, if it is installed). If you use this parameter, B<dh_installinit> will look to see if a file in the F<debian/> directory exists that looks like F<package.scriptname> and if so will install it as the init script in preference to the files it normally installs.
pt: Usa I<scriptname> para o nome do script de iniciação que é instalado em F<etc/init.d/> (e também o usa como nome de ficheiro para o ficheiro de predefinições, se for instalado). Se você usar este parâmetro, o B<dh_installinit> irá ver se existe um ficheiro no directório F<debian/> que seja parecido com F<package.scriptname> e se existir instala-o como script de iniciação em preferência dos ficheiros que normalmente instala.

note: type: textblock
en: This parameter is deprecated, use the B<--name> parameter instead. This parameter is incompatible with the use of upstart jobs.
pt: Este parâmetro está descontinuado, use o parâmetro B<--name> em vez deste. Este parâmetro é incompatível com o uso de tarefas upstart.

note: type: =item
en: B<--error-handler=>I<function>
pt: B<--error-handler=>I<função>

note: type: textblock
en: Call the named shell I<function> if running the init script fails. The function should be provided in the F<prerm> and F<postinst> scripts, before the B<#DEBHELPER#> token.
pt: Chama a I<função> de shell chamada se a execução do script de iniciação falhar. A função deve ser disponibilizada nos scripts F<prerm> e F<postinst>, antes do token B<#DEBHELPER#>.

note: type: textblock
en: dh_installinitramfs - install initramfs hooks and setup maintscripts
pt: dh_installinitramfs - instala hooks de initramfs e scripts principais de configuração

note: type: textblock
en: B<dh_installinitramfs> [S<B<debhelper options>>] [B<-n>]
pt: B<dh_installinitramfs> [S<B<opções do debhelper>>] [B<-n>]

note: type: textblock
en: B<dh_installinitramfs> is a debhelper program that is responsible for installing Debian package provided initramfs hooks.
pt: B<dh_installinitramfs> é um programa debhelper que é responsável por instalar um pacote Debian que fornece hooks de initramfs

note: type: textblock
en: If B<dh_installinitramfs> installs or detects one or more initramfs hooks in the package, then it also automatically generates the noawait trigger B<update-initframfs> command needed to interface with the Debian initramfs system.  This trigger is inserted into the packaging by L<dh_installdeb(1)>.
pt: Se o B<dh_installinitramfs> instalar ou detectar um ou mais hooks de initramfs no pacote, então também gera automaticamente o comando B<update-initframfs> trigger noawait necessário para interagir com o sistema initramfs de Debian. Este trigger é inserido no empacotamento pelo L<dh_installdeb(1)>.

note: type: =item
en: debian/I<package>.initramfs-hook
pt: debian/I<pacote>.initramfs-hook

note: type: textblock
en: Assumed to be an initramfs hook that will be installed into F<< usr/share/initramfs-tools/hooks/I<package> >> in the package build directory. See B<HOOK SCRIPTS> in L<initramfs-tools(8)> for more information about initramfs hooks.
pt: Assumido ser um hook de initramfs que será instalado em F<< usr/share/initramfs-tools/hooks/I<package> >> no directório de compilação do pacote. Veja B<HOOK SCRIPTS> em L<initramfs-tools(8)> para mais informação acerca de hooks de initramfs.

note: type: textblock
en: Do not add the B<update-initramfs> trigger even if it seems like the package might need it.  The option is called B<--no-scripts> for historical reasons as B<dh_installinitramfs> would previously generate maintainer scripts that called B<update-initramfs -u>.
pt: Não adiciona o trigger B<update-initramfs> mesmo que parece que o pacote possa precisar dele. A opção é chamada B<--no-scripts> por razões históricas pois o B<dh_installinitramfs> antes gerava scripts do maintainer que chamavam B<update-initramfs -u>.

note: type: textblock
en: Use this option, if you need to interface with the B<update-initramfs> system that is not satisfied by the noawait trigger (e.g. because you need the extra guarantees and head-aches of a await trigger).
pt: Use esta opção, se precisar de interagir com o sistema B<update-initramfs> que não é satisfeito pelo trigger noawait (ex. porque você precisa de extra garantias e de head-aches de um trigger await).

note: type: textblock
en: Note that this command is not idempotent. L<dh_prep(1)> should be called between invocations of this command. Otherwise, it may cause multiple instances of the same text to be added to triggers file.
pt: Note que este comando não é idempotente. O L<dh_prep(1)> deve ser chamado entre invocações deste comando. Caso contrário, pode causar múltiplas instâncias do mesmo texto a ser adicionado ao ficheiro triggers.

note: type: textblock
en: L<debhelper(7)> L<update-initramfs(8)> L<initramfs-tools(8)>
pt: L<debhelper(7)> L<update-initramfs(8)> L<ferramentas-de-initramfs(8)>

note: type: textblock
en: dh_installlogcheck - install logcheck rulefiles into etc/logcheck/
pt: dh_installlogcheck - instala ficheiros de regras do logcheck em etc/logcheck/

note: type: textblock
en: B<dh_installlogcheck> [S<I<debhelper options>>]
pt: B<dh_installlogcheck> [S<I<debhelper opções>>]

note: type: textblock
en: B<dh_installlogcheck> is a debhelper program that is responsible for installing logcheck rule files.
pt: B<dh_installlogcheck> é um programa debhelper que é responsável por instalar ficheiros de regras de verificação de relatórios (logcheck).

note: type: =item
en: debian/I<package>.logcheck.cracking
pt: debian/I<pacote>.logcheck.cracking

note: type: =item
en: debian/I<package>.logcheck.violations
pt: debian/I<pacote>.logcheck.violations

note: type: =item
en: debian/I<package>.logcheck.violations.ignore
pt: debian/I<pacote>.logcheck.violations.ignore

note: type: =item
en: debian/I<package>.logcheck.ignore.workstation
pt: debian/I<pacote>.logcheck.ignore.workstation

note: type: =item
en: debian/I<package>.logcheck.ignore.server
pt: debian/I<pacote>.logcheck.ignore.server

note: type: =item
en: debian/I<package>.logcheck.ignore.paranoid
pt: debian/I<pacote>.logcheck.ignore.paranoid

note: type: textblock
en: Each of these files, if present, are installed into corresponding subdirectories of F<etc/logcheck/> in package build directories.
pt: Cada um destes ficheiros, se presentes, são instalados nos sub-directórios correspondentes de F<etc/logcheck/> nos directórios de compilação de pacotes.

note: type: textblock
en: Look for files named F<debian/package.name.logcheck.*> and install them into the corresponding subdirectories of F<etc/logcheck/>, but use the specified name instead of that of the package.
pt: Procura ficheiros chamados F<debian/nome.pacote.logcheck.*> e instala-os nos sub-directórios correspondentes de F<etc/logcheck/>, mas usa o nome especificado em vez daquele do pacote.

note: type: verbatim
en: This program is a part of debhelper.
pt: Este programa faz parte do debhelper.

note: type: textblock
en: dh_installlogrotate - install logrotate config files
pt: dh_installlogrotate - instala ficheiros de configuração do logrotate

note: type: textblock
en: B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]
pt: B<dh_installlogrotate> [S<I<debhelper opções>>] [B<--name=>I<nome>]

note: type: textblock
en: B<dh_installlogrotate> is a debhelper program that is responsible for installing logrotate config files into F<etc/logrotate.d> in package build directories.  Files named F<debian/package.logrotate> are installed.
pt: B<dh_installlogrotate> é um programa debhelper que é responsável por instalar ficheiros de configuração do logrotate em F<etc/logrotate.d> nos directórios de compilação de pacotes. São instalados os ficheiros chamados F<debian/pacote.logrotate>-

note: type: textblock
en: Look for files named F<debian/package.name.logrotate> and install them as F<etc/logrotate.d/name>, instead of using the usual files and installing them as the package name.
pt: Procura ficheiros chamados F<debian/nome.pacote.logrotate> e instala-os como F<etc/logrotate.d/nome>, em vez de usar os ficheiros usuais e instala-los como o nome do pacote.

note: type: textblock
en: dh_installman - install man pages into package build directories
pt: dh_installman - instala manuais (man pages) em directórios de compilação de pacotes

note: type: textblock
en: B<dh_installman> [S<I<debhelper options>>] [S<I<manpage> ...>]
pt: B<dh_installman> [S<I<debhelper opções>>] [S<I<manpage> ...>]

note: type: textblock
en: B<dh_installman> is a debhelper program that handles installing man pages into the correct locations in package build directories.
pt: B<dh_installman> é um programa debhelper que lida com a instalação de paginas de manual (man pages) nas localizações correctas nos directórios de compilação de pacotes.

note: type: textblock
en: In compat 10 and earlier, this program was primarily for when upstream's build system does not properly install them as a part of its install step (or it does not have an install step).  In compat 11 and later, it also supports the default searchdir plus --sourcedir like dh_install(1) and has the advantage that it respects the nodoc build profile (unlike dh_install(1)).
pt: Em compatibilidade 10 e anteriores, este programa servia principalmente para quando o sistema de compilação do autor não os instalava apropriadamente como uma parte do seu passo de instalação (ou não possuía um passo de instalação). Em compatibilidade 11 e posterior, também suporta o predefinido searchdir plus --sourcedir como dh_install(1) e tem a vantagem de respeitar o perfil de compilação nodoc (ao contrário de dh_install(1)).

note: type: textblock
en: Even if you prefer to use L<dh_install(1)> for installing the manpages, B<dh_installman> can still be useful for converting the manpage encoding to UTF-8 and for converting F<.so> links (as described below).  However, that part happens automatically without any explicit configuration.
pt: Mesmo que prefira usar L<dh_install(1)> para instalar os manuais, o B<dh_installman> pode ainda ser útil para converter a codificação da pagina de manual para UTF-8 e para converter links F<.so> (como descrito abaixo). No entanto, essa parte acontece automaticamente sem nenhuma configuração explícita.

note: type: textblock
en: You tell B<dh_installman> what man pages go in your packages, and it figures out where to install them based on the section field in their B<.TH> or B<.Dt> line. If you have a properly formatted B<.TH> or B<.Dt> line, your man page will be installed into the right directory, with the right name (this includes proper handling of pages with a subsection, like B<3perl>, which are placed in F<man3>, and given an extension of F<.3perl>). If your B<.TH> or B<.Dt> line is incorrect or missing, the program may guess wrong based on the file extension.
pt: Você diz ao B<dh_installman> quais manuais vão para os seus pacotes, e ele descobre onde os instalar com base no campo secção na sua linha B<.TH> ou B<.Dt>. Se você tem uma linha B<.TH> ou B<.Dt> correctamente formatada, o seu manual será instalado no directório correcto, com o nome correcto (isto inclui o manuseamento apropriado de páginas com uma sub-secção, como B<3perl>, a qual é colocada em F<man3>, e é-lhe dada uma extensão F<.3perl>). Se a sua linha B<.TH> ou B<.Dt> está incorrecta ou em falta, o programa pode adivinhar errado com base na extensão do ficheiro.

note: type: textblock
en: It also supports translated man pages, by looking for extensions like F<.ll.8> and F<.ll_LL.8>, or by use of the B<--language> switch.
pt: Também suporta manuais traduzidos, ao procurar extensões como F<.ll.8> e F<.ll_LL.8>, ou pelo uso do switch B<--language>.

note: type: textblock
en: If B<dh_installman> seems to install a man page into the wrong section or with the wrong extension, this is because the man page has the wrong section listed in its B<.TH> or B<.Dt> line. Edit the man page and correct the section, and B<dh_installman> will follow suit. See L<man(7)> for details about the B<.TH> section, and L<mdoc(7)> for the B<.Dt> section. If B<dh_installman> seems to install a man page into a directory like F</usr/share/man/pl/man1/>, that is because your program has a name like F<foo.pl>, and B<dh_installman> assumes that means it is translated into Polish. Use B<--language=C> to avoid this.
pt: Se o B<dh_installman> parecer instalar um manual numa secção errada ou com a extensão errada, é porque o manual tem a secção errada listada nas suas linhas B<.TH> or B<.Dt>. Edite o manual e corrija a secção, e o B<dh_installman> funcionará bem. Veja L<man(7)> para detalhes acerca da secção B<.TH>, e L<mdoc(7)> para a secção B<.Dt>. Se o B<dh_installman> parecer instalar um manual num directório como F</usr/share/man/pl/man1/>, é porque o seu programa tem um nome como F<foo.pl>, e o B<dh_installman> assume que isso significa que está traduzido em Polaco. Use B<--language=C> para evitar isto.

note: type: textblock
en: After the man page installation step, B<dh_installman> will check to see if any of the man pages in the temporary directories of any of the packages it is acting on contain F<.so> links. If so, it changes them to symlinks.
pt: Após o passo da instalação do manual, o B<dh_installman> irá verificar se algum dos manuais nos directórios temporários de todos os pacotes em que actua se contêm links F<.so>. Se sim, altera-os para links simbólicos.

note: type: textblock
en: Also, B<dh_installman> will use man to guess the character encoding of each manual page and convert it to UTF-8. If the guesswork fails for some reason, you can override it using an encoding declaration. See L<manconv(1)> for details.
pt: O B<dh_installman> também irá usa o man para adivinhar a codificação de caracteres de cada manual e converte-los para UTF-8. Se o trabalho de adivinhar falhar por alguma razão, você pode-o sobrepor usando uma declaração de codificação. Veja L<manconv(1)> para detalhes.

note: type: =item
en: debian/I<package>.manpages
pt: debian/I<pacote>.manpages

note: type: textblock
en: Lists man pages to be installed.
pt: Lista os manuais (man pages) a serem instalados.

note: type: textblock
en: Use this to specify that the man pages being acted on are written in the specified language.
pt: Use isto para especificar que os manuais onde se vai actuar estão escritos na linguagem especificada.

note: type: textblock
en: Install these man pages into the first package acted on. (Or in all packages if B<-A> is specified).
pt: Instala estes manuais no primeiro pacote onde se actua. (Ou em todos os pacotes caso for especificado B<-A>).

note: type: textblock
en: An older version of this program, L<dh_installmanpages(1)>, is still used by some packages, and so is still included in debhelper.  It is, however, deprecated, due to its counterintuitive and inconsistent interface. Use this program instead.
pt: Uma versão mais antiga deste programa, o L<dh_installmanpages(1)>, é ainda usado por alguns pacotes, e por isso ainda é incluída no debhelper. No entanto, está descontinuada, devido à sua interface contra-intuitiva e inconsistente. Use antes este programa.

note: type: textblock
en: dh_installmanpages - old-style man page installer (deprecated)
pt: dh_installmanpages - instalador de manuais ao estilo antigo (descontinuado)

note: type: textblock
en: B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file> ...>]
pt: B<dh_installmanpages> [S<I<debhelper opções>>] [S<I<ficheiro> ...>]

note: type: textblock
en: B<dh_installmanpages> is a debhelper program that is responsible for automatically installing man pages into F<usr/share/man/> in package build directories.
pt: B<dh_installmanpages> é um programa debhelper que é responsável por instalar automaticamente manuais (man pages) em F<usr/share/man/> nos directórios de compilação de pacotes.

note: type: textblock
en: This is a DWIM-style program, with an interface unlike the rest of debhelper. It is deprecated, and you are encouraged to use L<dh_installman(1)> instead.
pt: Este é um programa estilo DWIM, com uma interface diferente do resto do debhelper. Está descontinuado, em vez deste, você é encorajado a usar o L<dh_installman(1)>.

note: type: textblock
en: B<dh_installmanpages> scans the current directory and all subdirectories for filenames that look like man pages. (Note that only real files are looked at; symlinks are ignored.) It uses L<file(1)> to verify that the files are in the correct format. Then, based on the files' extensions, it installs them into the correct man directory.
pt: B<dh_installmanpages> examina o directório actual e todos os sub-directórios por nomes de ficheiros que se parecem com manuais. (Note que apenas são procurados ficheiros verdadeiros, os links simbólicos são ignorados). Usa o L<file(1)> para verificar se os ficheiros estão no formato correcto. Depois, baseando-se nas extensões dos ficheiros, instala-os no directório de manuais correcto.

note: type: textblock
en: All filenames specified as parameters will be skipped by B<dh_installmanpages>.  This is useful if by default it installs some man pages that you do not want to be installed.
pt: Todos os nomes de ficheiros especificados como parâmetros serão evitados pelo B<dh_installmanpages>. Isto é útil se por predefinição instalar alguns manuais que você não deseja serem instalados.

note: type: textblock
en: After the man page installation step, B<dh_installmanpages> will check to see if any of the man pages are F<.so> links. If so, it changes them to symlinks.
pt: Após o passe da instalação do manual, o B<dh_installmanpages> irá ver se alguns dos manuais são links F<.so>. Se forem, altera-os para links simbólicos.

note: type: textblock
en: Do not install these files as man pages, even if they look like valid man pages.
pt: Não instale estes ficheiros como manuais, mesmo que eles se pareçam com "man pages" válidas.

note: type: textblock
en: B<dh_installmanpages> will install the man pages it finds into B<all> packages you tell it to act on, since it can't tell what package the man pages belong in. This is almost never what you really want (use B<-p> to work around this, or use the much better L<dh_installman(1)> program instead).
pt: B<dh_installmanpages> irá instalar os manuais que encontra em  B<todos> os pacotes que lhe diga para actuar, pois ele não sabe a qual pacote os manuais pertencem. Quase sempre isto não é o que realmente você quer (use B<-p> para contornar isto, ou use o outro muito melhor programa L<dh_installman(1)> em vez deste).

note: type: textblock
en: Files ending in F<.man> will be ignored.
pt: Os ficheiros que terminem em F<.man> serão ignorados.

note: type: textblock
en: Files specified as parameters that contain spaces in their filenames will not be processed properly.
pt: Ficheiros especificados como parâmetros que contêm espaços nos seus nomes de ficheiros não serão processados de modo apropriado.

note: type: textblock
en: dh_installmenu - install Debian menu files into package build directories
pt: dh_installmenu - instala ficheiros de menu Debian em directórios de compilação de pacotes

note: type: textblock
en: B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]
pt: B<dh_installmenu> [S<B<debhelper opções>>] [B<-n>]

note: type: textblock
en: B<dh_installmenu> is a debhelper program that is responsible for installing files used by the Debian B<menu> package into package build directories.
pt: B<dh_installmenu> é um programa debhelper que é responsável por instalar ficheiros usados pelo pacote B<menu> de Debian em directórios de compilação de pacotes.

note: type: textblock
en: It also automatically generates the F<postinst> and F<postrm> commands needed to interface with the Debian B<menu> package. These commands are inserted into the maintainer scripts by L<dh_installdeb(1)>.
pt: Também gera automaticamente os comandos F<postinst> e F<postrm> necessários para interagir com o pacote Debian B<menu>. Estes comandos são inseridos nos scripts do maintainer pelo L<dh_installdeb(1)>.

note: type: =item
en: debian/I<package>.menu
pt: debian/I<pacote>.menu

note: type: textblock
en: Debian menu files, installed into usr/share/menu/I<package> in the package build directory. See L<menufile(5)> for its format.
pt: Ficheiros de menu Debian, instalados em usr/share/menu/I<pacote> no directório de compilação do pacote. Veja L<menufile(5)> para o seu formato.

note: type: =item
en: debian/I<package>.menu-method
pt: debian/I<pacote>.menu-method

note: type: textblock
en: Debian menu method files, installed into etc/menu-methods/I<package> in the package build directory.
pt: Ficheiros do método de menu Debian, instalados em etc/menu-methods/I<pacote> no directório de compilação do pacote.

note: type: textblock
en: Do not modify F<postinst>/F<postrm> scripts.
pt: Não modifique os scripts F<postinst>/F<postrm>.

note: type: textblock
en: dh_installmime - install mime files into package build directories
pt: dh_installmime - instala ficheiros mime em directórios de compilação de pacotes

note: type: textblock
en: B<dh_installmime> [S<I<debhelper options>>]
pt: B<dh_installmime> [S<I<debhelper opções>>]

note: type: textblock
en: B<dh_installmime> is a debhelper program that is responsible for installing mime files into package build directories.
pt: B<dh_installmime> é um programa debhelper que é responsável por instalar ficheiros mime em directórios de compilação de pacotes.

note: type: =item
en: debian/I<package>.mime
pt: debian/I<pacote>.mime

note: type: textblock
en: Installed into usr/lib/mime/packages/I<package> in the package build directory.
pt: Instalado para usr/lib/mime/packages/I<pacote> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.sharedmimeinfo
pt: debian/I<pacote>.sharedmimeinfo

note: type: textblock
en: Installed into /usr/share/mime/packages/I<package>.xml in the package build directory.
pt: Instalado para /usr/share/mime/packages/I<pacote>.xml no directório de compilação do pacote.

note: type: textblock
en: dh_installmodules - register kernel modules
pt: dh_installmodules - regista módulos de kernel

note: type: textblock
en: B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]
pt: B<dh_installmodules> [S<I<debhelper opções>>] [B<-n>] [B<--name=>I<nome>]

note: type: textblock
en: B<dh_installmodules> is a debhelper program that is responsible for registering kernel modules.
pt: B<dh_installmodules> é um programa debhelper que é responsável por registar módulos de kernel.

note: type: textblock
en: Kernel modules are searched for in the package build directory and if found, F<preinst>, F<postinst> and F<postrm> commands are automatically generated to run B<depmod> and register the modules when the package is installed.  These commands are inserted into the maintainer scripts by L<dh_installdeb(1)>.
pt: São procurados módulos de kernel no directório de compilação do pacote, e se encontrados, os comandos F<preinst>, F<postinst> e F<postrm> são gerados automaticamente para correr o B<depmod> e registar os módulos quando o pacote é instalado. Estes comandos são inseridos nos scripts do maintainer pelo L<dh_installdeb(1)>.

note: type: =item
en: debian/I<package>.modprobe
pt: debian/I<pacote>.modprobe

note: type: textblock
en: Installed to etc/modprobe.d/I<package>.conf in the package build directory.
pt: Instalado em etc/modprobe.d/I<pacote>.conf no directório de compilação do pacote.

note: type: textblock
en: Do not modify F<preinst>/F<postinst>/F<postrm> scripts.
pt: Não modifique os scripts F<preinst>/F<postinst>/F<postrm>.

note: type: textblock
en: When this parameter is used, B<dh_installmodules> looks for and installs files named debian/I<package>.I<name>.modprobe instead of the usual debian/I<package>.modprobe
pt: Quando este parâmetro é usado, B<dh_installmodules> procura e instala ficheiros chamados debian/I<pacote>.I<nome>.modprobe em vez dos habituais debian/I<pacote>.modprobe

note: type: textblock
en: dh_installpam - install pam support files
pt: dh_installpam - instala ficheiros de suporte ao pam

note: type: textblock
en: B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]
pt: B<dh_installpam> [S<I<debhelper opções>>] [B<--name=>I<nome>]

note: type: textblock
en: B<dh_installpam> is a debhelper program that is responsible for installing files used by PAM into package build directories.
pt: B<dh_installpam> é um programa debhelper que é responsável por instalar ficheiros usados pelo PAM nos directórios de compilação de pacotes.

note: type: =item
en: debian/I<package>.pam
pt: debian/I<pacote>.pam

note: type: textblock
en: Installed into usr/lib/pam.d/I<package> in the package build directory.
pt: Instalado em usr/lib/pam.d/I<pacote> no directório de compilação do pacote.

note: type: textblock
en: Until compatibility level 14 this file was installed under etc/pam.d/I<package>. Please consider using the "rm_conffile" feature from L<dh_installdeb(1)> to ensure the proper removal of previous PAM files.
pt: Ate ao nível de compatibilidade 14 este ficheiro era instalado sob etc/pam.d/I<pacote>. Por favor considere usar a funcionalidade "rm_conffile" do L<dh_installdeb(1)> para assegurar a remoção apropriada dos ficheiros PAM anteriores.

note: type: textblock
en: Look for files named debian/I<package>.I<name>.pam and install them as usr/lib/pam.d/I<name>, instead of using the usual files and installing them using the package name.
pt: Procura ficheiros chamados debian/I<pacote>.I<nome>.pam e instala-os como usr/lib/pam.d/I<nome>, em vez de usar os ficheiros habituais e de os instalar usando o nome do pacote.

note: type: textblock
en: dh_installppp - install ppp ip-up and ip-down files
pt: dh_installppp - instala os ficheiros ip-up e ip-down do ppp

note: type: textblock
en: B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]
pt: B<dh_installppp> [S<I<debhelper opções>>] [B<--name=>I<nome>]

note: type: textblock
en: B<dh_installppp> is a debhelper program that is responsible for installing ppp ip-up and ip-down scripts into package build directories.
pt: B<dh_installppp> é um programa debhelper que é responsável por instalar os scripts ip-up e ip-down do ppp nos directórios de compilação de pacotes.

note: type: =item
en: debian/I<package>.ppp.ip-up
pt: debian/I<pacote>.ppp.ip-up

note: type: textblock
en: Installed into etc/ppp/ip-up.d/I<package> in the package build directory.
pt: Instalado em etc/ppp/ip-up.d/I<pacote> no directório de compilação do pacote.

note: type: =item
en: debian/I<package>.ppp.ip-down
pt: debian/I<pacote>.ppp.ip-down

note: type: textblock
en: Installed into etc/ppp/ip-down.d/I<package> in the package build directory.
pt: Instalado em etc/ppp/ip-down.d/I<pacote> no directório de compilação do pacote.

note: type: textblock
en: Look for files named F<debian/package.name.ppp.ip-*> and install them as F<etc/ppp/ip-*/name>, instead of using the usual files and installing them as the package name.
pt: Procura ficheiros chamados F<debian/nome.pacote.ppp.ip-*> e instala-os como F<etc/ppp/ip-*/nome>,  em vez de usar os ficheiros habituais e de os instalar como o nome do pacote.

note: type: textblock
en: dh_installudev - install udev rules files
pt: dh_installudev - instala ficheiros de regras do udev

note: type: textblock
en: B<dh_installudev> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>] [B<--priority=>I<priority>]
pt: B<dh_installudev> [S<I<debhelper opções>>] [B<-n>] [B<--name=>I<nome>] [B<--priority=>I<prioridade>]

note: type: textblock
en: B<dh_installudev> is a debhelper program that is responsible for installing B<udev> rules files.
pt: B<dh_installudev> é um programa debhelper que é responsável por instalar ficheiros de regras do B<udev>.

note: type: =item
en: debian/I<package>.udev
pt: debian/I<pacote>.udev

note: type: textblock
en: When this parameter is used, B<dh_installudev> looks for and installs files named debian/I<package>.I<name>.udev instead of the usual debian/I<package>.udev.
pt: Quando este parâmetro é usado, o B<dh_installudev> procura e instala ficheiros chamados debian/I<pacote>.I<nome>.udev em vez dos usuais debian/I<pacote>.udev.

note: type: =item
en: B<--priority=>I<priority>
pt: B<--priority=>I<prioridade>

note: type: textblock
en: Sets the priority the file. Default is 60.
pt: Define a prioridade do ficheiro. O valor predefinido é 60.

note: type: textblock
en: dh_installwm - register a window manager
pt: dh_installwm - regista um gestor de janelas

note: type: textblock
en: B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] [S<I<wm> ...>]
pt: B<dh_installwm> [S<I<debhelper opções>>] [B<-n>] [B<--priority=>I<n>] [S<I<wm> ...>]

note: type: textblock
en: B<dh_installwm> is a debhelper program that is responsible for generating the F<postinst> and F<prerm> commands that register a window manager with L<update-alternatives(8)>. The window manager's man page is also registered as a slave symlink (in v6 mode and up).  It must be installed in F<usr/share/man/man1/> in the package build directory prior to calling B<dh_installwm>.  In compat 9 and earlier, the manpage was optional.
pt: B<dh_installwm> é um programa debhelper que é responsável por gerar os comandos F<postinst> e F<prerm> que registam um gestor de janelas com L<update-alternatives(8)>. O manual do gestor de janelas é também registado como um link simbólico escravo (em modo v6 e posterior). Tem de ser instalado em F<usr/share/man/man1/> no directório de compilação do pacote antes da chamada B<dh_installwm>. Em compatibilidade 9 e anterior, a página de manual era opcional.

note: type: =item
en: debian/I<package>.wm
pt: debian/I<pacote>.wm

note: type: textblock
en: List window manager programs to register.
pt: Lista programas de gestão de janelas para registar.

note: type: textblock
en: Set the priority of the window manager. Default is 20, which is too low for most window managers; see the Debian Policy document for instructions on calculating the correct value.
pt: Define a prioridade do gestor de janelas. A predefinição é 20, o que é muito baixo para a maioria dos gestores de janelas; veja o documento Debian Policy para instruções sobre como calcular o valor correcto.

note: type: textblock
en: Do not modify F<postinst>/F<prerm> scripts. Turns this command into a no-op.
pt: Não modifique os scripts F<postinst>/F<prerm>. Transforma este comando em não-operacional (no-op).

note: type: textblock
en: Modify scripts for window managers specified by command line parameters in ALL packages acted on, not just the first.
pt: Modifica scripts para gestores de janelas especificados por parâmetros de linha de comandos em TODOS os pacotes em que actua, e não apenas no primeiro.

note: type: textblock
en: Window manager programs to register.
pt: Programas de gestão de janelas para registar.

note: type: textblock
en: dh_installxfonts - register X fonts
pt: dh_installxfonts - regista fonts X

note: type: textblock
en: B<dh_installxfonts> [S<I<debhelper options>>]
pt: B<dh_installxfonts> [S<I<debhelper opções>>]

note: type: textblock
en: B<dh_installxfonts> is a debhelper program that is responsible for registering X fonts, so their corresponding F<fonts.dir>, F<fonts.alias>, and F<fonts.scale> be rebuilt properly at install time.
pt: B<dh_installxfonts> é um programa debhelper que é responsável por registar tipos de letra (fonts) do X, para que os seus correspondentes F<fonts.dir>, F<fonts.alias>, e F<fonts.scale> sejam compilados correctamente durante a instalação.

note: type: textblock
en: Before calling this program, you should have installed any X fonts provided by your package into the appropriate location in the package build directory, and if you have F<fonts.alias> or F<fonts.scale> files, you should install them into the correct location under F<etc/X11/fonts> in your package build directory.
pt: Antes de chamar este programa, você deve ter instalado quaisquer fonts X disponibilizadas pelo seu pacote na localização apropriada no directório de compilação do pacote, e você tem ficheiros F<fonts.alias> ou F<fonts.scale>, você deve instala-los na localização correcta sob F<etc/X11/fonts> no seu directório de compilação do pacote.

note: type: textblock
en: Your package should depend on B<xfonts-utils> so that the B<update-fonts->I<*> commands are available. (This program adds that dependency to B<${misc:Depends}>.)
pt: O seu pacote deve depender de B<xfonts-utils> para que os comandos B<update-fonts->I<*> estejam disponíveis. (Este programa adiciona a dependência a B<${misc:Depends}>.)

note: type: textblock
en: This program automatically generates the F<postinst> and F<postrm> commands needed to register X fonts. These commands are inserted into the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how this works.
pt: Este programa gera automaticamente os comandos F<postinst> e F<postrm> necessários para registar fonts do X. Estes comandos são inseridos nos scripts do maintainer pelo B<dh_installdeb>. Veja  L<dh_installdeb(1)> para uma explicação sobre como isto funciona.

note: type: textblock
en: See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and L<update-fonts-dir(8)> for more information about X font installation.
pt: Veja L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, e L<update-fonts-dir(8)> para mais informação acerca de instalação de fonts X.

note: type: textblock
en: See Debian policy, section 11.8.5. for details about doing fonts the Debian way.
pt: Veja Debian policy, secção 11.8.5. para detalhes acerca de fazer fonts à maneira de Debian.

note: type: textblock
en: dh_link - create symlinks in package build directories
pt: dh_link - cria links simbólicos em directórios de compilação de pacotes

note: type: textblock
en: B<dh_link> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<source destination> ...>]
pt: B<dh_link> [S<I<debhelper opções>>] [B<-A>] [B<-X>I<item>] [S<I<fonte destino> ...>]

note: type: textblock
en: B<dh_link> is a debhelper program that creates symlinks in package build directories.
pt: B<dh_link> é um programa debhelper que cria links simbólicos nos directórios de compilação de pacotes.

note: type: textblock
en: B<dh_link> accepts a list of pairs of source and destination files. The source files are the already existing files that will be symlinked from (called B<target> by L<ln(1)>). The destination files are the symlinks that will be created (called B<link name> by L<ln(1)>). There B<must> be an equal number of source and destination files specified.
pt: B<dh_link> aceita uma lista de pares de ficheiros de fonte e destino. Os ficheiros fonte são os ficheiros já existentes de onde se vai criar os links simbólicos (chamados B<target> pelo L<ln(1)>). Os ficheiros de destino são os links simbólicos que irão ser criados (chamados B<link name> pelo L<ln(1)>). O número de ficheiros fonte e destino especificados B<tem> de ser igual.

note: type: textblock
en: Be sure you B<do> specify the absolute path to both the source and destination files (unlike you would do if you were using something like L<ln(1)>).  Please note that the leading slash is optional.
pt: Certifique-se que B<especifica> o caminho absoluto para ambos ficheiros de fonte e destino (ao contrário do que faria se estivesse a usar algo como L<ln(1)>). Por favor note que a barra de inicio é opcional.

note: type: textblock
en: B<dh_link> will generate symlinks that comply with Debian policy - absolute when policy says they should be absolute, and relative links with as short a path as possible. It will also create any subdirectories it needs to put the symlinks in.
pt: B<dh_link> irá gerar links simbólicos em conformidade com a política Debian - absolutos quando a política diz que devem ser absolutos, e links relativos com o caminho mais curto possível. Também irá criar quaisquer sub-directórios que precise para pôr os links simbólicos lá dentro.

note: type: textblock
en: Any pre-existing destination files will be replaced with symlinks.
pt: Quaisquer ficheiros de destino pré-existentes serão substituídos por links simbólicos.

note: type: textblock
en: B<dh_link> also scans the package build tree for existing symlinks which do not conform to Debian policy, and corrects them (v4 or later).
pt: B<dh_link> também sonda a árvore de compilação do pacote por links simbólicos existentes que não estejam em conformidade com a política Debian, e corrige-os (v4 ou posterior).

note: type: =item
en: debian/I<package>.links
pt: debian/I<pacote>.links

note: type: textblock
en: Lists pairs of source and destination files to be symlinked. Each pair should be put on its own line, with the source and destination separated by whitespace.
pt: Lista pares de ficheiros de fonte e destino para serem ligados por link simbólico. Cada par deve ser colocado na sua linha própria, com a fonte e destino separados por um espaço em branco.

note: type: textblock
en: In each pair the source file (called B<target> by L<ln(1)>) comes first and is followed by the destination file (called B<link name> by L<ln(1)>). Thus the pairs of source and destination files in each line are given in the same order as they would be given to L<ln(1)>.
pt: Em cada par o ficheiro fonte (chamado B<target> pelo L<ln(1)>) aparece primeiro e é seguido pelo ficheiro de destino (chamado B<link name> pelo L<ln(1)>). Assim os pares de fonte e destino em cada linha são fornecidos na mesma ordem como seriam fornecidos ao L<ln(1)>.

note: type: textblock
en: In contrast to L<ln(1)>, source and destination paths must be absolute (the leading slash is optional).
pt: Em contraste ao L<ln(1)>, os caminhos de fonte e destino têm de ser absolutos (a barra de inicio é opcional).

note: type: textblock
en: Create any links specified by command line parameters in ALL packages acted on, not just the first.
pt: Cria quaisquer links especificados por parâmetros de linha de comandos em TODOS os pacotes em que actua, e não apenas no primeiro.

note: type: textblock
en: Exclude symlinks that contain I<item> anywhere in their filename from being corrected to comply with Debian policy.
pt: Exclui links simbólicos que contêm I<item> em qualquer ponto do seu nome de serem corrigidos para ficarem em conformidade com a política Debian.

note: type: textblock
en: Create a file named I<destination> as a link to a file named I<source>. Do this in the package build directory of the first package acted on.  (Or in all packages if B<-A> is specified.)
pt: Cria um ficheiro chamado I<destination> como um link para um ficheiro chamado I<source>. Faz isto no directório de compilação de pacote do primeiro pacote em que actua. (Ou em todos os pacotes se for especificado B<-A>.)

note: type: textblock
en: Make F<bar.1> be a symlink to F<foo.1>
pt: Faz F<bar.1> ser um link simbólico para F<foo.1>

note: type: textblock
en: Make F</usr/lib/foo/> be a link to F</var/lib/foo/>, and F<bar.1> be a symlink to the F<foo.1>
pt: Faz F</usr/lib/foo/> ser um link para F</var/lib/foo/>, e F<bar.1> ser um link simbólico para F<foo.1>

note: type: textblock
en: Same as above but as content for a debian/I<package>.links file.
pt: O mesmo de cima mas como conteúdo para um ficheiro debian/I<package>.links.

note: type: textblock
en: dh_lintian - install lintian override files into package build directories
pt: dh_lintian - instala ficheiros de sobreposição do lintian nos directórios de compilação de pacotes.

note: type: textblock
en: B<dh_lintian> [S<I<debhelper options>>]
pt: B<dh_lintian> [S<I<debhelper opções>>]

note: type: textblock
en: B<dh_lintian> is a debhelper program that is responsible for installing override files used by lintian into package build directories.
pt: B<dh_lintian> é um programa debhelper que é responsável por instalar ficheiros de sobreposição usados pelo lintian nos directórios de compilação de pacotes.

note: type: =item
en: debian/I<package>.lintian-overrides
pt: debian/I<pacote>.lintian-overrides

note: type: textblock
en: Installed into usr/share/lintian/overrides/I<package> in the package build directory. This file is used to suppress erroneous lintian diagnostics.
pt: Instalado em usr/share/lintian/overrides/I<pacote> no directório de compilação do pacote. Este ficheiro é usado para suprimir diagnósticos do lintian errados.

note: type: textblock
en: These files are not installed, but will be scanned by lintian to provide overrides for the source package.
pt: Estes ficheiros não serão instalados, mas serão sondados pelo lintian para disponibilizar sobreposições para o pacote fonte.

note: type: textblock
en: dh_listpackages - list binary packages debhelper will act on
pt: dh_listpackages - lista pacotes binários onde o debhelper não irá actuar

note: type: textblock
en: B<dh_listpackages> [S<I<debhelper options>>]
pt: B<dh_listpackages> [S<I<debhelper opções>>]

note: type: textblock
en: B<dh_listpackages> is a debhelper program that outputs a list of all binary packages debhelper commands will act on. If you pass it some options, it will change the list to match the packages other debhelper commands would act on if passed the same options.
pt: B<dh_listpackages> é um programa debhelper que gera uma lista de todos os pacotes binários onde os comandos do debhelper irão actuar. Se você lhe passar algumas opções, ele irá alterar a lista para corresponder aos pacotes em que os outros comandos debhelper irão actuar se lhes passar as mesmas opções.

note: type: textblock
en: Packages are listed in the order they appear in F<debian/control>.
pt: Pacotes são listados na ordem que aparecem em F<debian/control>.

note: type: textblock
en: dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols
pt: dh_makeshlibs - cria automaticamente o ficheiro shlibs e chama dpkg-gensymbols

note: type: textblock
en: B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] [B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]
pt: B<dh_makeshlibs> [S<I<opções do debhelper>>] [B<-m>I<major>] [B<-V>I<[dependências]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<parâmetros>>]

note: type: textblock
en: B<dh_makeshlibs> is a debhelper program that automatically scans for shared libraries, and generates a shlibs file for the libraries it finds.
pt: B<dh_makeshlibs> é um programa debhelper que sonda automaticamente por bibliotecas partilhadas, e gera um ficheiro shlibs para as bibliotecas que encontra.

note: type: textblock
en: It will also ensure that ldconfig is invoked during install and removal when it finds shared libraries.  Since debhelper 9.20151004, this is done via a dpkg trigger.  In older versions of debhelper, B<dh_makeshlibs> would generate a maintainer script for this purpose.
pt: Também assegura que o ldconfig é invocado durante a instalação e remoção quando encontra bibliotecas partilhadas. Desde o debhelper 9.20151004, isto é feito via um trigger do dpkg. Nas versões mais antigas do debhelper, B<dh_makeshlibs> seria geralmente um script de maintainer para este objetivo.

note: type: textblock
en: Since debhelper 12.3, B<dh_makeshlibs> will by default add an additional I<udeb> line for udebs in the shlibs file, when the udeb has the same name as the deb followed by a "-udeb" suffix (e.g. if the deb is called "libfoo1", then debhelper will auto-detect the udeb if it is named "libfoo1-udeb"). Please use the B<--add-udeb> and B<--no-add-udeb> options below when this auto-detection is insufficient.
pt: Desde o debhelper 12.3, B<dh_makeshlibs> irá por predefinição adicionar uma linha I<udeb> adicional para udebs no ficheiro shlibs, quando o udeb tem o mesmo nome que o deb seguido por um sufixo "-udeb" (ex. se o deb for chamado "libfoo1", então o debhelper irá auto-detectar o udeb se ele for chamado "libfoo1-udeb"). Por favor use as opções B<--add-udeb> e B<--no-add-udeb> abaixo quando esta auto-detecção é insuficiente.

note: type: textblock
en: If you previously used B<--add-udeb> and are considering to migrate to using the new auto-detection feature in 12.3, then please remember to test that the resulting F<DEBIAN/shlibs> files are as expected.  There are some known corner cases, where the auto-detection is insufficient.  These include when the udeb contains library files from multiple regular deb packages or when the packages do not follow the expected naming convention.
pt: Se você usou anteriormente B<--add-udeb> e está a considerar migrar para a utilização da nova funcionalidade de auto-detecção em 12.3, então por favor lembre-se de testar que os ficheiros F<DEBIAN/shlibs> resultantes são os esperados. Existem alguns casos conhecidos, onde a auto-detecção é insuficiente. Estes incluem quando o udeb contem ficheiros biblioteca de múltiplos pacotes deb regulares ou quando os pacotes não seguem a convenção de nomes esperada.

note: type: =item
en: debian/I<package>.shlibs
pt: debian/I<pacote>.shlibs

note: type: textblock
en: Installs this file, if present, into the package as DEBIAN/shlibs.  If omitted, debhelper will generate a shlibs file automatically if it detects any libraries.
pt: Instala este ficheiro, se presente, no pacote como DEBIAN/shlibs. Se omitido, o debhelper irá gerar um ficheiro shlibs automaticamente se detectar quaisquer bibliotecas.

note: type: textblock
en: Note in compat levels 9 and earlier, this file was installed by L<dh_installdeb(1)> rather than B<dh_makeshlibs>.
pt: Note que em níveis de compatibilidade 9 e anteriores, este ficheiro era instalado pelo L<dh_installdeb(1)> em vez do B<dh_makeshlibs>.

note: type: =item
en: debian/I<package>.symbols
pt: debian/I<pacote>.symbols

note: type: =item
en: debian/I<package>.symbols.I<arch>
pt: debian/I<pacote>.symbols.I<arquitectura>

note: type: textblock
en: These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to be processed and installed. Use the I<arch> specific names if you need to provide different symbols files for different architectures.
pt: Estes ficheiros de símbolos, se presentes, são passados para L<dpkg-gensymbols(1)> para serem processados e instalados. Use os nomes específicos de I<arch> se precisar de disponibilizar ficheiros de símbolos diferentes para diferentes arquitecturas.

note: type: textblock
en: Instead of trying to guess the major number of the library with objdump, use the major number specified after the -m parameter. This is much less useful than it used to be, back in the bad old days when this program looked at library filenames rather than using objdump.
pt: Em vez de tentar adivinhar o maior número da biblioteca com o objdump, usa o maior número especificado após o parâmetro -m. Isto é muito menos útil do que costumava ser, de volta aos maus velhos tempos quando este programa olhava para os nomes de ficheiro das bibliotecas em vez de usar o objdump.

note: type: =item
en: B<-V>, B<-V>I<dependencies>
pt: B<-V>, B<-V>I<dependências>

note: type: =item
en: B<--version-info>, B<--version-info=>I<dependencies>
pt: B<--version-info>, B<--version-info=>I<dependências>

note: type: textblock
en: If a shlibs file is generated by this program, this option controls what version will be used in the dependency relation.
pt: Se um ficheiro shlibs for gerado por este programa, esta opção controla que versão será usada na relação de dependência.

note: type: textblock
en: In compat 12 and later, B<dh_makeshlibs> defaults to B<-VUpstream-Version>.  In compat 11 and earlier the default behaved like B<-VNone>.
pt: Em compatibilidade 12 e posterior, B<dh_makeshlibs> usa por predefinição B<-VUpstream-Version>.  Em compatibilidade 11 e anterior o comportamento predefinido é como B<-VNone>.

note: type: textblock
en: The B<dh_makeshlibs> tool can generate dependencies in three variants:
pt: A ferramenta B<dh_makeshlibs> pode gerar dependências em três variantes:

note: type: textblock
en: The dependency will be "I<packagename> B<(E<gt>>= I<packageversion>B<)>".  Note that I<Upstream-Version> is case-sensitive and must be written exactly as shown here.
pt: A dependência será "I<packagename> B<(E<gt>>= I<packageversion>B<)>".  Note que I<Upstream-Version> é sensível a maiúsculas/minúsculas e tem de ser escrito exactamente como mostrado aqui.

note: type: textblock
en: This is a conservative setting that always ensures that other packages' shared library dependencies are at least as tight as they need to be (unless the library is prone to changing ABI without updating the upstream version number).
pt: Esta é uma definição conservativa que assegura sempre que as dependências de bibliotecas partilhadas dos pacotes mais antigos são pelo menos tão justas o quanto precisam de ser (a menos que a biblioteca seja inclinada a alterar a ABI sem actualizar o número de versão do autor).

note: type: textblock
en: The flip side is that packages might end up with dependencies that are too tight in some cases (note a symbols file can mitigate this issue).  This is often of minor temporary inconvenience and usually a lot better than the fall out caused by forgetting to bump the dependency information.
pt: O reverso da medalha é que os pacotes podem acabar com dependências muito apertadas em alguns casos (note que um ficheiro symbols pode mitigar esta situação). Isto é geralmente uma inconveniência menor temporária e normalmente muito melhor que a falha causada ao esquecer de inserir a informação de dependência.

note: type: textblock
en: This explicit form was added in debhelper/11.3.  In previous versions, a B<-V> without any dependency information was used instead (and that form still works)
pt: Este formato explícito foi adicionado no debhelper/11.3. Nas versões anteriores, era usado em vez disto um B<-V> sem nenhuma informação de dependência (e esse formato ainda funciona).

note: type: textblock
en: The dependency will be "I<packagename>".  Note that I<None> is case-sensitive and must be written exactly as shown here.
pt: A dependência será "I<packagename>".  Note que I<None> é sensível a maiúsculas/minúsculas e tem de ser escrito exactamente como mostrado aqui.

note: type: textblock
en: This form is generally unsafe with the only exception being if upstream does not extend the ABI in any way.  However, most upstreams improve their interfaces over time and packagers are recommended to use B<-VUpstream-Version> (or one of the other forms of B<-V>I<dependencies>).
pt: Este formato é na generalidade não seguro sendo a única excepção se o autor original não estender a ABI de maneira nenhuma. No entanto, a maioria dos autores originais melhoram as suas interfaces com o passar do tempo e é recomendado que os pacotes usem B<-VUpstream-Version> (ou um dos outros formatos de B<-V>I<dependencies>).

note: type: textblock
en: Alternatively, this may be sufficient if (and only if) the package uses symbol versioning (see L<dpkg-gensymbols(1)>) and does I<not> build any udeb packages.  Note that symbols are not supported for udeb packages, which solely relies on shlibs for dependency handling.
pt: Alternativamente, isto pode ser suficiente se (e apenas se) o pacote usar versão por símbolo (veja L<dpkg-gensymbols(1)>) e I<não> compilar nenhum pacote udeb. Note que symbols não são suportados para pacotes udeb, os quais apenas se apoiam em shlibs para manuseamento das dependências.

note: type: textblock
en: In this case, the value passed to B<-V> will be used as a dependency relation.  The I<package-relation> should generally be of the form "I<some-package-name> B<(E<gt>>= I<some-package-version>B<)>".  Remember to include the package name.
pt: Neste caso, o valor passado a B<-V> irá ser usado como uma relação de dependência. O I<package-relation> deve geralmente ser do formato "I<algum-nome-pacote> B<(E<gt>>= I<alguma-versão-pacote>B<)>".  Lembre-se de incluir o nome do pacote.

note: type: textblock
en: Note that debhelper will use the value I<as it is> with no sanity checking or modification.  In I<rare special> cases, this is needed to generate a dependency on a different package than the one containing the library.
pt: Note que o debhelper irá usar o calor I<como está> sem verificações de sanidade ou modificação. Em casos I<raros e especiais>, isto é preciso para gerar uma dependência num pacote diferente daquele que contém a biblioteca.

note: type: textblock
en: When choosing a value for this option, please keep mind that if the package provides a symbols file, then that this is generally preferred over the shlibs file for regular .deb packages.  See L<dpkg-shlibdeps(1)> for more information on this topic.
pt: Quando escolher um valor para esta opção, por favor lembre-se que se o pacote fornecer um ficheiro symbols, então esse é geralmente preferido sobre o ficheiro shlibs para pacotes .deb regulares. Veja L<dpkg-shlibdeps(1)> para mais informação sobre este tópico.

note: type: textblock
en: Do not add the "ldconfig" trigger even if it seems like the package might need it.  The option is called B<--no-scripts> for historical reasons as B<dh_makeshlibs> would previously generate maintainer scripts that called B<ldconfig>.
pt: Não adiciona o trigger "ldconfig" mesmo que parece que o pacote possa precisar dele. A opção é chamada B<--no-scripts> por razões históricas pois o B<dh_makeshlibs> previamente gerava scripts do maintainer que chamavam B<ldconfig>.

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename or directory from being treated as shared libraries.
pt: Exclui ficheiros que contenham I<item> em qualquer ponto do seu nome de ficheiro ou directório de serem tratados como bibliotecas partilhadas.

note: type: textblock
en: Create an additional line for udebs in the shlibs file and use I<udeb> as the package name for udebs to depend on instead of the regular library package.
pt: Cria uma linha adicionar para udebs no ficheiro shlibs e usa I<udeb> como o nome do pacote para o udebs depender dele em vez do pacote da biblioteca normal.

note: type: textblock
en: This option is only useful for special cases such as when debhelper cannot auto-detect package name of the udeb package, when the udeb will contain libraries from multiple deb packages, or when the udeb contains libraries B<not> present in the deb package.
pt: Esta opção é apenas útil para casos especiais tais como quando o debhelper não consegue auto-detectar o nome de pacote para o pacote udeb, quando o udeb irá conter bibliotecas de múltiplos pacotes deb, ou quando o udeb contem bibliotecas B<não> presentes no pacote deb.

note: type: textblock
en: Do not add any udeb lines to the shlibs file.  This can be used to disable the default auto-detection of udebs.
pt: Não adiciona nenhumas linhas udeb ao ficheiro shlibs. Isto pode ser usado para desactivar a auto-detecção predefinida do udebs.

note: type: textblock
en: This may be useful in case you do not want a shlibs file at all for the udeb because no package will depend on it.  E.g. because adding a udeb package for the library was "overkill" and the library is embedded in a different udeb package.
pt: Isto pode ser útil caso você não queira nenhum ficheiro shlibs para o udeb porque nenhum pacote irá depender dele.  Ex. porque adicionar um pacote udeb para a biblioteca foi "exagero" e a biblioteca está embebida num pacote udeb diferente.

note: type: textblock
en: Pass I<params> to L<dpkg-gensymbols(1)>.
pt: Passa I<params> para L<dpkg-gensymbols(1)>.

note: type: verbatim
en: Assuming this is a package named F<libfoobar1>, generates a shlibs file that
    looks something like:
     libfoobar 1 libfoobar1
pt: Assumindo que este é um pacote chamado F<libfoobar1>, gera um ficheiro
    shlibs que se parece com algo como isto:
     libfoobar 1 libfoobar1

note: type: verbatim
en: Assuming the current version of the package is 1.1-3, generates a shlibs
    file that looks something like:
     libfoobar 1 libfoobar1 (>= 1.1)
pt: Assumindo que a versão actual do pacote é 1.1-3, gera um ficheiro shlibs
    que se parece com algo como isto:
     libfoobar 1 libfoobar1 (>= 1.1)

note: type: verbatim
en: Generates a shlibs file that looks something like:
      libfoobar 1 libfoobar1 (>= 1.0)
pt: Gera um ficheiro shlibs que se parece com isto:
      libfoobar 1 libfoobar1 (>= 1.0)

note: type: textblock
en: dh_md5sums - generate DEBIAN/md5sums file
pt: dh_md5sums - gera o ficheiro DEBIAN/md5sums

note: type: textblock
en: B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] [B<--include-conffiles>]
pt: B<dh_md5sums> [S<I<opções do debhelper>>] [B<-x>] [B<-X>I<item>] [B<--include-conffiles>]

note: type: textblock
en: B<dh_md5sums> is a debhelper program that is responsible for generating a F<DEBIAN/md5sums> file, which lists the md5sums of each file in the package.  These files are used by B<dpkg --verify> or the L<debsums(1)> program.
pt: B<dh_md5sums> é um programa debhelper que é responsável por gerar um ficheiro F<DEBIAN/md5sums> o qual lista os md5sums de cada ficheiro no pacote. Estes ficheiros são usados por B<dpkg --verify> ou pelo programa L<debsums(1)>.

note: type: textblock
en: All files in F<DEBIAN/> are omitted from the F<md5sums> file, as are all conffiles (unless you use the B<--include-conffiles> switch).
pt: Todos os ficheiros em F<DEBIAN/> são omitidos do ficheiro F<md5sums>, pois eles são todos ficheiros de configuração (a menos que você use o switch B<--include-conffiles>).

note: type: textblock
en: The md5sums file is installed with proper permissions and ownerships.
pt: O ficheiro md5sums é instalado com o dono e permissões apropriadas.

note: type: textblock
en: Include conffiles in the md5sums list. Note that this information is redundant since it is included in F</var/lib/dpkg/status> in Debian packages.
pt: Inclui ficheiros de configuração na lista de md5sums. Note que esta informação é redundante pois isso está incluído em F</var/lib/dpkg/status> nos pacotes Debian.

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being listed in the md5sums file.
pt: Exclui ficheiros que contêm I<item> em qualquer ponto do seu nome de ficheiro de serem listados no ficheiro md5sums.

note: type: textblock
en: dh_movefiles - move files out of debian/tmp into subpackages
pt: dh_movefiles - move ficheiros de debian/tmp para sub-pacotes

note: type: textblock
en: B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] [B<-X>I<item>] [S<I<file> ...>]
pt: B<dh_movefiles> [S<I<debhelper opções>>] [B<--sourcedir=>I<dir>] [B<-X>I<item>] [S<I<ficheiro> ...>]

note: type: textblock
en: B<dh_movefiles> is a debhelper program that is responsible for moving files out of F<debian/tmp> or some other directory and into other package build directories. This may be useful if your package has a F<Makefile> that installs everything into F<debian/tmp>, and you need to break that up into subpackages.
pt: B<dh_movefiles> é um programa debhelper que é responsável por mover ficheiros de F<debian/tmp> ou de qualquer outro directório para directórios de compilação de pacotes. Isto pode ser útil se o seu pacote tem um F<Makefile> que instala tudo em F<debian/tmp>, e você precisa dividir isso em sub-pacotes.

note: type: textblock
en: Note: B<dh_install> is a much better program, and you are recommended to use it instead of B<dh_movefiles>.
pt: Nota: B<dh_install> é um programa muito melhor, e é recomendado usa-lo em vez do B<dh_movefiles>.

note: type: =item
en: debian/I<package>.files
pt: debian/I<pacote>.files

note: type: textblock
en: Lists the files to be moved into a package, separated by whitespace. The filenames listed should be relative to F<debian/tmp/>. You can also list directory names, and the whole directory will be moved.
pt: Lista os ficheiros a serem movidos para um pacote, separados por espaços em branco. Os nomes de ficheiros listados devem ser relativos a F<debian/tmp/>. Você também pode listar nomes de directórios, e será movido o directório inteiro.

note: type: textblock
en: Instead of moving files out of F<debian/tmp> (the default), this option makes it move files out of some other directory. Since the entire contents of the sourcedir is moved, specifying something like B<--sourcedir=/> is very unsafe, so to prevent mistakes, the sourcedir must be a relative filename; it cannot begin with a `B</>'.
pt: Em vez de mover ficheiros de F<debian/tmp> (o predefinido), esta opção faz com que mova ficheiros de outro directório. Como todo o conteúdo de sourcedir é movido, especificar algo como B<--sourcedir=/> é muito inseguro, então para prevenir enganos, a sourcedir tem de ser um nome de ficheiro relativo; não pode começar com um `B</>'.

note: type: textblock
en: Exclude files that contain B<item> anywhere in their filename from being installed.
pt: Exclui de serem instalados ficheiros que tenham B<item> em qualquer ponto no seu nome de ficheiro.

note: type: textblock
en: Lists files to move. The filenames listed should be relative to F<debian/tmp/>. You can also list directory names, and the whole directory will be moved. It is an error to list files here unless you use B<-p>, B<-i>, or B<-a> to tell B<dh_movefiles> which subpackage to put them in.
pt: Lista ficheiros a mover. Os nomes de ficheiros listados devem ser relativos a F<debian/tmp/>. Você também pode listar nomes de directórios, e será movido o directório inteiro. É um erro listar ficheiros aqui a menos que você use B<-p>, B<-i>, ou B<-a> para dizer ao B<dh_movefiles> em qual sub-pacote os deve colocar.

note: type: textblock
en: Note that files are always moved out of F<debian/tmp> by default (even if you have instructed debhelper to use a compatibility level higher than one, which does not otherwise use debian/tmp for anything at all). The idea behind this is that the package that is being built can be told to install into F<debian/tmp>, and then files can be moved by B<dh_movefiles> from that directory. Any files or directories that remain are ignored, and get deleted by B<dh_clean> later.
pt: Note que os ficheiros são sempre movidos para fora de F<debian/tmp> por predefinição (mesmo que você tenha instruído o debhelper a usar um nível de compatibilidade mais alto que um, o que noutro caso não usa debian/tmp para nada). A ideia detrás disto é que pode-se dizer ao pacote que está a ser compilado para instalar em F<debian/tmp>, e depois os ficheiros podem ser movidos pelo B<dh_movefiles> desse directório. Quaisquer ficheiros ou directórios que permaneçam são ignorados, e são apagados mais tarde pelo B<dh_clean>.

note: type: textblock
en: dh_perl - calculates Perl dependencies and cleans up after MakeMaker
pt: dh_perl - calcula as dependências de Perl e limpa após MakeMaker

note: type: textblock
en: B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]
pt: B<dh_perl> [S<I<opções do debhelper>>] [B<-d>] [S<I<directórios de bibliotecas> ...>]

note: type: textblock
en: B<dh_perl> is a debhelper program that is responsible for generating the B<${perl:Depends}> substitutions and adding them to substvars files.
pt: B<dh_perl> é um programa debhelper que é responsável por gerar as substituições B<${perl:Depends}> e adiciona-las aos ficheiros substvars.

note: type: textblock
en: The program will look at Perl scripts and modules in your package, and will use this information to generate a dependency on B<perl> or B<perlapi>. The dependency will be substituted into your package's F<control> file wherever you place the token B<${perl:Depends}>.
pt: Este programa irá procurar scripts e módulos Perl no seu pacote, e irá usar esta informação para gerar uma dependência em B<perl> ou B<perlapi>. A dependência irá ser substituída no ficheiro F<control> do seu pacote onde você colocar o token B<${perl:Depends}>.

note: type: textblock
en: B<dh_perl> also cleans up empty directories that MakeMaker can generate when installing Perl modules.
pt: B<dh_perl> também limpa directórios vazios que o MakeMaker pode gerar quando instala módulos Perl.

note: type: textblock
en: In some specific cases you may want to depend on B<perl-base> rather than the full B<perl> package. If so, you can pass the -d option to make B<dh_perl> generate a dependency on the correct base package. This is only necessary for some packages that are included in the base system.
pt: Nalguns casos específicos você pode querer depender de B<perl-base> em vez do pacote B<perl> completo. Se sim, você pode passar a opção -d para fazer o B<dh_perl> gerar uma dependência no pacote base actual. Isto é apenas necessário para alguns pacotes que estão incluídos no sistema base.

note: type: textblock
en: Note that this flag may cause no dependency on B<perl-base> to be generated at all. B<perl-base> is Essential, so its dependency can be left out, unless a versioned dependency is needed.
pt: Note que esta bandeira pode fazer com que não seja gerada nenhuma dependência em B<perl-base> de todo. O B<perl-base> é Essencial, então a sua dependência pode ser deixada de fora, a menos que seja necessária uma dependência de determinada versão.

note: type: textblock
en: By default, scripts and architecture independent modules don't depend on any specific version of B<perl>. The B<-V> option causes the current version of the B<perl> (or B<perl-base> with B<-d>) package to be specified.
pt: Por predefinição, os scripts e módulos independentes da arquitectura não dependem de nenhuma versão específica de B<perl>. A opção B<-V> faz com que seja especificada a versão actual do pacote B<perl> (ou B<perl-base> com B<-d>).

note: type: =item
en: I<library dirs>
pt: I<directórios de bibliotecas>

note: type: textblock
en: If your package installs Perl modules in non-standard directories, you can make B<dh_perl> check those directories by passing their names on the command line. It will only check the F<vendorlib> and F<vendorarch> directories by default.
pt: Se o seu pacote instalar módulos Perl em directórios não-standard, você pode fazer o B<dh_perl> verificar esses directórios ao passar os seus nomes na linha de comandos. Por predefinição, ele só irá verificar os directórios F<vendorlib> e F<vendorarch>.

note: type: textblock
en: Debian policy, version 3.8.3
pt: Debian policy, versão 3.8.3

note: type: textblock
en: Perl policy, version 1.20
pt: Perl policy, versão 1.20

note: type: textblock
en: dh_prep - perform cleanups in preparation for building a binary package
pt: dh_prep - executa limpezas em preparação para a compilação de um pacote binário.

note: type: textblock
en: B<dh_prep> [S<I<debhelper options>>] [B<-X>I<item>]
pt: B<dh_prep> [S<I<debhelper opções>>] [B<-X>I<item>]

note: type: textblock
en: B<dh_prep> is a debhelper program that performs some file cleanups in preparation for building a binary package. (This is what B<dh_clean -k> used to do.) It removes the package build directories, F<debian/tmp>, and some temp files that are generated when building a binary package.
pt: B<dh_prep> é um programa debhelper que executa algumas limpezas de ficheiros em preparação para compilar um pacote binário. (Isto é o que B<dh_clean -k> costumava fazer.) Remove os directórios de compilação do pacote, F<debian/tmp>, e alguns ficheiros temporários que são gerados quando se compila um pacote binário.

note: type: textblock
en: It is typically run at the top of the B<binary-arch> and B<binary-indep> targets, or at the top of a target such as install that they depend on.
pt: Corre tipicamente no topo dos alvos B<binary-arch> e B<binary-indep>, ou no topo de um alvo tal que instala o que eles dependem de.

note: type: textblock
en: Exclude files that contain F<item> anywhere in their filename from being deleted, even if they would normally be deleted. You may use this option multiple times to build up a list of things to exclude.
pt: Exclui ficheiros que contenham F<item> em qualquer ponto do seu nome de ficheiro de serem apagados, mesmo se estes fossem normalmente apagados. Você pode usar esta opção várias vezes para construir uma lista de coisas a excluir.

note: type: textblock
en: dh_shlibdeps - calculate shared library dependencies
pt: dh_shlibdeps - calcula dependências de bibliotecas partilhadas

note: type: textblock
en: B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] [B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]
pt: B<dh_shlibdeps> [S<I<debhelper opções>>] [B<-L>I<pacote>] [B<-l>I<directório>] [B<-X>I<item>] [S<B<--> I<params>>]

note: type: textblock
en: B<dh_shlibdeps> is a debhelper program that is responsible for calculating shared library dependencies for packages.
pt: B<dh_shlibdeps> é um programa debhelper que é responsável por calcular dependências de bibliotecas partilhadas para os pacotes.

note: type: textblock
en: This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it once for each package listed in the F<control> file, passing it a list of ELF executables and shared libraries it has found.
pt: Este programa é meramente um wrapper em volta de L<dpkg-shlibdeps(1)> que o chama uma vez por cada pacote listado no ficheiro de F<control>, passando-lhe uma lista de executáveis ELF e bibliotecas partilhadas que encontrou.

note: type: textblock
en: Exclude files that contain F<item> anywhere in their filename from being passed to B<dpkg-shlibdeps>. This will make their dependencies be ignored.  This may be useful in some situations, but use it with caution. This option may be used more than once to exclude more than one thing.
pt: Exclui ficheiros que contêm F<item> em qualquer ponto do seu nome de ficheiro de serem passados ao B<dpkg-shlibdeps>. Isto fará as suas dependências serem ignoradas. Isto pode ser útil em algumas situações, mas use com cuidado. Esta opção pode ser usada mais do que uma vez para se excluir mais do que uma coisa.

note: type: textblock
en: Pass I<params> to L<dpkg-shlibdeps(1)>.
pt: Passa I<params> para L<dpkg-shlibdeps(1)>.

note: type: textblock
en: This is another way to pass I<params> to L<dpkg-shlibdeps(1)>.  It is deprecated; use B<--> instead.
pt: Esta é outra maneira de passar I<params> para L<dpkg-shlibdeps(1)>. Está descontinuado, use B<--> em vez deste.

note: type: =item
en: B<-l>I<directory>[B<:>I<directory> ...]
pt: B<-l>I<directório>[B<:>I<directório> ...]

note: type: textblock
en: With recent versions of B<dpkg-shlibdeps>, this option is generally not needed.
pt: Com versões recentes do B<dpkg-shlibdeps>, esta opção geralmente não é necessária.

note: type: textblock
en: It tells B<dpkg-shlibdeps> (via its B<-l> parameter), to look for private package libraries in the specified directory (or directories -- separate with colons). With recent versions of B<dpkg-shlibdeps>, this is mostly only useful for packages that build multiple flavors of the same library, or other situations where the library is installed into a directory not on the regular library search path.
pt: Diz ao B<dpkg-shlibdeps> (via seu parâmetro B<-l>), para procurar bibliotecas em pacotes privados no directório especificado (ou directórios -- separados por dois pontos ":"). Com versões recentes do B<dpkg-shlibdeps>, na maioria dos casos isto é apenas útil para pacotes que compilam múltiplos sabores da mesma biblioteca, ou noutras situações onde a biblioteca é instalada num directório que não fica caminho normal de busca de bibliotecas.

note: type: =item
en: B<-L>I<package>, B<--libpackage=>I<package>
pt: B<-L>I<pacote>, B<--libpackage=>I<pacote>

note: type: textblock
en: With recent versions of B<dpkg-shlibdeps>, this option is generally not needed, unless your package builds multiple flavors of the same library or is relying on F<debian/shlibs.local> for an internal library.
pt: Com versões recentes do B<dpkg-shlibdeps>, esta opção geralmente não é necessária, a menos que o seu pacote compile múltiplos "sabores" da mesma biblioteca ou confie em F<debian/shlibs.local> para uma biblioteca interna.

note: type: textblock
en: It tells B<dpkg-shlibdeps> (via its B<-S> parameter) to look first in the package build directory for the specified package, when searching for libraries, symbol files, and shlibs files.
pt: Diz ao B<dpkg-shlibdeps> (via seu parâmetro B<-S>), para procurar primeiro no directório de compilação do pacote para o pacote específico, quando procura por bibliotecas, ficheiros de símbolos, e ficheiros shlibs.

note: type: textblock
en: If needed, this can be passed multiple times with different package names.
pt: Se necessário, isto pode ser passado várias vezes com diferentes nomes de pacotes.

note: type: textblock
en: Suppose that your source package produces libfoo1, libfoo-dev, and libfoo-bin binary packages. libfoo-bin links against libfoo1, and should depend on it. In your rules file, first run B<dh_makeshlibs>, then B<dh_shlibdeps>:
pt: Supondo que o seu pacote fonte produz os pacotes binários libfoo1, libfoo-dev, e libfoo-bin. O libfoo-bin faz link contra libfoo1, e deve depender dele. No seu ficheiro de regras, primeiro corra B<dh_makeshlibs>, e depois B<dh_shlibdeps>:

note: type: textblock
en: This will have the effect of generating automatically a shlibs file for libfoo1, and using that file and the libfoo1 library in the F<debian/libfoo1/usr/lib> directory to calculate shared library dependency information.
pt: Isto terá o efeito de gerar automaticamente um ficheiro shlibs para libfoo1, e usando esse ficheiro e a biblioteca libfoo1 no directório <debian/libfoo1/usr/lib> serve para calcular informação de dependência de biblioteca partilhada.

note: type: textblock
en: If a libbar1 package is also produced, that is an alternate build of libfoo, and is installed into F</usr/lib/bar/>, you can make libfoo-bin depend on libbar1 as follows:
pt: Se for também produzido um pacote libbar1, isso é uma compilação alternativa de libfoo, e é instalado em F</usr/lib/bar/>, você pode tornar libfoo-bin dependente de libbar1 como se segue:

note: type: textblock
en: dh_strip - strip executables, shared libraries, and some static libraries
pt: dh_strip - despoja executáveis, bibliotecas partilhas, e algumas bibliotecas estáticas

note: type: textblock
en: B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] [B<--dbg-package=>I<package>] [B<--keep-debug>]
pt: B<dh_strip> [S<I<debhelper opções>>] [B<-X>I<item>] [B<--dbg-package=>I<pacote>] [B<--keep-debug>]

note: type: textblock
en: B<dh_strip> is a debhelper program that is responsible for stripping out debug symbols in executables, shared libraries, and static libraries that are not needed during execution.
pt: B<dh_strip> é um programa debhelper que é responsável por retirar símbolos de depuração em executáveis, bibliotecas partilhadas, e bibliotecas estáticas que não são necessárias durante a execução.

note: type: textblock
en: This program examines your package build directories and works out what to strip on its own. It uses L<file(1)> and file permissions and filenames to figure out what files are shared libraries (F<*.so>), executable binaries, and static (F<lib*.a>) and debugging libraries (F<lib*_g.a>, F<debug/*.so>), and strips each as much as is possible. (Which is not at all for debugging libraries.) In general it seems to make very good guesses, and will do the right thing in almost all cases.
pt: Este programa examina os seus directórios de compilação de pacotes e decide sozinho o que despojar. Usa o L<file(1)>, as permissões de ficheiros e os nomes dos ficheiros para descobrir quais ficheiros são bibliotecas partilhadas (F<*.so>), binários executáveis, e bibliotecas estáticas (F<lib*.a>) e de depuração (F<lib*_g.a>, F<debug/*.so>), e despoja cada um o máximo possível. (O que não é de todo para bibliotecas de depuração.) Em geral parece acertar muito bem nos ficheiros, e fará o trabalha certo em quase todos os casos.

note: type: textblock
en: Since it is very hard to automatically guess if a file is a module, and hard to determine how to strip a module, B<dh_strip> does not currently deal with stripping binary modules such as F<.o> files.
pt: Como é muito difícil perceber automaticamente se um ficheiro é um módulo, e difícil determinar como despojar um módulo, o B<dh_strip> presentemente não lida com o despojar de módulos binários como os ficheiros F<.o>.

note: type: =item
en: B<--dbg-package=>I<package>
pt: B<--dbg-package=>I<pacote>

note: type: textblock
en: B<This option is a now special purpose option that you normally do not need>.  In most cases, there should be little reason to use this option for new source packages as debhelper automatically generates debug packages ("dbgsym packages").  B<If you have a manual --dbg-package> that you want to replace with an automatically generated debug symbol package, please see the B<--dbgsym-migration> option.
pt: B<Esta opção é agora uma opção de objectivo especial que normalmente você não precisa>. Na maioria dos casos, deverá haver poucas razões para usar esta opção para novos pacotes fonte pois o debhelper gera automaticamente pacotes de depuração (pacotes "dbgsym"). B<Se você tem um --dbg-package manual> que deseja substituir por um pacote de símbolos de depuração gerado automaticamente, por favor veja a opção B<--dbgsym-migration>.

note: type: textblock
en: Causes B<dh_strip> to save debug symbols stripped from the packages it acts on as independent files in the package build directory of the specified debugging package.
pt: Faz o B<dh_strip> salvar os símbolos de depuração despojados dos pacotes em que actua como ficheiros independentes no directório de compilação do pacote do pacote de depuração especificado.

note: type: textblock
en: For example, if your packages are libfoo and foo and you want to include a I<foo-dbg> package with debugging symbols, use B<dh_strip --dbg-package=>I<foo-dbg>.
pt: Por exemplo, se os seus pacotes são libfoo e foo e você deseja incluir um pacote I<foo-dbg> com símbolos de depuração, use B<dh_strip --dbg-package=>I<foo-dbg>.

note: type: textblock
en: This option implies B<--no-automatic-dbgsym> and I<cannot> be used with B<--automatic-dbgsym> or B<--dbgsym-migration>.
pt: Esta opção implica que B<--no-automatic-dbgsym> e I<não pode> ser usado com B<--automatic-dbgsym> ou B<--dbgsym-migration>.

note: type: textblock
en: Debug symbols will be retained, but split into an independent file in F<usr/lib/debug/> in the package build directory. B<--dbg-package> is easier to use than this option, but this option is more flexible.
pt: Os símbolos de depuração serão retidos, e separados para um ficheiro independente em F<usr/lib/debug/> no directório de compilação do pacote. B<--dbg-package> é mais fácil de usar que esta opção, mas esta opção é mais flexível.

note: type: textblock
en: This option implies B<--no-automatic-dbgsym> and I<cannot> be used with B<--automatic-dbgsym>.
pt: Esta opção implica que B<--no-automatic-dbgsym> e I<cannot> seja usado com B<--automatic-dbgsym>.

note: type: textblock
en: This option is used to migrate from a manual "-dbg" package (created with B<--dbg-package>) to an automatic generated debug symbol package. This option should describe a valid B<Replaces>- and B<Breaks>-relation, which will be added to the debug symbol package to avoid file conflicts with the (now obsolete) -dbg package.
pt: Esta opção é usada para migrar de um pacote "-dbg" manual (criado com B<--dbg-package>) para um pacote de símbolos de depuração gerado automaticamente. Esta opção deve descrever uma relação B<Replaces>- e B<Breaks> válida, a qual será adicionada ao pacote de símbolos de depuração para evitar conflitos de ficheiros com o pacote -dbg (agora obsoleto).

note: type: textblock
en: This option implies B<--automatic-dbgsym> and I<cannot> be used with B<--keep-debug>, B<--dbg-package> or B<--no-automatic-dbgsym>.
pt: Esta opção implica que B<--automatic-dbgsym> e I<cannot> seja usado com B<--keep-debug>, B<--dbg-package> ou B<--no-automatic-dbgsym>.

note: type: textblock
en: Examples:
pt: Exemplos:

note: type: textblock
en: Control whether B<dh_strip> should be creating debug symbol packages when possible.
pt: Controla se o B<dh_strip> deve criar pacotes de símbolos de depuração quando possível.

note: type: textblock
en: The default is to create debug symbol packages.
pt: A predefinição é criar pacotes de símbolos de depuração.

note: type: textblock
en: Historical name for B<--automatic-dbgsym> and B<--no-automatic-dbgsym>.
pt: Nome histórico para B<--automatic-dbgsym> e B<--no-automatic-dbgsym>.

note: type: textblock
en: Historical name for B<--dbgsym-migration>.
pt: Nome histórico para B<--dbgsym-migration>.

note: type: textblock
en: If the B<DEB_BUILD_OPTIONS> environment variable contains B<nostrip>, nothing will be stripped, in accordance with Debian policy (section 10.1 "Binaries").  This will also inhibit the automatic creation of debug symbol packages.
pt: Se a variável de ambiente B<DEB_BUILD_OPTIONS> conter B<nostrip>,  nada será despojado, em conformidade com a política Debian (secção 10.1 "Binários"). Isto irá também inibir a criação automática de pacotes de símbolos de depuração.

note: type: textblock
en: The automatic creation of debug symbol packages can also be prevented by adding B<noautodbgsym> to the B<DEB_BUILD_OPTIONS> environment variable.  However, B<dh_strip> will still add debuglinks to ELF binaries when this flag is set.  This is to ensure that the regular deb package will be identical with and without this flag (assuming it is otherwise "bit-for-bit" reproducible).
pt: A criação automática de pacotes de símbolos de depuração também pode ser prevenida ao adicionar B<noautodbgsym> à variável de ambiente B<DEB_BUILD_OPTIONS>. No entanto, B<dh_strip> irá na mesma adicionar debuglinks aos binários ELF quando a bandeira estiver definida. Isto não garante que o pacote deb regular irá ser idêntico com e sem esta bandeira (assumindo que é caso contrário reproduzível "bit por bit".

note: type: textblock
en: Debian policy, version 3.0.1
pt: Debian policy, versão 3.0.1

note: type: textblock
en: dh_testdir - test directory before building Debian package
pt: dh_testdir - testa o directório antes de compilar o pacote Debian

note: type: textblock
en: B<dh_testdir> [S<I<debhelper options>>] [S<I<file> ...>]
pt: B<dh_testdir> [S<I<debhelper opções>>] [S<I<ficheiro> ...>]

note: type: textblock
en: B<dh_testdir> tries to make sure that you are in the correct directory when building a Debian package. It makes sure that the file F<debian/control> exists, as well as any other files you specify. If not, it exits with an error.
pt: B<dh_testdir> tenta certificar que você está no directório correcto quando compila um pacote Debian. Ele certifica que o ficheiro F<debian/control> existe, assim como quaisquer outros ficheiros que você especificar. Se não, termina com um erro.

note: type: textblock
en: Test for the existence of these files too.
pt: Testa também a existência destes ficheiros.

note: type: textblock
en: dh_testroot - ensure that a package is built with necessary level of root permissions
pt: dh_testroot - assegura que um pacote é compilado com o nível necessário de permissões de root.

note: type: textblock
en: B<dh_testroot> [S<I<debhelper options>>]
pt: B<dh_testroot> [S<I<debhelper opções>>]

note: type: textblock
en: B<dh_testroot> is used to determine if the target is being run with suffient access to root(-like) features.
pt: B<dh_testroot> é usado para determinar se um alvo está a ser corrido com acesso suficiente a funcionalidades de (tipo-)root.

note: type: textblock
en: The definition of sufficient access depends on whether the builder (the tool invoking the F<debian/rules> target) supports the I<Rules-Requires-Root> (R³) field.  If the builder supports R³, then it will set the environment variable I<DEB_RULES_REQUIRES_ROOT> and B<dh_testroot> will validate that the builder followed the minimum requirements for the given value of I<DEB_RULES_REQUIRES_ROOT>.
pt: A definição de acesso suficiente depende em se o construtor (a ferramenta que invoca o alvo F<debian/rules>) suporta o campo I<Rules-Requires-Root> (R³). Se o construtor suportar R³, então irá regular a variável de ambiente I<DEB_RULES_REQUIRES_ROOT> e B<dh_testroot> irá validar que o construtor seguiu os requerimentos mínimos para a valor fornecido de I<DEB_RULES_REQUIRES_ROOT>.

note: type: textblock
en: If the builder does not support I<Rules-Requires-Root>, then it will not set the I<DEB_RULES_REQUIRES_ROOT> environment variable.  This will in turn make B<dh_testroot> (and the rest of debhelper) fall back to assuming that (fake)root is implied.
pt: Se o construtor não suportar I<Rules-Requires-Root>, então não irá regular a variável de ambiente I<DEB_RULES_REQUIRES_ROOT>. Isto irá fazer com que B<dh_testroot> (e o resto do debhelper) recorra a assumir que é implicado (fake)root.

note: type: textblock
en: The following is a summary of how B<dh_testroot> behaves based on the I<DEB_RULES_REQUIRES_ROOT> environment variable (leading and trailing whitespace in the variable is ignored).
pt: O seguinte é um sumário de como B<dh_testroot> se comporta baseado na variável de ambiente I<DEB_RULES_REQUIRES_ROOT> (os espaços em branco no inicio e no final na variável são ignorados).

note: type: textblock
en: If unset, or set to C<binary-targets>, then B<dh_testroot> asserts that it is run as root or under L<fakeroot(1)>.
pt: Se não definido, ou definido para C<binary-targets>, então B<dh_testroot> deduz que é corrido como root ou sob L<fakeroot(1)>.

note: type: textblock
en: If set to C<no>, then B<dh_testroot> returns successfully (without performing any additional checks).
pt: Se definido para C<no>, então B<dh_testroot> retorna com sucesso (sem executar nenhuma verificação adicional).

note: type: textblock
en: If set to any other value than the above, then B<dh_testroot> asserts that it is either run as root (or under L<fakeroot(1)>) or the builder has provided the B<DEB_GAIN_ROOT_CMD> environment variable (e.g. via dpkg-buildpackage -r).
pt: Se definido para qualquer outro valor que o de cima, então B<dh_testroot> declara que ou é corrido como root (ou sob L<fakeroot(1)>) ou o construtor disponibilizou a variável de ambiente B<DEB_GAIN_ROOT_CMD> (ex. via dpkg-buildpackage -r).

note: type: textblock
en: Please note that B<dh_testroot> does I<not> read the I<Rules-Requires-Root> field.  Which implies that B<dh_testroot> may produce incorrect result if the builder lies in I<DEB_RULES_REQUIRES_ROOT>.  On the flip side, it also enables things like testing for what will happen when I<DEB_RULES_REQUIRES_ROOT> is set to a given value.
pt: Por favor note que B<dh_testroot> I<não> lê o campo I<Rules-Requires-Root>. O que implica que B<dh_testroot> pode produzir resultados incorrectos se o construtor apoiar-se em I<DEB_RULES_REQUIRES_ROOT>. Por outro lado, também activa coisas como testar o que irá acontecer quando I<DEB_RULES_REQUIRES_ROOT> está definida para um determinado valor.

note: type: textblock
en: dh_usrlocal - migrate usr/local directories to maintainer scripts
pt: dh_usrlocal - migra directórios usr/local para scripts de maintainer.

note: type: textblock
en: B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]
pt: B<dh_usrlocal> [S<I<debhelper opções>>] [B<-n>]

note: type: textblock
en: B<dh_usrlocal> is a debhelper program that can be used for building packages that will provide a subdirectory in F</usr/local> when installed.
pt: B<dh_usrlocal> é um programa debhelper que pode ser usado para compilar pacotes que disponibilizam um sub-directório em F</usr/local> quando instalados.

note: type: textblock
en: It finds subdirectories of F<usr/local> in the package build directory, and removes them, replacing them with maintainer script snippets (unless B<-n> is used) to create the directories at install time, and remove them when the package is removed, in a manner compliant with Debian policy. These snippets are inserted into the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of debhelper maintainer script snippets.
pt: Encontra sub-directórios de F<usr/local> no directório de compilação do pacote, e remove-os, substituindo-os por fragmentos de script de maintainer (a menos que seja usado B<-n>) para criar os directórios durante a instalação, e remove-los quando o pacote é removido, num modo em conformidade com a política Debian. Estes fragmentos são inseridos nos scripts de maintainer pelo B<dh_installdeb>. Veja L<dh_installdeb(1)> para uma explicação sobre fragmentos de scripts de maintainer do debhelper.

note: type: textblock
en: When the I<DEB_RULES_REQUIRES_ROOT> environment variable is not (effectively)  I<binary-targets>, the directories in F</usr/local> will be handled as if they were owned by root:root (see below).
pt: Quando a variável de ambiente I<DEB_RULES_REQUIRES_ROOT> não é (efectivamente)  I<binary-targets>, os directórios em F</usr/local> serão lidados como se fossem da posse de root:root (veja em baixo).

note: type: textblock
en: When the I<DEB_RULES_REQUIRES_ROOT> environment variable has an effective value of I<binary-targets>, the owners, groups and permissions will be preserved with the sole exception where the directory is owned by root:root.
pt: Quando a variável de ambiente I<DEB_RULES_REQUIRES_ROOT> tem um valor efectivo de I<binary-targets>, então donos, grupos e permissões serão preservados com a única excepção onde o directório é da posse de root:root.

note: type: textblock
en: If a directory is owned by root:root, then ownership will be determined at install time.  The ownership and permission bits will either be root:root mode 0755 or root:staff mode 02775.  The actual choice depends on whether the system has F</etc/staff-group-for-usr-local> (as documented in the Debian Policy Manual §9.1.2 since version 4.1.4)
pt: Se um directório é da posse de root:root, então o dono é determinado na altura da instalação. Os bits de posse e permissões irão ser ou root:root modo 0755 ou root:staff modo 02775.  A escolha depende em se o sistema tem F</etc/staff-group-for-usr-local> (como documentado no Manual de Política Debian §9.1.2 desde a versão 4.1.4)

note: type: textblock
en: Debian policy, version 2.2
pt: Debian policy, versão 2.2

note: type: textblock
en: dh_systemd_enable - enable/disable systemd unit files
pt: dh_systemd_enable - activa/desactiva ficheiros unit do systemd

note: type: textblock
en: B<dh_systemd_enable> is a debhelper program that is responsible for enabling and disabling systemd unit files.
pt: B<dh_systemd_enable>é um programa debhelper que é responsável por activar e desactivar ficheiros unit do systemd.

note: type: textblock
en: In the simple case, it finds all unit files installed by a package (e.g.  bacula-fd.service) and enables them. It is not necessary that the machine actually runs systemd during package installation time, enabling happens on all machines in order to be able to switch from sysvinit to systemd and back.
pt: Num caso simples, encontra todos os ficheiros unit instados por um pacote (ex. bacula-fd.service) e activa-os. Não é necessário que a máquina esteja realmente a correr o systemd durante o tempo da instalação do pacote, a activação acontece em todas as máquinas de modo a ser possível mudar de sysvinit para systemd e vice-versa.

note: type: textblock
en: In the complex case, you can call B<dh_systemd_enable> and B<dh_systemd_start> manually (by overwriting the debian/rules targets) and specify flags per unit file. An example is colord, which ships colord.service, a dbus-activated service without an [Install] section. This service file cannot be enabled or disabled (a state called "static" by systemd) because it has no [Install] section. Therefore, running dh_systemd_enable does not make sense.
pt: Num caso complexo, você pode chamar B<dh_systemd_enable> e B<dh_systemd_start> manualmente (ao sobrescrever os alvos debian/rules) e especificar bandeiras por cada ficheiro unit. Um exemplo é colord, o qual contém o serviço colord, um serviço dbus-activated sem uma secção [Install]. Este ficheiro de serviço não pode ser activado ou desactivado (um estado chamado "static" pelo systemd) porque não tem nenhuma secção [Install]. Assim sendo, correr dh_systemd_enable não faz qualquer sentido.

note: type: textblock
en: For only generating blocks for specific service files, you need to pass them as arguments, e.g. B<dh_systemd_enable quota.service> and B<dh_systemd_enable --name=quotarpc quotarpc.service>.
pt: Para apenas gerar blocos para ficheiros de serviço específicos, você precisa de passa-los como argumentos, exemplos B<dh_systemd_enable quota.service> e B<dh_systemd_enable --name=quotarpc quotarpc.service>.

note: type: textblock
en: If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in the package build directory.
pt: Se isto existir, está instalado em usr/lib/tmpfiles.d/I<pacote>.conf no directório de compilação do pacote.

note: type: textblock
en: Disable the service(s) on purge, but do not enable them on install.
pt: Desactiva serviço(s) durante a purga, mas não os activa na instalação.

note: type: textblock
en: B<Note> that this option does not affect whether the services are started.  That is controlled by L<dh_systemd_start(1)> (using e.g. its B<--no-start> option).
pt: B<Note> que esta opção não afecta se os serviços são arrancados. Isso é controlado por L<dh_systemd_start(1)> (usando por exemplo a sua opção B<--no-start>).

note: type: textblock
en: Install the service file as I<name.service> instead of the default filename, which is the I<package.service>. When this parameter is used, B<dh_systemd_enable> looks for and installs files named F<debian/package.name.service> instead of the usual F<debian/package.service>.
pt: Instala o ficheiro de serviço como I<nome.serviço> em vez do nome de ficheiro predefinido, o qual é I<pacote.serviço> Quando este parâmetro é usado, o B<dh_systemd_enable> procura e instala ficheiros chamados F<debian/pacote.nome.serviço> em vez do habitual F<debian/pacote.serviço>.

note: type: textblock
en: Note that this command is not idempotent. L<dh_prep(1)> should be called between invocations of this command (with the same arguments). Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.
pt: Note que este comando não é idempotente. O L<dh_prep(1)> deve ser chamado entre invocações deste comando (com os mesmos argumentos). Caso contrário, pode causar múltiplas instâncias do mesmo texto a ser adicionado aos scripts do maintainer.

note: type: textblock
en: Note that B<dh_systemd_enable> should be run before B<dh_installinit>.  The default sequence in B<dh> does the right thing, this note is only relevant when you are calling B<dh_systemd_enable> manually.
pt: Note que B<dh_systemd_enable> deve correr antes de B<dh_installinit>. A sequência predefinida em B<dh> faz o correcto, esta nota é apenas relevante quando você está a chamar B<dh_systemd_enable> manualmente.

note: type: textblock
en: dh_systemd_start - start/stop/restart systemd unit files
pt: dh_systemd_start - faz start/stop/restart aos ficheiros unit do systemd

note: type: textblock
en: B<dh_systemd_start> is a debhelper program that is responsible for starting/stopping or restarting systemd unit files in case no corresponding sysv init script is available.
pt: B<dh_systemd_start> é um programa debhelper que é responsável por arrancar/parar ou reiniciar ficheiros unit do systemd no caso de não estar disponível nenhum script sysv init correspondente.

note: type: textblock
en: As with B<dh_installinit>, the unit file is stopped before upgrades and started afterwards (unless B<--restart-after-upgrade> is specified, in which case it will only be restarted after the upgrade).  This logic is not used when there is a corresponding SysV init script because invoke-rc.d performs the stop/start/restart in that case.
pt: Como com B<dh_installinit>, o ficheiro unit é parado antes das actualizações e arrancado depois (a menos que B<--restart-after-upgrade> seja especificado, onde neste caso será apenas reiniciado após a actualização). Esta lógica não é usada quando existe um script de iniciação de SysV correspondente porque invoke-rc.d executa o stop/start/restart nesse caso.

note: type: textblock
en: Do not stop the unit file until after the package upgrade has been completed.  This is the default behaviour in compat 10.
pt: Não para o ficheiro unit até que a actualização do pacote esteja completa. Este é o comportamento predefinido no nível de compatibilidade 10.

note: type: textblock
en: In earlier compat levels the default was to stop the unit file in the F<prerm>, and start it again in the F<postinst>.
pt: Nos níveis de compatibilidade anteriores a predefinição era parar o ficheiro unit no F<prerm>, e arranca-lo de novo no F<postinst>.t>.

note: type: textblock
en: Do not stop service on upgrade.
pt: Não para o serviço durante uma actualização.

note: type: textblock
en: Do not start the unit file after upgrades and after initial installation (the latter is only relevant for services without a corresponding init script).
pt: Não arranca o ficheiro unit após actualizações e após a instalação inicial (o seguinte é apenas relevante para serviços sem um script init correspondente).

note: type: textblock
en: Note that B<dh_systemd_start> should be run after B<dh_installinit> so that it can detect corresponding SysV init scripts. The default sequence in B<dh> does the right thing, this note is only relevant when you are calling B<dh_systemd_start> manually.
pt: Note que B<dh_systemd_start> deve correr após B<dh_installinit> para que possa detectar scripts init do SysV correspondentes. A sequência predefinida em B<dh> faz o correcto, esta nota é apenas relevante quando você está a chamar B<dh_systemd_start> manualmente.

note: type: textblock
en: This compatibility level is open for beta testing; changes may occur.
pt: Este nível de compatibilidade está aberto para testes beta: podem ocorrer alterações.
