#LISTA_DE_DESCONTINUADOS#

• Os comandos que geram fragmentos de script de mantenedor irão ordenar os fragmentos em ordem reversa para os scripts prerm e postrm.
• dh_installwm irá instalar uma ligação escrava de manual para x-window-manager.1.gz, se vir o manual em usr/share/man/man1 no directório de compilação do pacote.
• O dh_builddeb anteriormente não apagava nada que correspondesse a DH_ALWAYS_EXCLUDE, se estivesse definida uma lista de coisas a excluir, como CVS:.svn:.git. Mas agora fá-lo.
• dh_installman permite a sobreposição de manuais existentes no directório de compilação do pacote. Nos níveis de compatibilidade anteriores recusava-se em silêncio a fazer isto.

Este modo está descontinuado.

• dh_install, irá regressar a procurar por ficheiros em debian/tmp se não os encontrar no directório actual (ou onde você lhe disser para procurar usando --sourcedir). Isto permite ao dh_install inter-operar com o dh_auto_install, o qual instala para debian/tmp, sem precisar de nenhuns parâmetros especiais.
• dh_clean irá ler debian/clean e apagar os ficheiros listados lá.
• dh_clean irá apagar ficheiros *-stamp do nível de topo.
• dh_installchangelogs irá adivinhar qual ficheiro está no relatório de alterações da origem se nenhum for especificado.

Este modo está descontinuado.

• Os comandos irão falhar em vez de emitirem avisos quando lhes são passadas opções desconhecidas.
• dh_makeshlibs irá correr dpkg-gensymbols em todas as bibliotecas partilhadas para as quais gera ficheiros shlibs. Portanto o -X pode ser usado para excluir bibliotecas. Também, as bibliotecas em localizações fora do habitual que o dpkg-gensymbols não tenha processado antes serão passadas para ele, uma alteração no comportamento que pode causar que alguns pacotes falhem a compilar.
• dh requer que a sequência a correr seja especificada como o primeiro parâmetro, e quaisquer switches que venham depois dela. Isto é, use dh $@ --foo", e não "dh --foo $@
• dh_auto_* prefere usar o Module::Build do Perl em preferência de Makefile.PL.

Este modo está descontinuado.

• Suporte a multi-arquitectura. Em particular, dh_auto_configure passa directórios de multi-arquitectura ao autoconf em --libdir e --libexecdir.
• O dh tem conhecimento das dependências habituais entre metas em debian/rules. Por isso, o "dh binary" irá correr quaisquer metas de build, build-arch, build-indep, install, etc que existam no ficheiro de regras. Não há necessidade de definir uma meta binário explícito com dependências explícitas em outras metas.
• dh_strip comprime ficheiros de símbolos de depuração para reduzir o tamanho instalado dos pacotes -dbg.
• dh_auto_configure não inclui o nome do pacote fonte em --libexecdir quando usa autoconf.
• dh não tem por predefinição a activação de --with=python-support

  (Obsoleto: Pois a ferramenta dh_pysupport foi removida a partir de Debian stretch. Desde o debhelper/10.3, dh já não se activa esta sequência add-on independentemente do nível de compatibilidade)

• Todos os programas debhelper dh_auto_* e dh definem variáveis de ambiente listadas por dpkg-buildflags, a menos que elas estejam já definidas.
• dh_auto_configure passa as dpkg-buildflags CFLAGS, CPPFLAGS, e LDFLAGS para Makefile.PL e Build.PL de perl.
• dh_strip põe símbolos de depuração separados numa localização baseada no seu build-id.
• Os ficheiros de configuração executáveis do debhelper são corridos e os seus resultados usados como configuração.

• dh_installinit não irá mais instalar um ficheiro chamado debian/pacote como um script de iniciação (init).
• O dh_installdocs irá dar erro se detectar links criados com --link-doc entre pacotes de arquitectura "all" e não-"all" porque isso faz quebrar binNMUs.
• O dh_installdeb já não instala um ficheiro debian/pacote.shlibs disponibilizado pelo mantenedor. Em vez disso, isto agora é feito pelo dh_makeshlibs.
• O dh_installwm recusa-se a criar um pacote quebrado se não encontrar nenhuma página de manual (necessário para registo para a alternativa do x-window-manager).
• Debhelper irá predefinir para --parallel em todos os sistemas de compilação que suportam compilação paralela. Isto pode ser desactivado usando --no-parallel ou passando --max-parallel com o valor de 1.
• O comando dh não irá aceitar nenhum dos parâmetros de "controle de sequência manua" descontinuados (--before, --after, etc.). Por favor utilize metas de sobreposição em vez destes.
• O comando dh não irá mais usar ficheiros log para seguir quais comandos foram executados. O comando dh ainda mantêm o seguimento se já correu a sequência de "compilação" e salta-a se já o fez.

  Os principais efeitos disto são:

• O comando dh_installdeb agora faz "escape de shell" às linhas no ficheiro de configuração de maintscript. Esta foi a intenção original mas não trabalhava correctamente e os pacotes começaram a confiar no "escapar de shell" incompleto (ex. ao mencionar nomes de ficheiros).
• O comando dh_installinit agora usa por predefinição --restart-after-upgrade. Para pacotes que precisam do comportamento anterior, por favor use --no-restart-after-upgrade.
• A sequência autoreconf é agora activada por predefinição. Por favor passe --without autoreconf ao dh se isto não for desejável para um determinado pacote
• A sequência systemd é agora activada por predefinição. Por favor passe --without systemd ao dh se isto não for desejável para um determinado pacote.
• Retroactively removed: dh no longer creates the package build directory when skipping running debhelper commands. This will not affect packages that only build with debhelper commands, but it may expose bugs in commands not included in debhelper.

  This compatibility feature had a bug since its inception in debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As there has been no reports of issues caused by this bug in those ~5 years, this item have been removed rather than fixed.

• dh_installinit já não instala ficheiros service ou tmpfile, nem gera scripts do mantenedor para esses ficheiros, Por favor use o novo ajudante dh_installsystemd
• Os ajudantes dh_systemd_enablee dh_systemd_start foram substituídos pelo novo ajudante dh_installsystemd. Pela mesma razão, a sequência do systemd para dh foi também removida. Se você precisar de desactivar a ferramenta de ajuda dh_installsystemd, por favor use um alvo de sobreposição vazio.

  Por favor note que a ferramenta dh_installsystemd tem um comportamento ligeiramente diferente em alguns casos (ex. quando se usa o parâmetro --name).

• dh_installdirs já não cria directórios debian/pacote a menos que tal seja explicitamente pedido (ou se tiver de criar um sub-directório nele).

  A grande maioria dos pacotes não serão afectados por esta alteração.

• The makefile buildsystem now passes INSTALL="install --strip-program=true" to make(1). Derivative buildsystems (e.g. configure or cmake) are unaffected by this change.
• O sistema de compilação autoconf agora passa --runstatedir=/run para ./configure.
• O sistema de compilação cmake agora passa -DCMAKE_INSTALL_RUNSTATEDIR=/run para cmake(1).
• dh_installman irá agora preferir detectar a linguagem a partir do nome de caminho em vez de a extensão.
• dh_auto_install irá agora apenas criar o directório de destino que precisa. Anteriormente, iria criar o directório de compilação de pacote para todos os pacotes. Isto não vai afectar pacotes que apenas compilam com comandos debhelper, mas pode expor bugs em comandos não incluídos no debhelper.
• Os ajudantes dh_installdocs, dh_installexamples, dh_installinfo, e dh_installman agora dão erro se a sua configuração tiver um padrão que não coincida com nada ou faça referência a um caminho que não exista.

  Excepções conhecidas incluem compilar com o perfil nodoc, onde as ferramentas de cima irão permitir em silêncio correspondências falhadas onde os padrões são usados para especificar documentação.

• Os ajudantes dh_installdocs, dh_installexamples, dh_installinfo, e dh_installman agora aceitam o parâmetro --sourcedir com o mesmo significado que dh_install. Mais ainda, eles agora também retornam (em fall back) a debian/tmp como dh_install.

  Migration note: A bug in debhelper 11 up to 11.1.5 made dh_installinfo incorrectly ignore --sourcedir.

• Os sistemas de compilação perl-makemaker e perl-build já não passam -I. ao perl. Os pacotes que ainda precisam deste comportamento podem emula-lo ao usar a variável de ambiente PERL5LIB. Ex. ao adicionar export PERL5LIB=. no seu ficheiro debian/rules (ou semelhante).
• A variável de ambiente PERL_USE_UNSAFE_INC já não é definida pelo dh ou nenhuma das ferramentas dh_auto_*. Ela foi adicionada como um meio de contorno temporário evitar muitos pacotes a falharem a compilação ao mesmo tempo.

  Note que este item irá eventualmente tornar-se obsoleto pois o auto pretende abandonar o suporte para a variável de ambiente PERL_USE_UNSAFE_INC. Quando o perl abandonar o para ala, então esta variável será também removida retroactivamente dos níveis de compatibilidade existentes.

• O ajudante dh_makeshlibs irá agora terminar em erro se objdump retornar uma saída não-zero a partir da análise de um determinado ficheiro.
• The dh_installdocs and dh_installexamples tools may now install most of the documentation in a different path to comply with the recommendation from Debian policy §12.3 (since version 3.9.7).

  Note that if a given source package only contains a single binary package in debian/control or none of the packages are -doc packages, then this change is not relevant for that source package and you can skip to the next change.

  By default, these tools will now attempt to determine a "main package for the documentation" (called a doc-main-package from here on) for every -doc package. If they find such a doc-main-package, they will now install the documentation into the path /usr/share/doc/doc-main-package in the given doc package. I.e. the path can change but the documentation is still shipped in the -doc package.

  The --doc-main-package option can be used when the auto-detection is insufficient or to reset the path to its previous value if there is a reason to diverge from Debian policy recommendation.

  Some documentation will not be affected by this change. These exceptions include the copyright file, changelog files, README.Debian, etc. These files will still be installed in the path /usr/share/doc/ package.

• As ferramentas dh_strip e dh_shlibdeps já não usam mais padrões de nomes de ficheiros para determinar quais ficheiros processar. Em vez disso, elas abrem o ficheiro e procuram um cabeçalho ELF para determinar se um dado ficheiro é um objecto partilhado ou um executável ELF.

  Esta alteração fazer com que as ferramentas processem mais ficheiros que anteriormente.

• The dh_makeshlibs tool now generates shlibs files with versioned dependency by default. This means that -VUpstream-Version (a.k.a. -V) is now the default.

  If an unversioned dependency in the shlibs file is wanted, this can be obtained by passing -VNone instead. However, please see dh_makeshlibs(1) for the caveat of unversioned dependencies.

• A opção -s (--same-arch) foi removida. Por favor use -a (--arch) em vez desta.
• Invocar dh_clean -k agora causa um erro em vez de um aviso de descontinuação.
• A opção --no-restart-on-upgrade em dh_installinit foi removida. Por favor use o novo nome --no-stop-on-upgrade
• Existia um bug nas funções doit (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".
• O --list-missing e --fail-missing em dh_install foram removidos. Por favor use dh_missing e as suas opções correspondentes, o qual pode também ver os ficheiros instalados por outros ajudantes.
• O ajudante dh_installinit já não instala configuração para o sistema de init upstart. Em vez disso, irá abortar a compilação se encontrar um ficheiro de configuração upstart antigo. O erro está lá para lembrar ao mantenedor do pacote para assegurar a remoção apropriada dos ficheiros de configuração empacotados em versões anteriores do pacote (caso existam).
• A ferramenta dh_installdeb irá fazer validação básica de alguns comandos dpkg-maintscript-helper(1) e irá terminar em erro se os comandos parecerem ser inválidos.
• The dh_missing tool will now default to --list-missing.
• The dh_makeshlibs tool will now only pass libraries to dpkg-gensymbols(1) if the ELF binary has a SONAME (containing ".so").
• The dh_compress tool no longer compresses examples (i.e. anything installed in </usr/share/doc/package/examples>.)
• The standard sequence in dh now includes dh_dwz and dh_installinitramfs by default. This makes the dwz and installinitramfs sequences obsolete and they will now fail with an error. If you want to skip these commands, then please insert an empty override target for them in debian/rules (e.g. override_dh_dwz:)
• The build systems meson and autoconf no longer explicitly set the --libexecdir variable and thus relies on the build system default - which should be /usr/libexec (per FHS 3.0, adopted in Debian Policy 4.1.5).

  If a particular upstream package does not use the correct default, the parameter can often be passed manually via dh_auto_configure(1). E.g. via the following example:

      override_dh_auto_configure:
          dh_auto_configure -- --libexecdir=/usr/libexec
      

  Note the -- before the --libexecdir parameter.

• The dh_installdeb tool no longer installs the maintainer provided conffiles file. The file has mostly been obsolete since compatibility level 3, where dh_installdeb began to automatically compute the resulting conffiles control file.
• The dh_installsystemd tool no longer relies on dh_installinit for handling systemd services that have a sysvinit alternative. Both tools must now be used in such a case to ensure the service is properly started under both sysvinit and systemd.

  If you have an override for dh_installinit (e.g. to call it with --no-start) then you will probably need one for dh_installsystemd as well now.

  This change makes dh_installinit inject a misc:Pre-Depends for init-system-helpers (>= 1.54~). Please ensure that the package lists ${misc:Pre-Depends} in its Pre-Depends field before upgrading to compat 12.

• The third-party dh_golang tool (from dh-golang package) now defaults on honoring DH_GOLANG_EXCLUDES variable for source installation in -dev packages and not only during the building process. Please set DH_GOLANG_EXCLUDES_ALL to false to revert to the previous behaviour. See Debian::Debhelper::Buildsystem::golang (3pm) for details and examples.
• dh_installsystemduser is now included in the dh standard sequence by default.
• The python-distutils buildsystem is now removed. Please use the third-party build system pybuild instead.

-

The meson+ninja build system now uses meson test instead of ninja test when running the test suite. Any override of dh_auto_test that passes extra parameters to upstream test runner should be reviewed as meson test is not command line compatible with ninja test.