.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "debhelper 7" .TH debhelper 7 "2021-03-06" "13.3.4" "Debhelper" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOME" .IX Header "NOME" debhelper \- a suite de ferramentas debhelper .SH "RESUMO" .IX Header "RESUMO" \&\fBdh_\fR\fI*\fR [\fB\-v\fR] [\fB\-a\fR] [\fB\-i\fR] [\fB\-\-no\-act\fR] [\fB\-p\fR\fIpackage\fR] [\fB\-N\fR\fIpackage\fR] [\fB\-P\fR\fItmpdir\fR] .SH "DESCRIÇÃO" .IX Header "DESCRIÇÃO" Debhelper é usado para ajudá\-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 \fIdebian/rules\fR 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. .PP Um ficheiro \fIdebian/rules\fR típico que usa debhelper irá chamar vários comandos debhelper em sequência, ou usar \fBdh\fR\|(1) para automatizar este processo. Em \fI/usr/share/doc/debhelper/examples/\fR estão exemplos de ficheiros de regras que usam debhelper. .PP Para criar um novo pacote Debian usando o debhelper, você pode copiar um dos ficheiros de regras exemplo e editá\-lo à mão. Ou pode tentar o pacote \&\fBdh-make\fR, o qual contém um comando dh_make que automatiza parcialmente o processo Para uma introdução mais gentil, o pacote Debian \&\fBmaint-guide\fR contém um tutorial acerca de como fazer o seu primeiro pacote usando o debhelper. .PP 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 \fIdebian/control\fR quando necessário. .SH "COMANDOS DO DEBHELPER" .IX Header "COMANDOS DO DEBHELPER" Aqui está a lista dos comandos debhelper que você pode usar. Veja os seus manuais para documentação adicional. .Sp .RS 4 #LISTA# .RE .SS "Comandos Descontinuados" .IX Subsection "Comandos Descontinuados" Alguns comandos debhelper estão descontinuados e não devem ser usados. .Sp .RS 4 #LISTA_DE_DESCONTINUADOS# .RE .SS "Outros comandos" .IX Subsection "Outros comandos" Se o nome dum programa começa com \fBdh_\fR, 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. .SH "FICHEIROS DE CONFIGURAÇÃO DO DEBHELPER" .IX Header "FICHEIROS DE CONFIGURAÇÃO DO DEBHELPER" Muitos comandos do debhelper usam ficheiros em \fIdebian/\fR para controlar o que fazem. Para além dos comuns \fIdebian/changelog\fR e \fIdebian/control\fR, 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/\fIpacote\fR.foo (onde \fIpacote\fR é claro, é substituído pelo nome do pacote no qual se está a actuar). .PP Por exemplo, \fBdh_installdocs\fR usa ficheiros chamados \fIdebian/package.docs\fR 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. .PP Nota para o primeiro (ou único) pacote binário listado em \fIdebian/control\fR, o debhelper irá usar \fIdebian/foo\fR quando não existe nenhum ficheiro \&\fIdebian/\fIpackage\fI.foo\fR. No entanto, é geralmente uma boa ideia manter o prefixo \fI\fIpackage\fI.\fR pois é mais explícito. A principal excepção a isto são ficheiro que o debhelper instala por predefinição em todos os pacotes binários quando não tem um prefixo de pacote (tal como \fIdebian/copyright\fR ou \fIdebian/changelog\fR). .PP Em alguns casos raros, você pode querer ter versões diferentes destes ficheiros para arquitecturas ou sistemas operativos diferentes. Se existirem ficheiros chamados debian/\fIpacote\fR.foo.\fI\s-1ARCH\s0\fR ou debian/\fIpacote\fR.foo.\fI\s-1OS\s0\fR, onde \fI\s-1ARCH\s0\fR e \fI\s-1OS\s0\fR são o mesmo que o resultado de "\fBdpkg-architecture \-qDEB_HOST_ARCH\fR\*(L" / \*(R"\fBdpkg-architecture \&\-qDEB_HOST_ARCH_OS\fR", então eles irão ser usados em preferência de outros ficheiros mais gerais. .PP 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 \*(L"wildcard\*(R" de shell standard (classes de caracteres \fB?\fR e \fB*\fR e \fB[\fR\fI..\fR\fB]\fR) nos ficheiros. Também pode meter comentários neste ficheiros; as linhas começadas com \fB#\fR são ignoradas. .PP A sintaxe destes ficheiros é mantida intencionalmente muito simples para os tornar fáceis de ler, compreender e modificar. .SS "Substituições em ficheiros de configuração do debhelper" .IX Subsection "Substituições em ficheiros de configuração do debhelper" 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: .IP "\(bu" 4 dh_clean .IP "\(bu" 4 dh_install .IP "\(bu" 4 dh_installcatalogs .IP "\(bu" 4 dh_installdeb .IP "\(bu" 4 dh_installdirs .IP "\(bu" 4 dh_installdocs .IP "\(bu" 4 dh_installexamples .IP "\(bu" 4 dh_installinfo .IP "\(bu" 4 dh_installman .IP "\(bu" 4 dh_installwm .IP "\(bu" 4 dh_link .IP "\(bu" 4 dh_missing .IP "\(bu" 4 dh_ucf .PP Todas as variáveis de substituição são do formato \fI${foo}\fR 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. .PP Se precisar de um sinal literal de dollar que não despolete uma substituição, você pode ou usar a substituição de \fB${Dollar}\fR ou a sequência \fB${}\fR. .PP As seguintes expansões estão disponíveis: .IP "\fBDEB_HOST_*\fR, \fBDEB_BUILD_*\fR, \fBDEB_TARGET_*\fR" 4 .IX Item "DEB_HOST_*, DEB_BUILD_*, DEB_TARGET_*" Expande para o valor \fBdpkg\-architecture\fR\|(1) relevante (semelhante a \&\fIdpkg-architecture \-qVARIABLE_HERE\fR). .Sp Em caso de dúvida, a variante \fBDEB_HOST_*\fR é aquela que irá trabalhar para ambas compilações nativas e cruzadas. .Sp Por razões de performance, o debhelper irá tentar resolver esses nomes primeiro a partir do ambiente antes de consultar \&\fBdpkg\-architecture\fR\|(1). Isto é muito mencionado para plenitude pois não irá ter importância na maioria dos casos. .IP "\fBDollar\fR" 4 .IX Item "Dollar" Expande para um símbolo literal único \fB$\fR\-symbol. Este símbolo \fInunca\fR irá ser considerado parte de uma variável de substituição. Isso é: .Sp .Vb 4 \& # Triggers an error \& ${NO_SUCH_TOKEN} \& # Expands to the literal value "${NO_SUCH_TOKEN}" \& ${Dollar}{NO_SUCH_TOKEN} .Ve .Sp Esta variável é equivalente à sequência \fB${}\fR e as duas podem ser usadas alternadamente. .IP "\fBNewline\fR, \fBSpace\fR, \fBTab\fR" 4 .IX Item "Newline, Space, Tab" Expande para uma nova linha \s-1ASCII\s0 única, espaço e tab respetivamente. .Sp Isto pode ser útil se precisar de incluir um caractere literal de \*(L"espaço em branco\*(R" (ex. espaço) onde caso contrário ele iria ser descartado ou usado como um separador. .IP "\fBenv:\f(BI\s-1NAME\s0\fB\fR" 4 .IX Item "env:NAME" Expande para a variável de ambiente \fI\s-1NAME\s0\fR. A variável de ambiente tem de estar definida (mas pode estar definida para uma string vazia). .PP Note que todas as variáveis têm de expandir para um valor definido. Como exemplo, se o debhelper vir \fI${env:FOO}\fR, então ele irá insistir que a variável de ambiente \fI\s-1FOO\s0\fR está definida (pode estar definida para uma string vazia). .PP \fILimites de substituição\fR .IX Subsection "Limites de substituição" .PP 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). .SS "Ficheiros de configuração do debhelper executáveis." .IX Subsection "Ficheiros de configuração do debhelper executáveis." Se precisar de flexibilidade adicional, muitas das ferramentas debhelper (ex, \fBdh_install\fR\|(1)) suportam executar um ficheiro de configuração como um script. .PP Para usar esta funcionalidade, simplesmente marque o ficheiro de configuração como executável (ex. \fBchmod +x debian/\f(BIpackage\fB.install\fR) e a ferramenta irá tentar executá\-lo e usar o resultado do script. Em muitos casos, você pode usar \fBdh\-exec\fR\|(1) como interpretador do ficheiro de configuração para reter a maioria da sintaxe original enquanto obtém a flexibilidade adicional que precisa. .PP Quando usar ficheiros de configuração executáveis do debhelper, por favor tenha em atenção o seguinte: .IP "\(bu" 4 O ficheiro de configuração executável \fBmust\fR termina com sucesso (isto é, o seu código de retorne deve indicar sucesso). .IP "\(bu" 4 Em nível de compatibilidade 13+, o resultado será sujeito a substituições (veja \*(L"Substituições em ficheiros de configuração do debhelper\*(R") onde a ferramenta suportar estes. Lembre-se disto se o seu gerador \fItambém\fR disponibilizar substituições pois isto pode causar confusão desnecessária. .Sp Caso contrário, o resultado de saída irá ser usado exatamente como está. De notar que o debhelper \fInão\fR irá expandir wildcards, nem retirar comentários ou espaços em branco ao resultado de saída. .PP 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 \fBdh\-exec\fR\|(1) o o seu script \fBstrip-output\fR. .SH "OPÇÕES DO DEBHELPER PARTILHADAS" .IX Header "OPÇÕES DO DEBHELPER PARTILHADAS" As seguintes opções de linha de comandos são suportadas por todos os programas do debhelper. .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Modo detalhado: mostra todos os comandos que modificam o directório de compilação de pacotes. .IP "\fB\-\-no\-act\fR" 4 .IX Item "--no-act" Não faz nada na realidade. Se usado com \-v, o resultado é que o comando mostra o que iria fazer. .IP "\fB\-a\fR, \fB\-\-arch\fR" 4 .IX Item "-a, --arch" Actua em pacotes dependentes da arquitectura que devem ser compilados para a arquitectura de compilação \fB\s-1DEB_HOST_ARCH\s0\fR. .IP "\fB\-i\fR, \fB\-\-indep\fR" 4 .IX Item "-i, --indep" Actua em todos os pacotes independentes da arquitectura. .IP "\fB\-p\fR\fIpacote\fR, \fB\-\-package=\fR\fIpacote\fR" 4 .IX Item "-ppacote, --package=pacote" Actua no pacote chamado \fIpacote\fR. Esta opção pode ser especifica várias vezes para fazer o debhelper operar num determinado conjunto de pacotes. .IP "\fB\-s\fR, \fB\-\-same\-arch\fR" 4 .IX Item "-s, --same-arch" Alias descontinuado de \fB\-a\fR. .Sp Esta opção foi removida no nível de compatibilidade 12. .IP "\fB\-N\fR\fIpacote\fR, \fB\-\-no\-package=\fR\fIpacote\fR" 4 .IX Item "-Npacote, --no-package=pacote" Não actua no pacote especificado mesmo se uma opção \fB\-a\fR, \fB\-i\fR, ou \fB\-p\fR listarem o pacote como um em que se deverá actuar. .IP "\fB\-\-remaining\-packages\fR" 4 .IX Item "--remaining-packages" 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. .IP "\fB\-P\fR\fItmpdir\fR, \fB\-\-tmpdir=\fR\fItmpdir\fR" 4 .IX Item "-Ptmpdir, --tmpdir=tmpdir" Usa \fItmpdir\fR para directório de compilação de pacotes. A predefinição é debian/\fIpacote\fR .IP "\fB\-\-mainpackage=\fR\fIpacote\fR" 4 .IX Item "--mainpackage=pacote" Esta opção pouco usada muda o pacote que o debhelper considera o \*(L"pacote principal\*(R", isto é, o primeiro listado em \fIdebian/control\fR, e aquele para o qual os ficheiros \fIdebian/foo\fR podem ser usados em vez dos ficheiros \&\fIdebian/package.foo\fR usuais. .IP "\fB\-O=\fR\fIopção\fR|\fIbundle\fR" 4 .IX Item "-O=opção|bundle" Isto é usado pelo \fBdh\fR\|(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. .SH "OPÇÕES COMUNS DO DEBHELPER" .IX Header "OPÇÕES COMUNS DO DEBHELPER" 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. .IP "\fB\-n\fR" 4 .IX Item "-n" Não modifique os scripts \fIpostinst\fR, \fIpostrm\fR, etc. .IP "\fB\-X\fR\fIitem\fR, \fB\-\-exclude=\fR\fIitem\fR" 4 .IX Item "-Xitem, --exclude=item" Exclui um item do processamento. Esta opção pode ser usada várias vezes, para excluir mais do que uma coisa. O \fIitem\fR é tipicamente parte de um nome de ficheiro, e qualquer ficheiro que contenha o texto especificado será excluído. .IP "\fB\-A\fR, \fB\-\-all\fR" 4 .IX Item "-A, --all" Faz com que ficheiros ou outros itens que são especificados na linha de comandos tenham efeito em \s-1TODOS\s0 os pacotes em que se actua, e não apenas o primeiro. .SH "OPÇÕES DO SISTEMA DE COMPILAÇÃO" .IX Header "OPÇÕES DO SISTEMA DE COMPILAÇÃO" As seguintes opções de linha de comandos são suportadas por todos os comandos \fBdh_auto_\fR\fI*\fR 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 \fBdh\fR\|(1), o qual passa-as a todos os programas \&\fBdh_auto_\fR\fI*\fR. .IP "\fB\-S\fR\fIbuildsystem\fR, \fB\-\-buildsystem=\fR\fIbuildsystem\fR" 4 .IX Item "-Sbuildsystem, --buildsystem=buildsystem" Força a utilização do | especificado, em vez de tentar auto-seleccionar um que pode ser aplicável para o pacote. .Sp Passa \fBnone\fR como \fIbuildsystem\fR para desactivar a auto\-selecção. .IP "\fB\-D\fR\fIdirectory\fR, \fB\-\-sourcedir=\fR\fIdirectory\fR, \fB\-\-sourcedirectory=\fR\fIdirectory\fR" 4 .IX Item "-Ddirectory, --sourcedir=directory, --sourcedirectory=directory" Assume que a árvore fonte do pacote original está no \fIdirectório\fR especificado em vez de estar no directório de nível de topo da árvore de pacotes fonte de Debian. .Sp \&\fBAviso\fR: A variante \fB\-\-sourcedir\fR corresponde a uma opção de nome semelhante em \fBdh_install\fR e \fBdh_missing\fR (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 \fBdh\fR (quando então passada para todas as ferramentas). .IP "\fB\-B\fR[\fIdirectory\fR], \fB\-\-builddir\fR[\fI=directory\fR], \fB\-\-builddirectory\fR[\fI=directory\fR]" 4 .IX Item "-B[directory], --builddir[=directory], --builddirectory[=directory]" Activa a compilação da fonte e usa o \fIdirectório\fR especificado como o directório de compilação. Se o parâmetro \fIdirectório\fR for omitido, é escolhido o directório de compilação predefinido. .Sp 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 \fB\-\-builddirectory\fR não seja especificado. .Sp 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. .IP "\fB\-\-parallel\fR, \fB\-\-no\-parallel\fR" 4 .IX Item "--parallel, --no-parallel" 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 \fB\s-1DEB_BUILD_OPTIONS\s0\fR (\*(L"Debian Policy, secção 4.9.1\*(R") durante a compilação. Também pode servir como um limite específico do sistema de compilação. .Sp Se nenhuma destas opções for especificada, presentemente o debhelper usa por predefinição \fB\-\-parallel\fR em modo compatibilidade 10 (ou posterior) e \&\fB\-\-no\-parallel\fR em caso contrário. .Sp Como uma optimização, o \fBdh\fR 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 \fB\s-1DEB_BUILD_OPTIONS\s0\fR não tem um parâmetro \&\fIparallel\fR (ou o seu valor é 1). .IP "\fB\-\-max\-parallel=\fR\fImáximo\fR" 4 .IX Item "--max-parallel=máximo" Esta opção implica \fB\-\-parallel\fR 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. .Sp De notar que, definir o máximo para 1 é efectivamente o mesmo que usar \&\fB\-\-no\-parallel\fR. .IP "\fB\-\-reload\-all\-buildenv\-variables\fR" 4 .IX Item "--reload-all-buildenv-variables" Por predefinição, o \fBdh\fR\|(1) irá computar vários ambientes (ex. ao usar \&\fBdpkg\-buildflags\fR\|(1)) e guarda-los em cache para evitar que todas as ferramentas \fBdh_auto_*\fR os recompute. .Sp Quando se passa esta opção, a ferramenta \fBdh_auto_*\fR concreta irá ignorar a cache de \fBdh\fR\|(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 \fB...FLAGS\fR. Um exemplo concreto seria precisar de alterar o parâmetro \fB\-O\fR em \fB\s-1CFLAGS\s0\fR na segunda compilação: .Sp .Vb 1 \& export DEB_CFLAGS_MAINT_APPEND=\-O3 \& \& %: \& dh $@ \& \& override_dh_auto_configure: \& dh_auto_configure \-Bbuild\-deb ... \& DEB_CFLAGS_MAINT_APPEND=\-Os dh_auto_configure \e \& \-\-reload\-all\-buildenv\-variables \-Bbuild\-udeb ... .Ve .Sp Sem \fB\-\-reload\-all\-buildenv\-variables\fR na segunda chamada ao \&\fBdh_auto_configure\fR\|(1), a alteração em \fB\s-1DEB_CFLAGS_MAINT_APPEND\s0\fR seria ignorada pois \fBdh_auto_configure\fR\|(1) iria usar o valor em cache de <\s-1CFLAGS\s0> definido por \fBdh\fR\|(1). .Sp Esta opção está apenas disponível com \fBdebhelper (>= 12.7~)\fR quando o pacote usar nível de compatibilidade 9 ou posterior. .IP "\fB\-\-list\fR, \fB\-l\fR" 4 .IX Item "--list, -l" 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 \fB\-\-buildsystem\fR. .SH "NÍVEIS DE COMPATIBILIDADE" .IX Header "NÍVEIS DE COMPATIBILIDADE" 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. .PP No debhelper actual, você pode especificar o nível de compatibilidade em \&\fIdebian/control\fR ao adicionar um Build-Depends no pacote debhelper-compat. Por exemplo, para usar modo v13, assegure que \fIdebian/control\fR tem: .PP .Vb 1 \& Build\-Depends: debhelper\-compat (= 13) .Ve .PP 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). .PP Note que o debhelper não fornece debhelper-compat para os níveis de compatibilidade experimental ou beta; os pacotes que experimentem com esses níveis de compatibilidade devem usar \fIdebian/compat\fR ou \fB\s-1DH_COMPAT\s0\fR. .PP As versões anteriores do debhelper requeriam o nível de compatibilidade especificado no ficheiro \fIdebian/compat\fR, e o debhelper actual ainda suporta isto para compatibilidade com as versões anteriores, apesar de um pacote não poder especificar um nível de compatibilidade via múltiplos métodos de uma vez. Para usar este método, \fIdebian/compat\fR deve conter o nível de compatibilidade como um número singular, e nenhum outro conteúdo. Se você especificar o nível de compatibilidade neste método, o seu pacote vai também precisar duma dependência de compilação baseada em versão de uma versão do pacote debhelper igual (ou superior) ao nível de compatibilidade que o seu pacote usa. Assim, se você especificar o nível de compatibilidade 13 em \fIdebian/compat\fR, assegure-se que \&\fIdebian/control\fR tem: .PP .Vb 1 \& Build\-Depends: debhelper (>= 13~) .Ve .PP 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. .SS "Níveis de compatibilidade suportados" .IX Subsection "Níveis de compatibilidade suportados" Estes são os níveis de compatibilidade disponíveis: .IP "v5" 4 .IX Item "v5" Este é o nível de compatibilidade mais baixo suportado. .Sp Se você está a actualizar a partir de um nível de compatibilidade anterior, por favor reveja \fBdebhelper\-obsolete\-compat\fR\|(7). .Sp Este modo está descontinuado. .IP "v6" 4 .IX Item "v6" As alterações a partir de v5 são: .RS 4 .IP "\-" 8 Os comandos que geram fragmentos de script de maintainer irão ordenar os fragmentos em ordem reversa para os scripts \fIprerm\fR e \fIpostrm\fR. .IP "\-" 8 \&\fBdh_installwm\fR irá instalar uma ligação escrava de manual para \&\fIx\-window\-manager.1.gz\fR, se vir o manual em \fIusr/share/man/man1\fR no directório de compilação do pacote. .IP "\-" 8 O \fBdh_builddeb\fR anteriormente não apagava nada que correspondesse a \&\fB\s-1DH_ALWAYS_EXCLUDE\s0\fR, se estivesse definida uma lista de coisas a excluir, como \fB\s-1CVS:\s0.svn:.git\fR. Mas agora fá\-lo. .IP "\-" 8 \&\fBdh_installman\fR 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. .RE .RS 4 .Sp Este modo está descontinuado. .RE .IP "v7" 4 .IX Item "v7" As alterações a partir de v6 são: .RS 4 .IP "\-" 8 \&\fBdh_install\fR, irá regressar a procurar por ficheiros em \fIdebian/tmp\fR se não os encontrar no directório actual (ou onde você lhe disser para procurar usando \fB\-\-sourcedir\fR). Isto permite ao \fBdh_install\fR inter-operar com o \&\fBdh_auto_install\fR, o qual instala para \fIdebian/tmp\fR, sem precisar de nenhuns parâmetros especiais. .IP "\-" 8 \&\fBdh_clean\fR irá ler \fIdebian/clean\fR e apagar os ficheiros listados lá. .IP "\-" 8 \&\fBdh_clean\fR irá apagar ficheiros \fI*\-stamp\fR do nível de topo. .IP "\-" 8 \&\fBdh_installchangelogs\fR irá adivinhar qual ficheiro está no relatório de alterações da origem se nenhum for especificado. .RE .RS 4 .Sp Este modo está descontinuado. .RE .IP "v8" 4 .IX Item "v8" As alterações a partir de v7 são: .RS 4 .IP "\-" 8 Os comandos irão falhar em vez de emitirem avisos quando lhes são passadas opções desconhecidas. .IP "\-" 8 \&\fBdh_makeshlibs\fR irá correr \fBdpkg-gensymbols\fR em todas as bibliotecas partilhadas para as quais gera ficheiros shlibs. Portanto o \fB\-X\fR pode ser usado para excluir bibliotecas. Também, as bibliotecas em localizações fora do habitual que o \fBdpkg-gensymbols\fR não tenha processado antes serão passadas para ele, uma alteração no comportamento que pode causar que alguns pacotes falhem a compilar. .IP "\-" 8 \&\fBdh\fR requer que a sequência a correr seja especificada como o primeiro parâmetro, e quaisquer switches que venham depois dela. Isto é, use \fBdh $@ \&\-\-foo\fR\*(L", e não \*(R"\fBdh \-\-foo $@\fR .IP "\-" 8 \&\fBdh_auto_\fR\fI*\fR prefere usar o \fBModule::Build\fR do Perl em preferência de \&\fIMakefile.PL\fR. .RE .RS 4 .Sp Este modo está descontinuado. .RE .IP "v9" 4 .IX Item "v9" As alterações a partir de v8 são: .RS 4 .IP "\-" 8 Suporte a multi-arquitectura. Em particular, \fBdh_auto_configure\fR passa directórios de multi-arquitectura ao autoconf em \-\-libdir e \-\-libexecdir. .IP "\-" 8 O dh tem conhecimento das dependências habituais entre alvos em debian/rules. Por isso, o \*(L"dh binary\*(R" 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. .IP "\-" 8 \&\fBdh_strip\fR comprime ficheiros de símbolos de depuração para reduzir o tamanho instalado dos pacotes \-dbg. .IP "\-" 8 \&\fBdh_auto_configure\fR não inclui o nome do pacote fonte em \-\-libexecdir quando usa autoconf. .IP "\-" 8 \&\fBdh\fR não tem por predefinição a activação de \-\-with=python\-support .Sp (Obsoleto: Pois a ferramenta \fBdh_pysupport\fR foi removida a partir de Debian stretch. Desde o debhelper/10.3, \fBdh\fR já não se activa esta sequência add-on independentemente do nível de compatibilidade) .IP "\-" 8 Todos os programas debhelper \fBdh_auto_\fR\fI*\fR e \fBdh\fR definem variáveis de ambiente listadas por \fBdpkg-buildflags\fR, a menos que elas estejam já definidas. .IP "\-" 8 \&\fBdh_auto_configure\fR passa as \fBdpkg-buildflags\fR \s-1CFLAGS, CPPFLAGS,\s0 e \s-1LDFLAGS\s0 para \fIMakefile.PL\fR e \fIBuild.PL\fR de perl. .IP "\-" 8 \&\fBdh_strip\fR põe símbolos de depuração separados numa localização baseada no seu build-id. .IP "\-" 8 Os ficheiros de configuração executáveis do debhelper são corridos e os seus resultados usados como configuração. .RE .RS 4 .Sp Este modo está descontinuado. .RE .IP "v10" 4 .IX Item "v10" As alterações a partir de v9 são: .RS 4 .IP "\-" 8 \&\fBdh_installinit\fR não irá mais instalar um ficheiro chamado debian/\fIpacote\fR como um script de iniciação (init). .IP "\-" 8 O \fBdh_installdocs\fR irá dar erro se detectar links criados com \-\-link\-doc entre pacotes de arquitectura \*(L"all\*(R" e não\-\*(L"all\*(R" porque isso faz quebrar binNMUs. .IP "\-" 8 O \fBdh_installdeb\fR já não instala um ficheiro debian/\fIpacote\fR.shlibs disponibilizado pelo maintainer. Em vez disso, isto agora é feito pelo \&\fBdh_makeshlibs\fR. .IP "\-" 8 O \fBdh_installwm\fR 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). .IP "\-" 8 Debhelper irá predefinir para \fB\-\-parallel\fR em todos os sistemas de compilação que suportam compilação paralela. Isto pode ser desactivado usando \fB\-\-no\-parallel\fR ou passando \fB\-\-max\-parallel\fR com o valor de 1. .IP "\-" 8 O comando \fBdh\fR não irá aceitar nenhum dos parâmetros de \*(L"controle de sequência manua\*(R" descontinuados (\fB\-\-before\fR, \fB\-\-after\fR, etc.). Por favor utilize alvos de sobreposição em vez destes. .Sp \&\fBRetroactively applied to earlier compat levels\fR: \fBdh\fR já não aceita nenhum destes desde o debhelper/12.4. .IP "\-" 8 O comando \fBdh\fR não irá mais usar ficheiros log para seguir quais comandos foram executados. O comando \fBdh\fR \fIainda\fR mantêm o seguimento se já correu a sequência de \*(L"compilação\*(R" e salta-a se já o fez. .Sp Os principais efeitos disto são: .RS 8 .IP "\-" 4 Com isto, é agora mais fácil de depurar as sequências \fIinstall\fR ou/e \&\fIbinary\fR porque agora podem ser trivialmente re-executadas (sem ter que fazer um ciclo de \*(L"limpar e recompilar\*(R" completo. .IP "\-" 4 O principal embargo é que \fBdh_*\fR agora apenas mantêm acompanhamento do que aconteceu num alvo de sobreposição singular. Quanto todas as chamadas a um dado comando \fBdh_cmd\fR acontecem no mesmo alvo de sobreposição tudo irá funcionar como dantes. .Sp Exemplo de onde pode falhar: .Sp .Vb 2 \& override_dh_foo: \& dh_foo \-pmy\-pkg \& \& override_dh_bar: \& dh_bar \& dh_foo \-\-remaining .Ve .Sp Neste caso, a chamada a \fBdh_foo \-\-remaining\fR irá \fItambém\fR incluir \&\fImy-pkg\fR, desde que \fBdh_foo \-pmy\-pkg\fR tenha corrido num alvo de sobreposição separado. Este problema não está imitado a \fB\-\-remaining\fR, mas também inclui \fB\-a\fR, \fB\-i\fR, etc. .RE .RS 8 .RE .IP "\-" 8 O comando \fBdh_installdeb\fR agora faz \*(L"escape de shell\*(R" às linhas no ficheiro de configuração de \fImaintscript\fR. Esta foi a intenção original mas não trabalhava correctamente e os pacotes começaram a confiar no \*(L"escapar de shell\*(R" incompleto (ex. ao mencionar nomes de ficheiros). .IP "\-" 8 O comando \fBdh_installinit\fR agora usa por predefinição \&\fB\-\-restart\-after\-upgrade\fR. Para pacotes que precisam do comportamento anterior, por favor use \fB\-\-no\-restart\-after\-upgrade\fR. .IP "\-" 8 A sequência \fBautoreconf\fR é agora activada por predefinição. Por favor passe \&\fB\-\-without autoreconf\fR ao \fBdh\fR se isto não for desejável para um determinado pacote .IP "\-" 8 A sequência \fBsystemd\fR é agora activada por predefinição. Por favor passe \&\fB\-\-without systemd\fR ao \fBdh\fR se isto não for desejável para um determinado pacote. .IP "\-" 8 \&\fBRetroactively removed\fR \fBdh\fR 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. .Sp 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. .RE .RS 4 .RE .IP "v11" 4 .IX Item "v11" Este modo está desencorajado. .Sp A compatibilidade 11 é desencorajada para novos pacotes pois sofre de interação de características entre dh_installinit e 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 . .Sp As alterações a partir de v10 são: .RS 4 .IP "\-" 8 \&\fBdh_installinit\fR já não instala ficheiros \fIservice\fR ou \fItmpfile\fR, nem gera scripts do maintainer para esses ficheiros, Por favor use o novo ajudante \fBdh_installsystemd\fR .IP "\-" 8 Os ajudantes \fBdh_systemd_enable\fRe \fBdh_systemd_start\fR foram substituídos pelo novo ajudante \fBdh_installsystemd\fR. Pela mesma razão, a sequência do \&\fBsystemd\fR para \fBdh\fR foi também removida. Se você precisar de desactivar a ferramenta de ajuda \fBdh_installsystemd\fR, por favor use um alvo de sobreposição vazio. .Sp Por favor note que a ferramenta \fBdh_installsystemd\fR tem um comportamento ligeiramente diferente em alguns casos (ex. quando se usa o parâmetro \&\fB\-\-name\fR). .IP "\-" 8 \&\fBdh_installdirs\fR já não cria directórios debian/\fIpacote\fR a menos que tal seja explicitamente pedido (ou se tiver de criar um sub\-directório nele). .Sp A grande maioria dos pacotes não serão afectados por esta alteração. .IP "\-" 8 O sistema de compilação \fBmakefile\fR agora passa \fBINSTALL=\*(L"install \&\-\-strip\-program=true\*(R"\fR para o \fBmake\fR\|(1). Sistemas de compilação derivativos (ex. \fBconfigure\fR ou \fBcmake\fR) não são afectados por esta alteração. .IP "\-" 8 O sistema de compilação \fBautoconf\fR agora passa \fB\-\-runstatedir=/run\fR para \&\fI./configure\fR. .IP "\-" 8 O sistema de compilação \fBcmake\fR agora passa \&\fB\-DCMAKE_INSTALL_RUNSTATEDIR=/run\fR para \fBcmake\fR\|(1). .IP "\-" 8 \&\fBdh_installman\fR irá agora preferir detectar a linguagem a partir do nome de caminho em vez de a extensão. .IP "\-" 8 \&\fBdh_auto_install\fR 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. .IP "\-" 8 Os ajudantes \fBdh_installdocs\fR, \fBdh_installexamples\fR, \fBdh_installinfo\fR, e \&\fBdh_installman\fR 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. .Sp Excepções conhecidas incluem compilar com o perfil \fBnodoc\fR, 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. .IP "\-" 8 Os ajudantes \fBdh_installdocs\fR, \fBdh_installexamples\fR, \fBdh_installinfo\fR, e \&\fBdh_installman\fR agora aceitam o parâmetro \fB\-\-sourcedir\fR com o mesmo significado que \fBdh_install\fR. Mais ainda, eles agora também retornam (em fall back) a \fIdebian/tmp\fR como \fBdh_install\fR. .Sp Nota de migração: Um bug no debhelper 11 até ao 11.1.5 faz com que \&\fBdh_installinfo\fR ignore incorrectamente \fB\-\-sourcedir\fR. .IP "\-" 8 Os sistemas de compilação \fBperl-makemaker\fR e \fBperl-build\fR já não passam \&\fB\-I.\fR ao perl. Os pacotes que ainda precisam deste comportamento podem emula-lo ao usar a variável de ambiente \fB\s-1PERL5LIB\s0\fR. Ex. ao adicionar \&\fBexport PERL5LIB=.\fR no seu ficheiro debian/rules (ou semelhante). .IP "\-" 8 A variável de ambiente \fB\s-1PERL_USE_UNSAFE_INC\s0\fR já não é definida pelo \fBdh\fR ou nenhuma das ferramentas \fBdh_auto_*\fR. Ela foi adicionada como um meio de contorno temporário evitar muitos pacotes a falharem a compilação ao mesmo tempo. .Sp Note que este item irá eventualmente tornar-se obsoleto pois o auto pretende abandonar o suporte para a variável de ambiente \&\fB\s-1PERL_USE_UNSAFE_INC\s0\fR. Quando o perl abandonar o para ala, então esta variável será também removida retroactivamente dos níveis de compatibilidade existentes. .IP "\-" 8 O ajudante \fBdh_makeshlibs\fR irá agora terminar em erro se objdump retornar uma saída não\-zero a partir da análise de um determinado ficheiro. .IP "\-" 8 As ferramentas \fBdh_installdocs\fR e \fBdh_installexamples\fR podem agora instalar \fIa maioria\fR da documentação num caminho diferente para cumprir com a recomendação da política Debian §12.3 (desde versão 3.9.7). .Sp Note que um dado pacote fonte apenas contém um único pacote binário em \&\fIdebian/control\fR ou nenhum dos pacotes são pacotes \fI\-doc\fR, então esta alteração não é relevante para esse pacote fonte e você pode saltar a próxima alteração. .Sp Por predefinição, estas ferramentas irão agora tentar determinar um \*(L"pacote principal para a documentação\*(R" (chamado um \fIdoc-main-package\fR daqui em diante) para cada pacote \fI\-doc\fR. Se encontrarem o tal \fIdoc-main-package\fR, irão agora instalar a documentação em \fI/usr/share/doc/\fIdoc-main-package\fI\fR no pacote doc fornecido. Isto é, o caminho pode mudar mas a documentação será na mesma enviada no pacote \fI\-doc\fR. .Sp A opção \fB\-\-doc\-main\-package\fR 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. .Sp Alguma documentação não será afectada por esta alteração. Estas excepções incluem o ficheiro copyright, ficheiros changelog, \s-1README\s0.Debian, etc. Estes ficheiros serão na mesma instalados no caminho \fI/usr/share/doc/\fIpacote\fI\fR. .IP "\-" 8 As ferramentas \fBdh_strip\fR e \fBdh_shlibdeps\fR 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 \s-1ELF\s0 para determinar se um dado ficheiro é um objecto partilhado ou um executável \s-1ELF.\s0 .Sp Esta alteração fazer com que as ferramentas processem mais ficheiros que anteriormente. .RE .RS 4 .RE .IP "v12" 4 .IX Item "v12" As alterações a partir de v11 são: .RS 4 .IP "\-" 8 A ferramenta \fBdh_makeshlibs\fR agora gera ficheiros shlibs com dependência de versão por predefinição. Isto significa que \fB\-VUpstream\-Version\fR (a.k.a. \fB\-V\fR) é agora a predefinição. .Sp Se é pedida uma dependência sem versão no ficheiros shlibs, isto pode ser conseguido ao passar \fB\-VNone\fR em substituição. No entanto, por favor veja \&\fBdh_makeshlibs\fR\|(1) para a problemática das dependências sem versão. .IP "\-" 8 A opção \fB\-s\fR (\fB\-\-same\-arch\fR) foi removida. Por favor use \fB\-a\fR (\fB\-\-arch\fR) em vez desta. .IP "\-" 8 Invocar \fBdh_clean \-k\fR agora causa um erro em vez de um aviso de descontinuação. .IP "\-" 8 A opção \fB\-\-no\-restart\-on\-upgrade\fR em \fBdh_installinit\fR foi removida. Por favor use o novo nome \fB\-\-no\-stop\-on\-upgrade\fR .IP "\-" 8 Existia um bug nas funções \fBdoit\fR (e similares) a partir de 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 \*(L"comando não encontrado\*(R". .IP "\-" 8 O \fB\-\-list\-missing\fR e \fB\-\-fail\-missing\fR em \fBdh_install\fR foram removidos. Por favor use \fBdh_missing\fR e as suas opções correspondentes, o qual pode também ver os ficheiros instalados por outros ajudantes. .IP "\-" 8 O ajudante \fBdh_installinit\fR 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). .IP "\-" 8 A ferramenta \fBdh_installdeb\fR irá fazer validação básica de alguns comandos \&\fBdpkg\-maintscript\-helper\fR\|(1) e irá terminar em erro se os comandos parecerem ser inválidos. .IP "\-" 8 A ferramenta \fBdh_missing\fR irá agora usar por predefinição \&\fB\-\-list\-missing\fR. .IP "\-" 8 A ferramenta \fBdh_makeshlibs\fR irá agora apenas passar bibliotecas para \&\fBdpkg\-gensymbols\fR\|(1) se o binário \s-1ELF\s0 tiver um \s-1SONAME\s0 (contendo \*(L".so\*(R"). .IP "\-" 8 A ferramenta \fBdh_compress\fR não mais comprime exemplos (isto é, nada instalado em \fI.) .IP "\-" 8 A sequência standard em \fBdh\fR agora inclui \fBdh_dwz\fR e \&\fBdh_installinitramfs\fR por predefinição. Isto tornas as sequências \fBdwz\fR e \&\fBinstallinitramfs\fR 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 \fIdebian/rules\fR (ex. \fIoverride_dh_dwz:\fR) .IP "\-" 8 Os sistemas de compilação \fBmeson\fR e \fBautoconf\fR não mais definem explicitamente a variável \fB\-\-libexecdir\fR e assim apoia-se na predefinição do sistema de compilação \- O qual deve ser \fB/usr/libexec\fR (por \s-1FHS 3.0,\s0 adoptado em Debian Policy 4.1.5). .Sp Se um determinado pacote original do autor não usar a predefinição correcta, o parâmetro pode muitas vezes ser passado manualmente via \&\fBdh_auto_configure\fR\|(1). Por exemplo via seguinte exemplo: .Sp .Vb 2 \& override_dh_auto_configure: \& dh_auto_configure \-\- \-\-libexecdir=/usr/libexec .Ve .Sp Note o \fB\-\-\fR antes do parâmetro \fB\-\-libexecdir\fR. .IP "\-" 8 A ferramenta \fBdh_installdeb\fR não mais instala o ficheiro \fIconffiles\fR fornecido pelo maintainer. O ficheiro torneou-se maioritariamente obsoleto desde o nível de compatibilidade 3, onde \fBdh_installdeb\fR começo a computar automaticamente o ficheiro de controle \fIconffiles\fR resultante. .IP "\-" 8 A ferramenta \fBdh_installsystemd\fR não mais se apoia em \fBdh_installinit\fR 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. .Sp Se tiver uma sobreposição para \fBdh_installinit\fR (ex. para chamá\-lo com \&\fB\-\-no\-start\fR) então irá provavelmente precisar agora também de um para \&\fBdh_installsystemd\fR. .Sp Esta alteração faz \fBdh_installinit\fR injectar um \fImisc:Pre\-Depends\fR para \&\fBinit-system-helpers (>= 1.54~)\fR. Por favor assegure que o pacote lista \fB${misc:Pre\-Depends}\fR no seu campo \fBPre-Depends\fR antes de actualizar para a compatibilidade 12. .IP "\-" 8 Esta ferramenta de terceiros \fBdh_golang\fR (do pacote \fBdh-golang\fR) agora por predefinição honra a variável \fB\s-1DH_GOLANG_EXCLUDES\s0\fR para instalação fonte em pacotes \-dev e não apenas durante o processo de compilação. Por favor defina \&\fB\s-1DH_GOLANG_EXCLUDES_ALL\s0\fR para falso para reverter para o comportamento anterior. Veja \fB\fBDebian::Debhelper::Buildsystem::golang\fB\|(3pm)\fR para detalhes e exemplos .IP "\-" 8 \&\fBdh_installsystemduser\fR é agora incluído na sequência standard do \fBdh\fR por predefinição. .IP "\-" 8 O sistema de compilação \fBpython-distutils\fR foi agora removido. Por favor use o sistema de compilação de terceiros \fBpybuild\fR em substituição. .RE .RS 4 .RE .IP "v13" 4 .IX Item "v13" Este é o modo de operação recomendado. .Sp As alterações a partir de v12 são: .RS 4 .IP "\-" 8 O sistema de compilação \fBmeson+ninja\fR agora usa \fBmeson test\fR em vez de \&\fBninja test\fR quando corre a suite de testes. Qualquer sobreposição de \&\fBdh_auto_test\fR que passe parâmetros extra ao testador original do autor deve ser revista, pois o \fBmeson test\fR não é compatível em linha de comandos com o \fBninja test\fR. .IP "\-" 8 Todas as ferramentas tipo debhelper baseadas na biblioteca debhelper oficial (incluindo \fBdh\fR e as ferramentas oficiais \fBdh_*\fR) não aceitam mais parâmetros abreviados de comandos. Ao mesmo tempo, \fBdh\fR agora optimiza as chamadas a ajudantes redundantes \fBdh_*\fR mesmo quando passa opções longas da linha de comandos. .IP "\-" 8 As ferramentas debhelper relacionadas com \s-1ELF\s0 (\fBdh_dwz\fR, \fBdh_strip\fR, \&\fBdh_makeshlibs\fR, \fBdh_shlibdeps\fR) são agora apenas executadas para os pacotes dependentes de arquitectura por predefinição (isto é, estão excluídas de alvos \fB*\-indep\fR e são passadas \fB\-a\fR por predefinição). Se você precisar delas para alvos \fB*\-indep\fR, você pode adicionar um Build-Depends explícito em \fBdh-sequence-elf-tools\fR. .IP "\-" 8 O sistema de compilação de terceiros \fBgradle\fR (do pacote \&\fBgradle-debian-helper\fR) agora corre a suite de testes disponibilizada pelo autor automaticamente. Para suprimir tal comportamento, sobreponha \&\fBdh_auto_test\fR. .IP "\-" 8 A ferramenta \fBdh_installman\fR 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 \fIdebian/\fIpackage\fI.manpages\fR. Muitas vezes a correção mais fácil é remover a manpage de \fIdebian/\fIpackage\fI.manpages\fR (assumindo que ambas as versões são idênticas). .IP "\-" 8 Os ajudantes de \fBdh_auto_*\fR agora reiniciam as variáveis de ambiente \&\fB\s-1HOME\s0\fR e variável comum \fBXDG_*\fR. Por favor veja a descrição das variáveis de ambiente em \*(L"\s-1ENVIRONMENT\*(R"\s0 para como lidar com isto. .Sp \&\fIEsta funcionalidade mudou entre debhelper 13 e debhelper 13.2.\fR .IP "\-" 8 O comando \fBdh\fR ir+a agora dar erro se estiver presente um alvo de sobreposição ou hook para um comando obsoleto em \fIdebian/rules\fR (ex.\fBoverride_dh_systemd_enable:\fR). .IP "\-" 8 O comando \fBdh_missing\fR irá agora usar por predefinição \&\fB\-\-fail\-missing\fR. Isto pode ser revertido para um aviso não fatal ao passar explicitamente \fB\-\-list\-missing\fR como era na compatibilidade 12. .Sp Se você também não quiser o aviso, por favor omita a chamada ao \&\fBdh_missing\fR. Se você usar o sequenciador de comandos \fBdh\fR, então pode fazer isto ao inserir um alvo de sobreposição vazio no ficheiro \&\fIdebian/rules\fR do pacote relevante. Como exemplo: .Sp .Vb 2 \& # Disable dh_missing \& override_dh_missing: .Ve .IP "\-" 8 O sequenciador de comandos \fBdh\fR agora corre \fBdh_installtmpfiles\fR na sequência predefinida. O \fBdh_installtmpfiles\fR assume o manusear dos ficheiros de configuração tmpfiles.d. A funcionalidade relacionada em \&\fBdh_installsystemd\fR está agora desactivada. .Sp Note que \fBdh_installtmpfiles\fR responde a \fIdebian/\fIpackage\fI.tmpfiles\fR onde \fBdh_installsystemd\fR usou um nome sem o \*(L"s\*(R" final. .IP "\-" 8 Muitas ferramentas \fBdh_*\fR agora suportam expansão de variáveis limitada via sintaxe \fB${foo}\fR. Em muitos casos, isto pode ser usado para referenciar caminhos que contêm ou espaços ou valores \fBdpkg\-architecture\fR\|(1). Enquanto isto pode reduzir a necessidade de \fBdh\-exec\fR\|(1) em alguns casos, \fBnão\fR é um substituto de \fBdh\-exec\fR\|(1) em geral. Se você precisar de filtrar, renomear, etc... o pacote irá continuar a precisar de \fBdh\-exec\fR\|(1). .Sp Por favor veja \*(L"Substituições em ficheiros de configuração do debhelper\*(R" para sintaxe e variáveis de substituição disponíveis. Para os escritores da ferramenta \fBdh_*\fR, a expansão de substituição ocorre como parte das funções \fBfilearray\fR e \fBfiledoublearray\fR. .IP "\-" 8 O sequenciador de comandos \fBdh\fR irá agora saltar todos os alvos hook e de sobreposição para \fBdh_auto_test\fR, \fBdh_dwz\fR e \fBdh_strip\fR quando \&\fB\s-1DEB_BUILD_OPTIONS\s0\fR listar as opções \fBnocheck\fR / \fBnostrip\fR relevantes. .Sp 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 \&\fBoverride_dh_auto_test\fR deverá ser movido para \&\fBexecute_after_dh_auto_build\fR ou \fBexecute_before_dh_auto_install\fR. .IP "\-" 8 O sistema de compilação \fBcmake\fR agora passa \&\fB\-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON\fR ao \fBcmake\fR\|(1) para acelerar o processo de instalação automática. Se por alguma razão você precisar do comportamento anterior, sobreponha a flag: .Sp .Vb 1 \& dh_auto_configure \-\- \-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ... .Ve .RE .RS 4 .RE .IP "v14" 4 .IX Item "v14" Este nível de compatibilidade ainda está aberto em desenvolvimento; use com cuidado. .Sp As alterações a partir de v13 são: .RS 4 .IP "\-" 8 O sistema de compilação \fBcmake\fR agora passa \fB\-DCMAKE_SKIP_RPATH=ON\fR e \&\fB\-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON\fR a \fBcmake\fR\|(1) para evitar alguns problemas de reprodutibilidade. .Sp Isto pode causar problemas com o correr binários directamente dos directórios de compilação pois eles podem não requerer uma \&\fB\s-1LD_LIBRARY_PATH\s0\fR definida manualmente. Se você precisa de sobrepor esta alteração, nós recomendamos que tente passar a opção \&\fB\-DCMAKE_SKIP_RPATH=OFF\fR primeiro para ver se isso corrige o problema (deixando \fB\s-1CMAKE_BUILD_RPATH_USE_ORIGIN\s0\fR na sua nova predefinição). Isto deve desfazer a necessidade de \fB\s-1LD_LIBRARY_PATH\s0\fR e evitar os problemas de reprodutibilidade em Linux, onde \fB\f(CB$ORIGIN\fB\fR é suportado pelos vinculadores de tempo\-de\-execução. .IP "\-" 8 A ferramenta \fBdh_installsysusers\fR está agora incluída na sequência predefinida. .RE .RS 4 .RE .SH "NOTAS" .IX Header "NOTAS" .SS "Suporte a pacotes de múltiplos binários" .IX Subsection "Suporte a pacotes de múltiplos binários" 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 \fIdebian/rules\fR binary-arch, e os pacotes independentes de arquitectura no alvo \fIdebian/rules\fR binary-indep. .PP 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 \fB\-a\fR, \fB\-i\fR, \fB\-p\fR, e \fB\-s\fR. 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. .PP Primeiro, qualquer pacote cujo campo \fBArchitecture\fR em \fBdebian/control\fR não corresponda à arquitectura \fB\s-1DEB_HOST_ARCH\s0\fR será excluído (\*(L"Debian Policy, secção 5.6.8\*(R"). .PP Também, alguns pacotes adicionais podem ser excluídos com base no conteúdo da variável de ambiente \fB\s-1DEB_BUILD_PROFILES\s0\fR e nos campos \fBBuild-Profiles\fR nas estrofes de pacotes binários em \fBdebian/control\fR, de acordo com a política proposta em . .PP \fIInteracção entre selecções de pacotes e Build-Profiles\fR .IX Subsection "Interacção entre selecções de pacotes e Build-Profiles" .PP 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). .ie n .IP "\-a/\-\-arch, \-i/\-\-indep \s-1OU\s0 nenhuma opção de selecção (uma chamada ""dh_X"" crua)" 4 .el .IP "\-a/\-\-arch, \-i/\-\-indep \s-1OU\s0 nenhuma opção de selecção (uma chamada ``dh_X'' crua)" 4 .IX Item "-a/--arch, -i/--indep OU nenhuma opção de selecção (uma chamada dh_X crua)" O pacote desactivado por Build-Profiles é excluído em silêncio da selecção. .Sp Note que vai receber um aviso se \fItodos\fR os pacotes relacionados com estas selecções estiverem desactivados. Nesse caso, geralmente não faz nenhum sentido sequer fazer a compilação. .IP "\-N \fIpackage\fR / \-\-no\-package \fIpackage\fR" 4 .IX Item "-N package / --no-package package" A opção é aceite e efectivamente não faz nada. .IP "\-p \fIpackage\fR / \-\-package \fIpackage\fR" 4 .IX Item "-p package / --package package" A opção é aceite, mas o debhelper não irá actuar no pacote. .PP Note que não importa se um pacote está activado ou desactivado por predefinição. .SS "Geração automática de scripts de instalação Debian" .IX Subsection "Geração automática de scripts de instalação Debian" 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 \fB#DEBHELPER#\fR aos seus scripts, no local onde o código deverá ser adicionado. \fB#DEBHELPER#\fR será substituído por qualquer código auto-gerado quando você correr o \fBdh_installdeb\fR. .PP Se não existir nenhum script e o debhelper precisar de adicionar algo a ele, então o debhelper irá criar o script completo. .PP Todos os comandos debhelper que geram código automaticamente deste modo permitem que o seja desactivado pelo parâmetro \-n (ver em cima). .PP Note que o código inserido será código shell, portanto você não pode usá\-lo directamente num script de Perl. Se desejar embebê\-lo num script Perl, aqui está um modo de o fazer (note que Eu certifico-me que \f(CW$1\fR, \f(CW$2\fR, etc são definidos com o comando \*(L"set\*(R"): .PP .Vb 12 \& my $temp="set \-e\enset \-\- @ARGV\en" . << \*(AqEOF\*(Aq; \& #DEBHELPER# \& EOF \& if (system($temp)) { \& my $exit_code = ($? >> 8) & 0xff; \& my $signal = $? & 0x7f; \& if ($exit_code) { \& die("The debhelper script failed with error code: ${exit_code}"); \& } else { \& die("The debhelper script was killed by signal: ${signal}"); \& } \& } .Ve .SS "Geração automática de dependências variadas." .IX Subsection "Geração automática de dependências variadas." Alguns programas debhelper podem fazer com que o pacote gerado precise de depender de alguns outros pacotes. Por exemplo, se você usar o \&\fBdh_installdebconf\fR\|(1), o seu pacote irá geralmente depender do debconf. Ou se você usar \fBdh_installxfonts\fR\|(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. .PP 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 \fB${misc:Depends}\fR. Se você colocar esse token no seu ficheiro \&\fIdebian/control\fR, será expandido às dependências que o debhelper descobre que você precisa. .PP Isto é inteiramente independente do standard \fB${shlibs:Depends}\fR gerado pelo \fBdh_makeshlibs\fR\|(1), e do \fB${perl:Depends}\fR gerado pelo \&\fBdh_perl\fR\|(1). Você pode escolher usar qualquer um destes, se as escolhas do debhelper não corresponderem à realidade. .SS "Directórios de compilação de pacotes" .IX Subsection "Directórios de compilação de pacotes" 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/\fIpacote\fR. .PP Por vezes, você pode querer usar outro directório temporário. Isto é suportado pela bandeira \fB\-P\fR, por exemplo, "\fBdh_installdocs \&\-Pdebian/tmp\fR", irá usar \fBdebian/tmp\fR como directório temporário. Note que se você usar \fB\-P\fR, 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 \fB\-p\fR para especificar em qual pacote binário o programa debhelper irá actuar. .SS "udebs" .IX Subsection "udebs" Debhelper inclui suporte para udebs. Para criar um udeb com o debhelper, adicione "\fBPackage-Type: udeb\fR" à estrofe do pacote em \fIdebian/control\fR. O Debhelper irá tentar criar udebs em conformidade com a política do instalador debian, ao finalizar os ficheiros de pacotes gerados com \&\fI.udeb\fR, não instalando nenhuma documentação num udeb, saltando os scripts \&\fIpreinst\fR, \fIpostrm\fR, \fIprerm\fR, e \fIconfig\fR, etc. .SH "AMBIENTE" .IX Header "AMBIENTE" Esta secção descreve algumas das variáveis de ambiente que influenciam o comportamento do debhelper ou de quem o debhelper interage. .PP É 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 \fIMakefile\fR). Para as especificar correctamente em \&\fIdebian/rules\fR, assegure-se de lhes fazer "\fBexport\fR\*(L". Por exemplo, \&\*(R"\fBexport \s-1DH_VERBOSE\s0\fR" .IP "\fB\s-1DH_VERBOSE\s0\fR" 4 .IX Item "DH_VERBOSE" Defina para \fB1\fR para activar o modo detalhado. O debhelper irá mostrar os resultados de cada comando que corre. Também activa relatórios de compilação detalhados para alguns sistemas de compilação como o autoconf. .IP "\fB\s-1DH_QUIET\s0\fR" 4 .IX Item "DH_QUIET" Definir para \fB1\fR 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. É ignorado se \s-1DH_VERBOSE\s0 for também definido. .IP "\fB\s-1DH_COMPAT\s0\fR" 4 .IX Item "DH_COMPAT" Especifica temporariamente em que nível de compatibilidade o debhelper deve correr, sobrepondo qualquer valor especificado via Build-Depend em debhelper-compat ou via ficheiro \fIdebian/compat\fR. .IP "\fB\s-1DH_NO_ACT\s0\fR" 4 .IX Item "DH_NO_ACT" Defina para \fB1\fR para activar o modo no-act. .IP "\fB\s-1DH_OPTIONS\s0\fR" 4 .IX Item "DH_OPTIONS" 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. .Sp Quando se usa \fBdh\fR\|(1), podem-se passar opções que irão ser passadas a cada comando do debhelper, o que é geralmente melhor do que usar \s-1DH_OPTIONS.\s0 .IP "\fB\s-1DH_ALWAYS_EXCLUDE\s0\fR" 4 .IX Item "DH_ALWAYS_EXCLUDE" Se definido, isto adiciona o valor que está definido na variável às opções \&\fB\-X\fR de todos os comandos que suportam a opção \fB\-X\fR. Ainda mais, o \&\fBdh_builddeb\fR irá fazer \fBrm \-rf\fR a tudo o que corresponda a esse valor na sua árvore de compilação do pacote. .Sp Isto pode ser útil se você está a fazer uma compilação a partir de uma árvore fonte \s-1CVS,\s0 que no caso definindo \fBDH_ALWAYS_EXCLUDE=CVS\fR irá prevenir que quaisquer directórios \s-1CVS\s0 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 \s-1CVS,\s0 você pode querer exportar \&\fBDH_ALWAYS_EXCLUDE=CVS\fR em \fIdebian/rules\fR, para o fazer ter efeito onde o seu é compilado. .Sp Várias coisas a excluir podem ser separadas com \*(L"dois pontos\*(R", como em \&\fBDH_ALWAYS_EXCLUDE=CVS:.svn\fR .IP "\fB\s-1DH_EXTRA_ADDONS\s0\fR" 4 .IX Item "DH_EXTRA_ADDONS" 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. .Sp 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. .IP "\fB\s-1DH_COLORS\s0\fR, \fB\s-1DPKG_COLORS\s0\fR" 4 .IX Item "DH_COLORS, DPKG_COLORS" Estas variáveis podem ser usadas para controlar se os comandos do debhelper devem usar cores nos resultados textuais. Podem ser definidas para \*(L"always\*(R", \&\*(L"auto\*(R" (a predefinição), ou \*(L"never\*(R". .Sp Note que \fB\s-1DPKG_COLOR\s0\fR 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 \fB\s-1DH_COLORS\s0\fR em vez disso ou em adição a \fB\s-1DPKG_COLORS\s0\fR. .IP "\fB\s-1NO_COLOR\s0\fR" 4 .IX Item "NO_COLOR" Se não for fornecido um pedido específico para cor (ex. \fB\s-1DH_COLORS\s0\fR e \&\fB\s-1DPKG_COLORS\s0\fR estão ambos não\-definidos), a presença desta variável de ambiente faz com que a definição de cor predefinida seja \*(L"never\*(R". .Sp A variável é definida de acordo com . Neste projecto, as variáveis de ambiente (tais como \fB\s-1DH_COLORS\s0\fR) são consideradas um requisito explícito para cor. .IP "\fB\s-1CFLAGS\s0\fR, \fB\s-1CPPFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR, \fB\s-1OBJCFLAGS\s0\fR, \fB\s-1OBJCXXFLAGS\s0\fR, \fB\s-1GCJFLAGS\s0\fR, \fB\s-1FFLAGS\s0\fR, \fB\s-1FCFLAGS\s0\fR, \fB\s-1LDFLAGS\s0\fR" 4 .IX Item "CFLAGS, CPPFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS, FCFLAGS, LDFLAGS" Por predefinição (em qualquer nível de compatibilidade não\-abandonado). o debhelper irá automaticamente definir estas flags ao usar \&\fBdpkg\-buildflags\fR\|(1), quando não estiverem definidas. Se você precisar de modificar as flags predefinidas, por favor use as funcionalidades de \&\fBdpkg\-buildflags\fR\|(1) para o fazer (ex. \fBDEB_BUILD_MAINT_OPTIONS=hardening=all\fR ou \&\fBDEB_CPPFLAGS_MAINT_APPEND=\-DCUSTOM_MACRO=true\fR) em vez de definir a variável concreta directamente. .IP "\fB\s-1HOME\s0\fR, \fBXDG_*\fR" 4 .IX Item "HOME, XDG_*" 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 \fBdh_auto_*\fR. As variáveis \fB\s-1HOME\s0\fR (todos os ajudantes \fBdh_auto_*\fR) e \&\fB\s-1XDG_RUNTIME_DIR\s0\fR (apenas \fBdh_auto_test\fR) irão ser definidas para um directório gravável. Todas as restantes variáveis e \fB\s-1XDG_RUNTIME_DIR\s0\fR (excepto para durante \fBdh_auto_test\fR) irão ser limpas. .Sp O directório \fB\s-1HOME\s0\fR será criado como um directório vazio mas ele será reutilizado entre chamadas a \fBdh_auto_*\fR. Qualquer conteúdo irá persistir até ser explicitamente apagado ou \fBdh_clean\fR. .IP "\fB\s-1DEB_BUILD_OPTIONS\s0\fR" 4 .IX Item "DEB_BUILD_OPTIONS" Por favor veja \*(L"Bandeiras suportadas em \s-1DEB_BUILD_OPTIONS\*(R"\s0 para esta variável de ambiente. .Sp Por favor note que esta variável \fInão\fR deve ser alterada por maintainers de pacote dentro de \fIdebian/rules\fR 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). .IP "\fB\s-1DEB_MAINT_BUILD_OPTIONS\s0\fR" 4 .IX Item "DEB_MAINT_BUILD_OPTIONS" Esta é uma variável de ambiente especifica do dpkg (veja por ex. \fBdpkg\-buildflags\fR\|(1)). A suite de ferramentas do debhelper ignora-a em silêncio. .Sp Está documentada aqui porque tem um nome semelhante a \fB\s-1DEB_BUILD_OPTIONS\s0\fR, o que faz com que algumas pessoas assumam em erro que o debhelper também vai reagir a esta variável. .SS "Bandeiras suportadas em \s-1DEB_BUILD_OPTIONS\s0" .IX Subsection "Bandeiras suportadas em DEB_BUILD_OPTIONS" A suite de ferramentas debhelper reage às seguintes bandeiras em \&\fB\s-1DEB_BUILD_OPTIONS\s0\fR. .IP "\fBdherroron=obsolete\-compat\-levels\fR" 4 .IX Item "dherroron=obsolete-compat-levels" \&\fIEste é um valor específico do debhelper.\fR .Sp Quando \fBdherroron\fR está presente e definida para \fBobsolete-compat-levels\fR, 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. .Sp 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. .Sp Esta opção destina-se a objectivos de teste; não compilações produtivas. .IP "\fBnostrip\fR" 4 .IX Item "nostrip" \&\fIEste 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.\fR .Sp 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 \s-1ELF.\s0 .Sp Este valor afecta \fBdh_dwz\fR\|(1) e \fBdh_strip\fR\|(1). .IP "\fBnocheck\fR" 4 .IX Item "nocheck" Este valor irá fazer com que os sistemas de compilação oficiais debhelper saltem execuções de suites de testes do autor original. .Sp Os maintainers de pacotes que procurem evitar correr os testes do autor \&\fBnão\fR devem confiar nisto. Em vez disto, eles podem adicionar um alvo de sobreposição vazio para saltar o \fBdh_auto_test\fR. .Sp Este valor afecta \fBdh_auto_test\fR\|(1). .IP "\fBnodoc\fR" 4 .IX Item "nodoc" \&\fIEste 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.\fR .Sp 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á \*(L"em falta\*(R" assumindo que a documentação não foi compilada. .Sp Este valor afecta ferramentas do \fItipo\fR \fBdh_installdocs\fR\|(1), que \fIsabem\fR que estão a trabalhar com documentação. .IP "\fBnoautodbgsym\fR, \fBnoddebs\fR" 4 .IX Item "noautodbgsym, noddebs" \&\fIO nome oficial é autodbgsym. A variante noddebs é aceite por razões históricas.\fR .Sp Este valor faz com que o debhelper salte a geração de pacotes de símbolos de depuração gerados automaticamente. .Sp Este valor afecta \fBdh_strip\fR\|(1). .IP "\fBparallel=N\fR" 4 .IX Item "parallel=N" Este valor habilita o debhelper a usar até \fBN\fR linhas de processos (sujeitos a parâmetros como \fB\-\-no\-parallel\fR e \fB\-\-max\-parallel=M\fR). Nem todas as ferramentas debhelper trabalham com tarefas paralelas e podem ignorar o pedido em silêncio. .Sp Este valor afecta muitas ferramentas debhelper. Mais notoriamente \&\fBdh_auto_*\fR, a qual irá tentar correr o sistema de compilação subjacente do autor com esse número de linhas de execução. .IP "\fBterse\fR" 4 .IX Item "terse" 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. .Sp Este valor afecta a maioria das ferramentas \fBdh_auto_*\fR. .PP Bandeiras desconhecidas são ignoradas em silêncio. .PP 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. .SH "VEJA TAMBÉM" .IX Header "VEJA TAMBÉM" .IP "\fI/usr/share/doc/debhelper/examples/\fR" 4 .IX Item "/usr/share/doc/debhelper/examples/" Um conjunto de ficheiros \fIdebian/rules\fR exemplo que usam debhelper. .IP "" 4 .IX Item "" Sítio web do debhelper. .SH "AUTOR" .IX Header "AUTOR" Joey Hess .SH "TRADUÇÃO" .IX Header "TRADUÇÃO" Américo Monteiro .PP Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro \fIa_monteiro@gmx.com\fR ou Equipa Debian de Tradução Portuguesa \fItraduz@debianpt.org\fR.