.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" 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 .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . 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 2024-03-27 13.15.3 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-compat-upgrade-checklist \- Actualiza a lista de verificação para níveis de compatibilidade do debhelper suportados. .SH RESUMO .IX Header "RESUMO" This document is an upgrade checklist of all the supported debhelper compat levels. It also lists all the supported debhelper compat levels. .PP Informação sobre como declarar os níveis de compatibilidade está em "NÍVEIS DE COMPATIBILIDADE" in \fBdebhelper\fR\|(7). .PP Se você está a actualizar a partir de um nível de compatibilidade (agora) obsoleto, então por favor consulte \fBdebhelper\-obsolete\-compat\fR\|(7). .SH DESCRIÇÃO .IX Header "DESCRIÇÃO" .SS "Actualizar lista de verificação para os níveis de compatibilidade suportados." .IX Subsection "Actualizar lista de verificação para os níveis de compatibilidade suportados." Estes são os níveis de compatibilidade disponíveis: .IP v15 4 .IX Item "v15" Este nível de compatibilidade ainda está aberto em desenvolvimento; use com cuidado. .Sp As alterações a partir de v14 são: .RS 4 .IP \- 8 A ferramenta \fBdh_auto_install\fR já não usa por predefinição \fB\-\-destdir=debian/\fR\f(BIpackage\fR para pacotes fonte que apenas produzem um único binário. Se este comportamento é desejado, o pacote deve activar explicitamente o addon do dh \fBsingle-binary\fR (ex. ao adicionar \fBdh-sequence-single-binary\fR a \fBBuild-Depends\fR) ou passar \fB\-\-destdir\fR a \fBdh_auto_install\fR. .Sp 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 \fBsingle-binary\fR irá detectar a discrepância e avisar o maintainer do que está prestes a acontecer. .IP \- 8 It is now an error to use package-less versions of debhelper configuration files when there are 2 or more binary packages listed in \fIdebian/control\fR in most cases. Legacy files should be renamed to \fIdebian/package.foo\fR (from \fIdebian/foo\fR) where \fIpackage\fR is the first binary package listed in \fIdebian/control\fR. .Sp The primary exception to this change are files such as \fIdebian/changelog\fR, \fIdebian/NEWS\fR, and \fIdebian/copyright\fR, where the same file is used for all packages by default. These cases will remain unchanged. .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 A ferramenta \fBdh_installpam\fR irá agora instalar ficheiros de configuração do PAM sob \fI/usr/lib/pam.d/package\fR em vez de \fI/etc/pam.d/package\fR. .Sp Por favor considere usar a funcionalidade "rm_conffile" de \fBdh_installdeb\fR\|(1) para assegurar a remoção apropriada dos ficheiros PAM anteriores. .IP \- 8 Packages using the \fBdh\fR sequencer should be aware the following changes: .RS 8 .IP \- 4 A ferramenta \fBdh_installsysusers\fR está agora incluída na sequência predefinida. Esta ferramenta de ajuda irá processar ficheiros sysusers do systemd. .IP \- 4 The \fBdh_installsystemduser\fR tool will default to enabling systemd user units, start them on installation, restart them on upgrades and stop them on uninstalling the package. .IP \- 4 Usar o comando \fBdh_gconf\fR em alvos de sobreposição e hook agora causa um erro. O comando \fBdh_gconf\fR foi um não\-operativo durante anos e foi removido no debhelper 13.4. .IP \- 4 A ferramenta \fBdh_installalternatives\fR irá agora correr após \fBdh_link\fR em vez de após \fBdh_installinitramfs\fR na sequência predefinida do \fBdh\fR. .IP \- 4 \&\fIThis item only applies to source packages that has exactly one \fR\f(BIPackage\fR\fI stanza in debian/control.\fR .Sp O sequenciador \fBdh\fR irá avisar se o addon \fBsingle-binary\fR for activado implicitamente para avisar os maintainers da pendente alteração na compatibilidade 15 em \fBdh_auto_install\fR. .Sp Maintainers são incentivados a ou activar explicitamente o addon \fBsingle-binary\fR para preservar o comportamento existente (ex. ao adicionar a Build-Depends), ou passar explicitamente \fB\-\-destdir\fR a \fBdh_auto_install\fR se usado e depois passar \fB\-\-without single-binary\fR a \fBdh\fR (a última para silenciar o aviso). .Sp 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 \fBsingle-binary\fR irá detectar a discrepância e avisar o maintainer do que está prestes a acontecer. .RE .RS 8 .RE .IP \- 8 The \fBdh_control\fR tool now automatically applies relationship substvars to relevant fields. That means that many substvars such as \fB${misc:Depends}\fR and \fB${shlibs:Depends}\fR no longer need to be explicitly mentioned in \fIdebian/control\fR. This applies to any substvar named after a field that the installed version of \fBdpkg\fR considers a relation or dependency-like field. At the time of writing, the list consists of: .RS 8 .IP \- 4 Pre-Depends .IP \- 4 Depends .IP \- 4 Recommends .IP \- 4 Suggests .IP \- 4 Enhances .IP \- 4 Conflicts .IP \- 4 Breaks .IP \- 4 Replaces .IP \- 4 Provides .IP \- 4 Built-Using .IP \- 4 Static-Built-Using .RE .RS 8 .Sp This means that \fBDepends: foo, ${misc:Depends}\fR in \fIdebian/control\fR can now be reduced to \fBDepends: foo\fR and \fBDepends: ${misc:Depends}, ${shlibs:Depends}\fR can be removed entirely as examples of how the feature works. .Sp Note that other substvars such as \fB${binary:Version}\fR are unaffected by this change and should still be used explicitly as necessary. Additionally, for \fBEssential: yes\fR packages that manually promoted \fB${shlibs:Depends}\fR into \fBPre-Depends\fR field, \fBdh_shlibdeps\fR will handle this automatically as well (see the next compat item). .Sp See for the details of this proposal. The summary in also covers when the substvars need tweaking. The most common case involves using the \fB\-d\fR option from \fBdpkg-shlibdeps\fR possibly via \fBdh_shlibdeps\fR. .Sp Note: This change changes will cause false-positives from an unfixed \fBlintian\fR. Please check for \fBlintian\fR support for this change. .RE .IP \- 8 The \fBdh_shlibdeps\fR tool now defaults to using \fB${shlibs:Pre\-Depends}\fR for packages that are \fBEssential: yes\fR. .Sp Note due to the \fBdh_gencontrol\fR change above, any package using \fBdh_gencontrol\fR will not have to do anything for this migration. .IP \- 8 It now triggers a warning to use package-less versions of debhelper configuration files when there are 2 or more binary packages listed in \fIdebian/control\fR in most cases. Legacy files should be renamed to \fIdebian/package.foo\fR (from \fIdebian/foo\fR) where \fIpackage\fR is the first binary package listed in \fIdebian/control\fR. .Sp The primary exception to this change are files such as \fIdebian/changelog\fR, \fIdebian/NEWS\fR, and \fIdebian/copyright\fR, where the same file is used for all packages by default. These cases will remain unchanged. The debhelper tool using the files will trigger warnings on usage. .Sp In compat 15 (or later), this is changed to an error. .IP \- 8 Packages using the \fBcmake\fR build system should be aware of the following changes: .RS 8 .IP \- 4 O sistema de compilação \fBcmake\fR agora passa \fB\-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON\fR a \fBcmake\fR\|(1) para evitar alguns problemas de reprodutibilidade. .IP \- 4 The \fBcmake\fR build system now sets the \fBASMFLAGS\fR environment variable when it is unset and \fBASFLAGS\fR is present. The former name (\fBASMFLAGS\fR) is the name \fBcmake\fR expects, while the latter (\fBASFLAGS\fR) is the name that \fBdpkg\-buildpackage\fR\|(1) uses. .IP \- 4 The \fBcmake\fR build systems now use \fBcmake \-\-install\fR instead of \fBmake install\fR in the \fBdh_auto_install\fR\|(1) call. Any override of \fBdh_auto_install\fR that passes extra parameters to the upstream build system should be reviewed. .RE .RS 8 .RE .IP \- 8 Packages using the \fBmeson\fR build system should be aware of the following changes: .RS 8 .IP \- 4 The \fBmeson\fR build system now passes \fB\-\-auto\-features=enabled\fR to \fBmeson\fR. .IP \- 4 The \fBmeson+ninja\fR build system now use \fBmeson install\fR instead of \fBninja install\fR in the \fBdh_auto_install\fR\|(1) call. Any override of \fBdh_auto_install\fR that passes extra parameters to the upstream build system should be reviewed. .RE .RS 8 .RE .IP \- 8 The \fIdebian/compat\fR file is no longer accepted as a source for specifying the debhelper compat level. Put the compat level in the \fBX\-DH-Compat\fR field of the source stanza of \fIdebian/control\fR. .Sp Note to avoid breaking packages that already migrated to compat 14 immediately, while it was experimental this change is first enforced when compat 14 becomes stable. .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 ELF (\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/package.manpages\fR. Muitas vezes a correção mais fácil é remover a manpage de \fIdebian/package.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 \fBHOME\fR e variável comum \fBXDG_*\fR. Por favor veja a descrição das variáveis de ambiente em "ENVIRONMENT" 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/package.tmpfiles\fR onde \fBdh_installsystemd\fR usou um nome sem o "s" 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 "Substituições em ficheiros de configuração do debhelper" 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 \fBDEB_BUILD_OPTIONS\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 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 "comando não encontrado". .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 ELF tiver um SONAME (contendo ".so"). .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 FHS 3.0, 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 \&\fBRetroativamente removido em debhelper/13.5\fR: .Sp A ferramenta \fBdh_installdeb\fR não iria mais instalar o ficheiro \fIconffiles\fR fornecido pelo responsável pois isso foi considerado desnecessário. No entanto, o \fBremove-on-upgrade\fR do dpkg/1.20 tornou o ficheiro relevante de novo e \fBdh_installdeb\fR agora instala-o nos níveis de compatibilidade 12+. .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 chama-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 \fBDH_GOLANG_EXCLUDES\fR para instalação fonte em pacotes \-dev e não apenas durante o processo de compilação. Por favor defina \fBDH_GOLANG_EXCLUDES_ALL\fR para falso para reverter para o comportamento anterior. Veja \fBDebian::Debhelper::Buildsystem::golang\|(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 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="install \-\-strip\-program=true"\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 \fBPERL5LIB\fR. Ex. ao adicionar \fBexport PERL5LIB=.\fR no seu ficheiro debian/rules (ou semelhante). .IP \- 8 A variável de ambiente \fBPERL_USE_UNSAFE_INC\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 \fBPERL_USE_UNSAFE_INC\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 "pacote principal para a documentação" (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/doc-main-package\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, README.Debian, etc. Estes ficheiros serão na mesma instalados no caminho \fI/usr/share/doc/pacote\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 ELF para determinar se um dado ficheiro é um objecto partilhado ou um executável ELF. .Sp Esta alteração fazer com que as ferramentas processem mais ficheiros que anteriormente. .RE .RS 4 .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 "all" e não\-"all" 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 "controle de sequência manua" 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 "compilação" 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 "limpar e recompilar" 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 "escape de shell" à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 "escapar de shell" 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 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 "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. .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 CFLAGS, CPPFLAGS, e LDFLAGS 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 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", e não "\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 v7 4 .IX Item "v7" Este modo está descontinuado. .Sp 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). .SH "VEJA TAMBÉM" .IX Header "VEJA TAMBÉM" .IP \fBdebhelper\-obsolete\-compat\fR\|(7) 4 .IX Item "debhelper-obsolete-compat" 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. .IP \fBdebhelper\fR\|(7) 4 .IX Item "debhelper" Informação geral acerca da estrutura do debhelper. Este documento também cobre como declarar o seu nível de compatibilidade debhelper escolhido. .SH AUTORES .IX Header "AUTORES" Niels Thykier .PP 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.