.\" 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 "2022-11-26" "13.11.1~bpo11+1" "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 "NOM"
.IX Header "NOM"
debhelper-compat-upgrade-checklist \- Upgrade checklist for supported
debhelper compat levels
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
This document is an upgrade checklist of all the supported debhelper compat
levels. It also lists all the support debhelper compat levels.
.PP
Information about how to declare the compat level is in
\&\*(L"\s-1COMPATIBILITY LEVELS\*(R"\s0 in \fBdebhelper\fR\|(7).
.PP
If you are upgrading from a (now) obsolete compat level, then please refer
to \fBdebhelper\-obsolete\-compat\fR\|(7).
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
.SS "Upgrade checklist for supported compatibility levels"
.IX Subsection "Upgrade checklist for supported compatibility levels"
Les niveaux de compatibilité sont les suivants :
.IP "v15" 4
.IX Item "v15"
Ce niveau de compatibilité est encore en développement ; à utiliser avec
précaution.
.Sp
Changes from v14 are:
.RS 4
.IP "\-" 8
The \fBdh_auto_install\fR tool no longer defaults to \fB\-\-destdir=debian/\f(BIpackage\fB\fR for source packages only producing a single
binary.  If this behaviour is wanted, the package should explicitly activate
the \fBsingle-binary\fR dh addon (e.g., by adding \fBdh-sequence-single-binary\fR
to \fBBuild-Depends\fR) or pass \fB\-\-destdir\fR to \fBdh_auto_install\fR.
.Sp
The rationale for this change to avoid \*(L"surprises\*(R" when adding a second
binary package later.  Previously, debhelper would silently change behaviour
often resulting in empty binary packages being uploaded to the archive by
mistake. With the new behaviour, the \fBsingle-binary\fR addon will detect the
mismatch and warn the maintainer of what is about to happen.
.RE
.RS 4
.RE
.IP "v14" 4
.IX Item "v14"
Ce niveau de compatibilité est encore en développement ; à utiliser avec
précaution.
.Sp
Les changements par rapport à la version 13 sont :
.RS 4
.IP "\-" 8
The \fBcmake\fR buildsystem now passes \fB\-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON\fR to
\&\fBcmake\fR\|(1) to avoid some reproducibility issues.
.IP "\-" 8
The tool \fBdh_installsysusers\fR is now included in the default sequence. This
helper tool will process systemd sysusers files.
.IP "\-" 8
Use of the \fBdh_gconf\fR command in override and hook targets now causes an
error.  The \fBdh_gconf\fR command has been a no-op for years and was removed
in debhelper 13.4.
.IP "\-" 8
The \fBdh\fR sequencer will warn if the \fBsingle-binary\fR addon is implicitly
activated to warn maintainers of the pending compat 15 change in
\&\fBdh_auto_install\fR.
.Sp
Maintainers are urged to either explicitly activate the \fBsingle-binary\fR
addon to preserve the existing behaviour (e.g., by adding
\&\fBdh-sequence-single-binary\fR to Build-Depends), or explicitly passing
\&\fB\-\-destdir\fR to \fBdh_auto_install\fR if used and then passing \fB\-\-without
single-binary\fR to \fBdh\fR (the latter to silence the warning).
.Sp
The rationale for this change to avoid \*(L"surprises\*(R" when adding a second
binary package later.  Previously, debhelper would silently change behaviour
often resulting in empty binary packages being uploaded to the archive by
mistake. With the new behaviour, the \fBsingle-binary\fR addon will detect the
mismatch and warn the maintainer of what is about to happen.
.IP "\-" 8
The \fBdh_installalternatives\fR tool will now be run after \fBdh_link\fR rather
than after \fBdh_installinitramfs\fR in the default \fBdh\fR sequence.
.IP "\-" 8
The \fBdh_installpam\fR tool will now install \s-1PAM\s0 configuration files under \fI/usr/lib/pam.d/\fIpackage\fI\fR instead of \fI/etc/pam.d/\fIpackage\fI\fR.
.Sp
Please consider using the \*(L"rm_conffile\*(R" feature from \fBdh_installdeb\fR\|(1) to
ensure the proper removal of previous \s-1PAM\s0 files.
.IP "\-" 8
The \fBmeson+ninja\fR and \fBcmake\fR build systems now use \fBmeson install\fR and
\&\fBcmake \-\-install\fR, respectively, instead of \fBninja install\fR and \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 4
.RE
.IP "v13" 4
.IX Item "v13"
C'est la version dont l'usage est recommandé.
.Sp
Les changements par rapport à la version 12 sont :
.RS 4
.IP "\-" 8
Le système de construction \fBmeson+ninja\fR utilise maintenant \fBmeson test\fR à
la place de \fBninja test\fR pour la suite de tests. Chaque réécriture de
\&\fBdh_auto_test\fR qui passe des paramètres supplémentaires aux tests amont
devrait être vérifiée, car \fBmeson test\fR n'est pas compatible avec \fBninja
test\fR.
.IP "\-" 8
Tous les outils dans le style de debhelper basés sur la bibliothèque
debhelper officielle (y compris \fBdh\fR et les outils officiels \fBdh_*\fR)
n'acceptent plus les paramètres de commande abrégés. En même temps, \fBdh\fR
optimise maintenant les appels aux outils redondants \fBdh_*\fR même quand ils
passent de longues options de ligne de commande.
.IP "\-" 8
Les outils de debhelper liés à \s-1ELF\s0 (\fBdh_dwz\fR, \fBdh_strip\fR,
\&\fBdh_makeshlibs\fR, \fBdh_shlibdeps\fR) sont désormais seulement exécutés pour
les paquets dépendant de l'architecture par défaut (c'est\-à\-dire qu'ils sont
exclus des cibles \fB*\-indep\fR et sont passés avec l'option \fB\-a\fR par
défaut). Si vous avez besoin d'eux pour des cibles \fB*\-indep\fR, vous pouvez
ajouter un Build-Depends explicite à \fBdh-sequence-elf-tools\fR.
.IP "\-" 8
Le système de construction tiers \fBgradle\fR (issu du paquet
\&\fBgradle-debian-helper\fR) exécute maintenant la suite de tests fournie par
l'amont automatiquement. Pour supprimer ce type de comportement, surchargez
\&\fBdh_auto_test\fR.
.IP "\-" 8
L'outil \fBdh_installman\fR s'interrompt maintenant s'il voit des définitions
contradictoires d'une page de manuel. Cela se produit habituellement si le
système de construction amont installe une version compressée et que le
paquet liste une version non compressée de la page de manuel dans \fIdebian/\fIpaquet\fI.manpages\fR. La correction la plus simple est de supprimer
la page de manuel de \fIdebian/\fIpaquet\fI.manpages\fR (en considérant que
les deux versions sont identiques).
.IP "\-" 8
Les outils \fBdh_auto_*\fR réinitialisent désormais les variables
d'environnement \fB\s-1HOME\s0\fR et la variable commune \fBXDG_*\fR. Veuillez consulter
la description des variables d'environnement dans \*(L"\s-1ENVIRONMENT\*(R"\s0 pour voir
comment elles sont gérées.
.Sp
\&\fICette fonctionnalité a changé entre debhelper 13 et debhelper 13.2.\fR
.IP "\-" 8
La commande \fBdh\fR produira maintenant une erreur si une cible de réécriture
ou d'accroche pour une commande obsolète est présente dans \fIdebian/rules\fR
(par exemple, \fBoverride_dh_systemd_enable:\fR).
.IP "\-" 8
La commande \fBdh_missing\fR aura l'option \fB\-\-fail\-missing\fR par défaut. Il est
possible de revenir à un avertissement non fatal en passant explicitement
l'option \fB\-\-list\-missing\fR comme dans le niveau de compatibilité 12.
.Sp
Si vous ne voulez pas non plus de l'avertissement, veuillez omettre l'appel
à \fBdh_missing\fR. Si l'automate de commandes \fBdh\fR est utilisé, vous pouvez
faire cela en insérant une cible de réécriture vide dans le fichier
\&\fIdebian/rules\fR du paquet correspondant. Comme dans l’exemple :
.Sp
.Vb 2
\&    # Désactive dh_missing
\&    override_dh_missing:
.Ve
.IP "\-" 8
L'automate de commandes \fBdh\fR exécute maintenant \fBdh_installtmpfiles\fR dans
la séquence par défaut. \fBdh_installtmpfiles\fR se charge de la gestion des
fichiers de configuration de \fItmpfiles.d\fR. La fonctionnalité apparentée
dans \fBdh_installsystemd\fR est désormais désactivée.
.Sp
Notez que \fBdh_installtmpfiles\fR répond à \fIdebian/\fIpaquet\fI.tmpfiles\fR là
où \fBdh_installsystemd\fR utilisait un nom sans le « s » final.
.IP "\-" 8
Beaucoup d'outils \fBdh_*\fR prennent en charge un développement de variables
limité au moyen de la syntaxe \fB${toto}\fR. Dans de nombreux cas, cela peut
être utilisé pour référencer des chemins qui contiennent soit des espaces,
soit des valeurs \fBdpkg\-architecture\fR\|(1). Bien que cela puisse réduire le
besoin de \fBdh\-exec\fR\|(1) dans certains cas, ce \fBn'est pas\fR une alternative à
\&\fBdh\-exec\fR\|(1) en général. Si un filtrage, un renommage, etc. est nécessaire,
le paquet aura encore besoin de \fBdh\-exec\fR\|(1).
.Sp
Veuillez consulter \*(L"Substitutions dans les fichiers de configuration de
debhelper\*(R" pour la syntaxe et les variables de substitution
disponibles. Pour ceux qui écrivent des outils \fBdh_*\fR, le développement de
substitution intervient comme élément des fonctions \fBfilearray\fR et
\&\fBfiledoublearray\fR.
.IP "\-" 8
L'automate de commandes \fBdh\fR omettra toutes les cibles d'accroche et de
substitution pour \fBdh_auto_test\fR, \fBdh_dwz\fR et \fBdh_strip\fR quand
\&\fB\s-1DEB_BUILD_OPTIONS\s0\fR liste les options \fBnocheck\fR ou \fBnostrip\fR
correspondantes.
.Sp
Tout paquet comptant sur ces cibles pour être toujours exécuté devrait
plutôt déplacer la logique correspondante de ces cibles. Par exemple, le
code d’empaquetage non lié aux tests provenant de \fBoverride_dh_auto_test\fR
devrait avoir été déplacé dans \fBexecute_after_dh_auto_build\fR ou
\&\fBexecute_before_dh_auto_install\fR.
.IP "\-" 8
Le système de construction \fBcmake\fR passe désormais l'option
\&\fB\-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON\fR à \fBcmake\fR\|(1) pour accélérer le
processus d'installation automatique. Si pour une raison quelconque vous
avez besoin de revenir au comportement antérieur, réécrivez le paramètre :
.Sp
.Vb 1
\&    dh_auto_configure \-\- \-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ...
.Ve
.RE
.RS 4
.RE
.IP "v12" 4
.IX Item "v12"
Les changements par rapport à la version 11 sont :
.RS 4
.IP "\-" 8
\&\fBdh_makeshlibs\fR génère maintenant des fichiers shlibs avec des dépendances
versionnées par défaut. Cela veut dire que \fB\-VUpstream\-Version\fR (ou \fB\-V\fR)
est maintenant le comportement par défaut.
.Sp
Si une dépendance non versionnée est requise, cela peut être obtenu en
passant \fB\-VNone\fR à la place. Veuillez tout de même consulter
\&\fBdh_makeshlibs\fR\|(1) pour l'utilisation des dépendances non versionnées.
.IP "\-" 8
L'option \fB\-s\fR (\fB\-\-same\-arch\fR) est supprimée. Veuillez utiliser \fB\-a\fR
(\fB\-\-arch\fR) à la place.
.IP "\-" 8
Appeler \fBdh_clean \-k\fR provoque maintenant une erreur à la place de
l'avertissement d'obsolescence.
.IP "\-" 8
L'option \fB\-\-no\-restart\-on\-upgrade\fR de \fBdh_installinit\fR a été
supprimée. Veuillez utiliser le nouveau nom \fB\-\-no\-stop\-on\-upgrade\fR.
.IP "\-" 8
Il y avait un bogue dans les fonctions \fBdoit\fR (et équivalent) de
Debian::Debhelper::Dh_Lib qui créait un shell dans une circonstance
particulière. Ce bogue est maintenant supprimé et provoquera une erreur de
type « commande non trouvée » dans les outils qui l'utilisaient.
.IP "\-" 8
Les options \fB\-\-list\-missing\fR et \fB\-\-fail\-missing\fR de \fBdh_install\fR ont été
supprimées. Veuillez utiliser \fBdh_missing\fR et ses options correspondantes,
qui peuvent aussi voir les fichiers installés par les autres outils.
.IP "\-" 8
L'outil \fBdh_installinit\fR n'installe plus de configuration pour upstart. À
la place, il abandonnera la construction s'il trouve un ancien fichier de
configuration upstart. Cela pour rappeler au mainteneur de s'assurer de
correctement supprimer les anciens fichiers de configuration livrés dans les
anciennes versions du paquet.
.IP "\-" 8
L'outil \fBdh_installdeb\fR valide basiquement quelques commandes
\&\fBdpkg\-maintscript\-helper\fR\|(1) et renvoie une erreur si la commande semble
incorrecte.
.IP "\-" 8
Le comportement par défaut de \fBdh_missing\fR est maintenant
\&\fB\-\-list\-missing\fR.
.IP "\-" 8
\&\fBdh_makeshlibs\fR passera maintenant les bibliothèques à
\&\fBdpkg\-gensymbols\fR\|(1) si le binaire \s-1ELF\s0 a un \s-1SONAME\s0 (contenant « .so »).
.IP "\-" 8
\&\fBdh_compress\fR ne compresse plus les exemples (c'est\-à\-dire tout ce qui est
installé dans \fI</usr/share/doc/\fIpaquet\fI/examples\fR>).
.IP "\-" 8
La séquence standard de \fBdh\fR comprend maintenant \fBdh_dwz\fR et
\&\fBdh_installinitramfs\fR par défaut. Cela rend les séquences \fBdwz\fR et
\&\fBinstallinitramfs\fR obsolètes et elles échoueront avec une erreur. Si vous
souhaitez sauter ces commandes, veuillez insérer des cibles de réécriture
vides pour elles dans \fIdebian/rules\fR (par exemple \fIoverride_dh_dwz:\fR).
.IP "\-" 8
Les systèmes de construction \fBmeson\fR et \fBautoconf\fR ne positionnent plus
explicitement la variable \fB\-\-libexecdir\fR, et s'appuient donc sur le système
de construction par défaut – qui devrait être \fB/usr/libexec\fR (selon la
\&\s-1FHS 3.0,\s0 adoptée dans la Charte Debian 4.1.5).
.Sp
Si un paquet amont particulier n'utilise pas la bonne valeur par défaut, le
paramètre peut souvent être passé manuellement avec
\&\fBdh_auto_configure\fR\|(1). Par exemple :
.Sp
.Vb 2
\&    override_dh_auto_configure:
\&        dh_auto_configure \-\- \-\-libexecdir=/usr/libexec
.Ve
.Sp
Remarquez le \fB\-\-\fR avant le paramètre \fB\-\-libexecdir\fR.
.IP "\-" 8
\&\fBRetroactively removed in debhelper/13.5\fR:
.Sp
The \fBdh_installdeb\fR tool would no longer installs the maintainer provided
\&\fIconffiles\fR file as it was deemed unnecessary.  However, the
\&\fBremove-on-upgrade\fR from dpkg/1.20 made the file relevant again and
\&\fBdh_installdeb\fR now installs it again in compat levels 12+.
.IP "\-" 8
\&\fBdh_installsystemd\fR ne s'appuie plus sur \fBdh_installinit\fR pour s'occuper
des services systemd qui ont une alternative pour sysvinit. Les deux outils
doivent maintenant être utilisés dans ce cas pour s'assurer que le service
est démarré correctement, à la fois avec systemd et sysvinit.
.Sp
Si vous avez une réécriture pour \fBdh_installinit\fR (par exemple pour
l'appeler avec \fB\-\-no\-start\fR), vous en aurez sûrement besoin d'une pour
\&\fBdh_installsystemd\fR aussi.
.Sp
Ce changement amène \fBdh_installinit\fR à injecter un champ
\&\fImisc:Pre\-Depends\fR sur \fBinit-system-helpers (>= 1.54~)\fR. Veuillez vous
assurer que le paquet utilise \fB${misc:Pre\-Depends}\fR dans son champ
\&\fBPre-Depends\fR avant de mettre à niveau vers la compat 12.
.IP "\-" 8
L'outil tiers \fBdh_golang\fR (du paquet \fBdh-golang\fR) utilise maintenant la
variable \fB\s-1DH_GOLANG_EXCLUDE\s0\fR pour l'installation des sources dans les
paquets \-dev, et plus uniquement lors de la construction. Veuillez
positionner \fB\s-1DH_GOLANG_EXCLUDES_ALL\s0\fR à faux pour obtenir le comportement
précédent. Consultez \fB\fBDebian::Debhelper::Buildsystem::golang\fB\|(3pm)\fR pour
plus de détails et des exemples.
.IP "\-" 8
\&\fBdh_installsystemduser\fR est maintenant inclus par défaut dans la séquence
\&\fBdh\fR standard.
.IP "\-" 8
Le système de construction \fBpython-distutils\fR est supprimé. Veuillez
utiliser le système tiers \fBpybuild\fR à la place.
.RE
.RS 4
.RE
.IP "v11" 4
.IX Item "v11"
Ce mode est déconseillé.
.Sp
Le niveau de compatibilité 11 est déconseillé pour les nouveaux paquets
parce qu'il souffre d'une interaction de fonctionnalités entre
dh_installinit et dh_installsystemd faisant que les services ne
fonctionnent pas correctement dans certains cas. Vous devriez envisager
l'utilisation à la place des modes de compatibilité 10 ou 12. Plus de
détails sur ce problème sont disponibles dans le bogue Debian n° 887904 et
dans le message
<https://lists.debian.org/debian\-release/2019/04/msg01442.html>.
.Sp
Les changements par rapport à la version 10 sont :
.RS 4
.IP "\-" 8
\&\fBdh_installinit\fR n'installe plus de fichiers \fIservice\fR ou \fItmpfile\fR, ni
ne crée de scripts de maintenance pour ces fichiers. Veuillez utiliser le
nouvel assistant \fBdh_installsystemd\fR à la place.
.IP "\-" 8
Les outils \fBdh_systemd_enable\fR et \fBdh_systemd_start\fR ont été remplacés par
un nouvel assistant \fBdh_installsystemd\fR. Pour la même raison, la séquence
\&\fBsystemd\fR de \fBdh\fR a aussi été retirée. Si vous avez besoin de désactiver
\&\fBdh_installsystemd\fR, veuillez utiliser une cible de réécriture vide.
.Sp
Veuillez noter que \fBdh_installsystemd\fR a un comportement légèrement
différent dans certains cas (par exemple lors de l'utilisation du paramètre
\&\fB\-\-name\fR).
.IP "\-" 8
\&\fBdh_installdirs\fR ne crée plus les répertoires debian/\fIpaquet\fR sans qu'on
le lui demande explicitement (ou il doit créer un sous\-répertoire à
l'intérieur).
.Sp
La grande majorité des paquets ne seront pas affectés par ce changement.
.IP "\-" 8
Le système de construction \fBmakefile\fR passe maintenant les options
\&\fBINSTALL=\*(L"install \-\-strip\-program=true\*(R"\fR à \fBmake\fR\|(1). Les systèmes dérivés
(comme \fBconfigure\fR ou \fBcmake\fR) ne sont pas affectés par ce changement.
.IP "\-" 8
Le système de construction \fBautoconf\fR passe maintenant l'option
\&\fB\-\-runstatedir=/run\fR à \fI./configure\fR.
.IP "\-" 8
Le système de construction \fBcmake\fR passe maintenant l'option
\&\fB\-DCMAKE_INSTALL_RUNSTATEDIR=/run\fR à \fBcmake\fR\|(1).
.IP "\-" 8
\&\fBdh_installman\fR préfère maintenant détecter le langage à partir du chemin
plutôt que de l'extension.
.IP "\-" 8
\&\fBdh_auto_install\fR crée maintenant uniquement le répertoire de destination
nécessaire. Auparavant, le répertoire de construction de chaque paquet était
créé. Cela n'affectera pas les paquets qui se construisent uniquement avec
debhelper, mais pourrait faire apparaître des bogues dans les commandes qui
ne sont pas incluses avec debhelper.
.IP "\-" 8
Les outils \fBdh_installdocs\fR, \fBdh_installexamples\fR, \fBdh_installinfo\fR et
\&\fBdh_installman\fR renvoient maintenant une erreur si leur configuration
contient un motif qui ne correspond à rien ou qui référence un chemin qui
n'existe pas.
.Sp
Les exceptions connues incluent la construction avec le profil \fBnodoc\fR, où
les outils ci-dessus permettront un échec silencieux de la correspondance
lorsque le motif est utilisé pour spécifier la documentation.
.IP "\-" 8
Les outils \fBdh_installdocs\fR, \fBdh_installexamples\fR, \fBdh_installinfo\fR et
\&\fBdh_installman\fR acceptent maintenant le paramètre \fB\-\-sourcedir\fR avec la
même signification que dans \fBdh_install\fR. De plus, ils se rabattent sur
\&\fIdebian/tmp\fR comme \fBdh_install\fR.
.Sp
Note de migration : un bogue dans debhelper 11 jusqu'à 11.1.5 faisait que
\&\fBdh_installinfo\fR ignorait \fB\-\-sourcedir\fR de manière incorrecte.
.IP "\-" 8
Les systèmes de construction \fBperl-makemaker\fR et \fBperl-build\fR ne passent
plus l'option \fB\-I.\fR à Perl. Les paquets qui ont encore besoin de ce
comportement peuvent l'émuler en utilisant la variable d'environnement
\&\fB\s-1PERL5LIB\s0\fR. Par exemple en ajoutant \fBexport PERL5LIB=.\fR dans leur fichier
\&\fIdebian/rules\fR (ou équivalent).
.IP "\-" 8
La variable d'environnement \fB\s-1PERL_USE_UNSAFE_INC\s0\fR n'est plus définie par
\&\fBdh\fR, ni aucun des outils \fBdh_auto_*\fR. Cela avait été ajouté comme
contournement temporaire, pour éviter les échecs de construction d’un grand
nombre de paquets en même temps.
.Sp
De plus, cette fonction deviendra peut\-être obsolète car l'amont a
l'intention de retirer la prise en charge de la variable d'environnement
\&\fB\s-1PERL_USE_UNSAFE_INC\s0\fR. Lorsque ce sera le cas, cette variable sera aussi
supprimée rétroactivement des niveaux de compatibilité existants.
.IP "\-" 8
L'assistant \fBdh_makeshlibs\fR termine maintenant sur une erreur si objdump
renvoie une valeur de sortie différente de zéro lors de l'analyse d'un
fichier.
.IP "\-" 8
Les outils \fBdh_installdocs\fR et \fBdh_installexamples\fR pourraient maintenant
installer \fIla plupart\fR de la documentation dans un répertoire différent,
pour satisfaire les recommandations de la Charte Debian §12.3 (depuis la
version 3.9.7).
.Sp
Si un paquet source contient un seul paquet binaire dans \fIdebian/control\fR,
ou si aucun des paquets n'est un paquet \fI\-doc\fR, alors ce changement n'a pas
d'effet pour ce paquet source, et vous pouvez aller au changement suivant.
.Sp
Par défaut, ces outils essaient maintenant de déterminer un « paquet
principal pour la documentation » (que l'on appellera \fIdoc-main-package\fR)
pour chaque paquet \fI\-doc\fR. S'ils trouvent un tel \fIdoc-main-package\fR, ils
installeront la documentation sous \fI/usr/share/doc/\fIdoc-main-package\fI\fR
pour le paquet considéré. C'est\-à\-dire que le chemin peut changer, mais la
documentation est toujours fournie par le paquet \fI\-doc\fR.
.Sp
L'option \fB\-\-doc\-main\-package\fR peut être utilisée si la détection
automatique est insuffisante, ou pour réinitialiser le chemin à sa valeur
précédente s'il y a une raison de diverger des recommandations de la
Charte Debian.
.Sp
Quelques documents ne sont pas affectés par ce changement. En particulier le
fichier copyright, les fichiers changelog, \s-1README\s0.Debian, etc. Ces fichiers
seront toujours installés sous \fI/usr/share/doc/\fIpackage\fI\fR.
.IP "\-" 8
Les outils \fBdh_strip\fR et \fBdh_shlibdeps\fR n'utilisent plus les motifs de
noms de fichiers pour déterminer les fichiers à traiter. À la place, ils
ouvrent le fichier et cherchent un en\-tête \s-1ELF\s0 pour déterminer si ce fichier
est un objet partagé ou un exécutable \s-1ELF.\s0
.Sp
Ce changement peut forcer les outils à traiter plus de fichiers qu'avant.
.RE
.RS 4
.RE
.IP "v10" 4
.IX Item "v10"
Les changements par rapport à la version 9 sont :
.RS 4
.IP "\-" 8
\&\fBdh_installinit\fR n'installe plus de fichier nommé debian/<paquet> comme
script d'initialisation.
.IP "\-" 8
\&\fBdh_installdocs\fR renverra une erreur s'il détecte des liens créés avec
\&\fB\-\-link\-doc\fR entre des paquets de l'architecture « all » et non\-« all » car
cela casse les binNMUs (envois de binaires par quelqu'un d'autre que le
responsable).
.IP "\-" 8
\&\fBdh_installdeb\fR n'installe plus de fichier debian/<paquet>.shlibs fourni
par le responsable du paquet. Cela est maintenant effectué par
\&\fBdh_makeshlibs\fR.
.IP "\-" 8
\&\fBdh_installwm\fR refuse de créer un paquet cassé si aucune page de manuel ne
peut être trouvée (requis pour l'inscription de l'alternative
x\-window-manager).
.IP "\-" 8
Debhelper active par défaut la parallélisation pour tous les systèmes de
construction qui le gèrent. Cela peut être désactivé en utilisant l'option
\&\fB\-\-no\-parallel\fR ou en passant la valeur \fB1\fR à l'option \fB\-\-max\-parallel\fR.
.IP "\-" 8
La commande \fBdh\fR n'acceptera aucun des paramètres obsolètes de « manual
sequence control » (\fB\-\-before\fR, \fB\-\-after\fR, etc.). Veuillez utiliser les
cibles de réécritures à la place.
.Sp
\&\fBApplication rétroactive aux niveaux de compatibilité antérieurs :\fR \fBdh\fR
n'accepte plus aucun de ces paramètres depuis debhelper 12.4.
.IP "\-" 8
La commande \fBdh\fR n'utilisera plus les fichiers journaux pour enregistrer
quelles commandes ont été exécutées. La commande \fBdh\fR se souvient
\&\fItoujours\fR si la séquence « build » a été effectuée et l'omet si c'est le
cas.
.Sp
Les principales conséquences de cela sont :
.RS 8
.IP "\-" 4
Il est maintenant plus facile de déboguer les séquences \fIinstall\fR et
\&\fIbinary\fR parce qu'elles peuvent maintenant être facilement re\-exécutées
(sans avoir à refaire un cycle complet de « clean & rebuild »)
.IP "\-" 4
La principale précaution est que \fBdh_*\fR enregistre uniquement ce qui s'est
passé dans une unique cible de réécriture. Lorsque tous les appels à une
commande \fBdh_cmd\fR donnée arrivent dans la même cible de réécriture, tout
fonctionnera comme avant.
.Sp
Exemple de ce qui pourrait mal se passer :
.Sp
.Vb 2
\&  override_dh_toto:
\&    dh_toto \-pmon_paquet
\&
\&  override_dh_titi:
\&    dh_titi
\&    dh_toto \-\-remaining
.Ve
.Sp
Dans ce cas, l'appel à \fBdh_foo \-\-remaining\fR inclura \fIaussi\fR \fImon_paquet\fR,
car \fBdh_foo \-pmon_paquet\fR a été exécuté dans une cible de réécriture
différente. Ce problème n'est pas limité à \fB\-\-remaining\fR et concerne aussi
\&\fB\-a\fR, \fB\-i\fR, etc.
.RE
.RS 8
.RE
.IP "\-" 8
À présent, la commande \fBdh_installdeb\fR échappe les caractères du shell dans
les lignes du fichier de config \fImaintscript\fR. C'était l'intention
originale mais cela n'a jamais fonctionné correctement et les paquets ont
commencé à compter sur l'échappement incomplet (p. ex. en encadrant les noms
de fichiers de guillemets).
.IP "\-" 8
La commande \fBdh_installinit\fR utilise maintenant \fB\-\-restart\-after\-upgrade\fR
par défaut. Les paquets nécessitant le comportement précédent devraient
utiliser l'option \fB\-\-no\-restart\-after\-upgrade\fR.
.IP "\-" 8
La séquence \fBautoreconf\fR est maintenant activée par défaut. Veuillez passer
l'option \fB\-\-without autoreconf\fR à \fBdh\fR si cela n'est pas voulu pour
certains paquets.
.IP "\-" 8
La séquence \fBsystemd\fR est maintenant activée par défaut. Veuillez passer
l'option \fB\-\-without systemd\fR à \fBdh\fR si cela n'est pas voulu pour certains
paquets.
.IP "\-" 8
\&\fBSupprimé rétroactivement :\fR \fBdh\fR ne crée plus le répertoire de
construction du paquet lors de l'omission des commandes de debhelper en
cours. Cela n'affectera pas les paquets qui se construisent uniquement avec
debhelper, mais pourrait faire apparaître des bogues dans les commandes qui
ne sont pas incluses avec debhelper.
.Sp
Cette fonctionnalité de compatibilité avait un bogue depuis sa création dans
debhelper/9.20130516, qui la faisait échouer en compat 9 et précédent. Comme
il n'y a eu aucun rapport de problème causé par ce bogue en 5 ans, cela a
été supprimé plutôt que corrigé.
.RE
.RS 4
.RE
.IP "v9" 4
.IX Item "v9"
Les changements par rapport à la version 8 sont :
.RS 4
.IP "\-" 8
Prise en charge multiarchitecture. En particulier, \fBdh_auto_configure\fR
passe les répertoires multiarchitectures à \fBautoconf\fR dans \fB\-\-libdir\fR et
\&\fB\-\-libexecdir\fR.
.IP "\-" 8
\&\fBdh\fR connaît les dépendances classiques entre les cibles de
\&\fIdebian/rules\fR. Donc « \fBdh binary\fR » exécutera toutes les cibles build,
build-arch, build-indep, install, etc., présentes dans le fichier
\&\fIrules\fR. Il n'est pas nécessaire de définir une cible binary avec des
dépendances explicites sur les autres cibles.
.IP "\-" 8
\&\fBdh_strip\fR compresse les fichiers de symboles de mise au point pour réduire
la taille d'installation des paquets \-dbg.
.IP "\-" 8
\&\fBdh_auto_configure\fR n'inclut pas le nom du paquet source dans
\&\fB\-\-libexecdir\fR en utilisant \fBautoconf\fR.
.IP "\-" 8
\&\fBdh\fR n'active pas \fB\-\-with=python\-support\fR par défaut.
.Sp
(Obsolète puisque l'outil \fBdh_pysupport\fR a été retiré de
Debian Stretch. Depuis debhelper 10.3, \fBdh\fR n'active plus cette séquence
quel que soit le niveau de compatibilité)
.IP "\-" 8
Tous les programmes debhelper \fBdh_auto_\fR\fI*\fR et \fBdh\fR configurent les
variables d'environnement renvoyées par \fBdpkg-buildflags\fR, sauf si elles
sont déjà configurées.
.IP "\-" 8
\&\fBdh_auto_configure\fR passe les \s-1CFLAGS, CPPFLAGS\s0 et \s-1LDFLAGS\s0 de
\&\fBdpkg-buildflags\fR à \fIMakefile.PL\fR et \fIBuild.PL\fR de Perl.
.IP "\-" 8
\&\fBdh_strip\fR place les symboles de mise au point séparés à un endroit en
fonction de leur identifiant de construction (build-id).
.IP "\-" 8
Les fichiers de configuration exécutables de debhelper sont exécutés et leur
sortie est utilisée comme configuration.
.RE
.RS 4
.Sp
Ce mode est déconseillé.
.RE
.IP "v8" 4
.IX Item "v8"
Les changements par rapport à la version 7 sont :
.RS 4
.IP "\-" 8
Les commandes échoueront plutôt que de produire une alerte lorsqu'elles
recevront des options inconnues.
.IP "\-" 8
\&\fBdh_makeshlibs\fR va exécuter le programme \fBdpkg-gensymbols\fR sur toutes les
bibliothèques partagées qu'il génère pour les fichiers shlibs. \fB\-X\fR peut
alors être utilisé pour exclure certaines bibliothèques. En outre, les
bibliothèques rangées à des emplacements inhabituels que \fBpkg-gensymbols\fR
n'aurait pas traitées avant qu'elles ne lui soient transmises, induisent un
changement de comportement qui peut causer l'échec de la construction de
certains paquets.
.IP "\-" 8
\&\fBdh\fR exige que la séquence à exécuter soit indiquée en tant que premier
paramètre. Tous les commutateurs doivent venir après. C'est\-à\-dire qu'il
faut écrire « \fBdh $@\fR \-\-toto », et non « \fBdh \-\-toto\fR $@ »
.IP "\-" 8
\&\fBdh_auto_*\fR utilise préférentiellement \fBModule::Build\fR de Perl au lieu de
\&\fIMakefile.PL\fR.
.RE
.RS 4
.Sp
Ce mode est déconseillé.
.RE
.IP "v7" 4
.IX Item "v7"
Ce mode est déconseillé.
.Sp
C'est le niveau de compatibilité le plus bas pris en charge.
.Sp
Si vous mettez à jour depuis un niveau de compatibilité antérieur, veuillez
consulter \fBdebhelper\-obsolete\-compat\fR\|(7).
.SH "VOIR AUSSI"
.IX Header "VOIR AUSSI"
.IP "\fBdebhelper\-obsolete\-compat\fR\|(7)" 4
.IX Item "debhelper-obsolete-compat"
Upgrading from a (now) obsolete compatibility level? This document covers
the upgrade checklist up to the earliest supported level.
.IP "\fBdebhelper\fR\|(7)" 4
.IX Item "debhelper"
General information about the debhelper framework. This document also covers
how to declare your chosen debhelper compat level.
.SH "AUTEURS"
.IX Header "AUTEURS"
Niels Thykier <niels@thykier.net>
.PP
Joey Hess
.SH "TRADUCTION"
.IX Header "TRADUCTION"
Cette traduction est maintenue à l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'équipe francophone de traduction
de Debian.
.PP
Veuillez signaler toute erreur de traduction en écrivant à
<debian\-l10n\-french@lists.debian.org> ou par un rapport de bogue sur le paquet
debhelper.
.PP
Vous pouvez toujours avoir accès à la version anglaise de ce document en
utilisant la commande « man \-L C <section> <page_de_man> ».