.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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 "2019-02-23" "12.1.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 \- Ensemble d'outils regroupés sous le nom de debhelper
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdh_\fR\fI*\fR [\fB\-v\fR] [\fB\-a\fR] [\fB\-i\fR] [\fB\-\-no\-act\fR] [\fB\-p\fR\fIpaquet\fR]
[\fB\-N\fR\fIpaquet\fR] [\fB\-P\fR\fItmpdir\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Debhelper facilite la construction des paquets Debian. La philosophie qui
sous-tend debhelper est de fournir une collection de petits outils simples
et facilement compréhensibles qui seront exploités dans \fIdebian/rules\fR pour
automatiser les tâches courantes liées à la construction des paquets, d'où
un travail allégé pour le responsable. Dans une certaine mesure, cela
signifie également que ces outils peuvent être adaptés aux modifications
éventuelles de la Charte Debian. Les paquets qui utiliseront debhelper ne
nécessiteront qu'une simple reconstruction pour être conformes aux nouvelles
règles.
.PP
Un fichier \fIdebian/rules\fR typique, exploitant debhelper, appellera
séquentiellement plusieurs des commandes de debhelper ou bien utilisera
\&\fBdh\fR\|(1) pour automatiser ce processus. Des exemples de fichiers
debian/rules qui exploitent debhelper se trouvent dans
\&\fI/usr/share/doc/debhelper/examples/\fR
.PP
Pour créer un nouveau paquet Debian en utilisant debhelper, il suffit de
copier un des fichiers d'exemple et de le modifier manuellement. Il est
possible également d'essayer le paquet \fBdh-make\fR qui contient une commande
dh_make automatisant partiellement le processus. Pour se
familiariser avec ces concepts, le paquet Debian \fBmaint-guide\fR contient un
cours sur la construction d'un premier paquet avec debhelper.
.PP
Sauf lorsque l'outil explicite le contraire, tous les outils debhelper sont
prévus pour être exécutés dans le répertoire racine d'un paquet source
désarchivé. Cela leur permet de trouver les fichiers \fIdebian/control\fR.
.SH "COMMANDES DE DEBHELPER"
.IX Header "COMMANDES DE DEBHELPER"
Voici la liste des commandes debhelper disponibles. Consulter leurs pages de
manuel respectives pour obtenir des informations complémentaires.
.IP "\fBdh_auto_build\fR\|(1)" 4
.IX Item "dh_auto_build"
Construire automatiquement un paquet
.IP "\fBdh_auto_clean\fR\|(1)" 4
.IX Item "dh_auto_clean"
Faire le ménage automatiquement après une construction de
paquet
.IP "\fBdh_auto_configure\fR\|(1)" 4
.IX Item "dh_auto_configure"
Configurer automatiquement un paquet préalablement à sa
construction
.IP "\fBdh_auto_install\fR\|(1)" 4
.IX Item "dh_auto_install"
Lancer automatiquement make install ou équivalent
.IP "\fBdh_auto_test\fR\|(1)" 4
.IX Item "dh_auto_test"
Exécuter automatiquement le jeu d'essai d'un paquet
.IP "\fBdh_bugfiles\fR\|(1)" 4
.IX Item "dh_bugfiles"
Installer les fichiers de personnalisation de rapports de
bogue dans les répertoires des paquets construits
.IP "\fBdh_builddeb\fR\|(1)" 4
.IX Item "dh_builddeb"
Construire des paquets binaires Debian
.IP "\fBdh_clean\fR\|(1)" 4
.IX Item "dh_clean"
Nettoyer les répertoires de construction du paquet
.IP "\fBdh_compress\fR\|(1)" 4
.IX Item "dh_compress"
Compresser les fichiers dans le répertoire de construction du
paquet et modifier les liens symboliques en conséquence
.IP "\fBdh_dwz\fR\|(1)" 4
.IX Item "dh_dwz"
Optimiser l'information de débogage \s-1DWARF\s0 dans les binaires \s-1ELF\s0
grâce à dwz
.IP "\fBdh_fixperms\fR\|(1)" 4
.IX Item "dh_fixperms"
Ajuster les droits sur les fichiers du répertoire de
construction du paquet
.IP "\fBdh_gencontrol\fR\|(1)" 4
.IX Item "dh_gencontrol"
Produire et installer le fichier de contrôle
.IP "\fBdh_icons\fR\|(1)" 4
.IX Item "dh_icons"
Mettre à jour les caches des icônes Freedesktop
.IP "\fBdh_install\fR\|(1)" 4
.IX Item "dh_install"
Installer les fichiers dans le répertoire de construction du
paquet
.IP "\fBdh_installcatalogs\fR\|(1)" 4
.IX Item "dh_installcatalogs"
Installer et inscrire les catalogues \s-1SGML\s0
.IP "\fBdh_installchangelogs\fR\|(1)" 4
.IX Item "dh_installchangelogs"
Installer les journaux de suivi des modifications
(changelog) dans les répertoires de construction du paquet
.IP "\fBdh_installcron\fR\|(1)" 4
.IX Item "dh_installcron"
Installer les scripts cron dans etc/cron.*
.IP "\fBdh_installdeb\fR\|(1)" 4
.IX Item "dh_installdeb"
Installer des fichiers dans le répertoire \s-1DEBIAN\s0
.IP "\fBdh_installdebconf\fR\|(1)" 4
.IX Item "dh_installdebconf"
Installer les fichiers utilisés par debconf dans les
répertoires de construction du paquet
.IP "\fBdh_installdirs\fR\|(1)" 4
.IX Item "dh_installdirs"
Créer des sous\-répertoires dans le répertoire de
construction du paquet
.IP "\fBdh_installdocs\fR\|(1)" 4
.IX Item "dh_installdocs"
Installer la documentation dans le répertoire de
construction du paquet
.IP "\fBdh_installemacsen\fR\|(1)" 4
.IX Item "dh_installemacsen"
Inscrire un paquet additionnel Emacs
.IP "\fBdh_installexamples\fR\|(1)" 4
.IX Item "dh_installexamples"
Installer les fichiers d'exemples dans le répertoire de
construction du paquet
.IP "\fBdh_installifupdown\fR\|(1)" 4
.IX Item "dh_installifupdown"
Installer les accroches (hooks) if-up et if-down
.IP "\fBdh_installinfo\fR\|(1)" 4
.IX Item "dh_installinfo"
Installer les fichiers info
.IP "\fBdh_installinit\fR\|(1)" 4
.IX Item "dh_installinit"
Installer les fichiers de service « init » dans le
répertoire de construction du paquet
.IP "\fBdh_installinitramfs\fR\|(1)" 4
.IX Item "dh_installinitramfs"
Installer les accroches (hooks) pour initramfs et
configurer les scripts de maintenance
.IP "\fBdh_installlogcheck\fR\|(1)" 4
.IX Item "dh_installlogcheck"
Installer les fichiers de règles de vérification des
journaux (logcheck rulefiles) dans etc/logcheck/
.IP "\fBdh_installlogrotate\fR\|(1)" 4
.IX Item "dh_installlogrotate"
Installer les fichiers de configuration de la rotation
des journaux (logrotate)
.IP "\fBdh_installman\fR\|(1)" 4
.IX Item "dh_installman"
Installer les pages de manuel dans le répertoire de
construction du paquet
.IP "\fBdh_installmenu\fR\|(1)" 4
.IX Item "dh_installmenu"
Installer les fichiers du menu Debian dans le répertoire de
construction du paquet
.IP "\fBdh_installmime\fR\|(1)" 4
.IX Item "dh_installmime"
Installer les fichiers « mime » dans le répertoire de
construction du paquet
.IP "\fBdh_installmodules\fR\|(1)" 4
.IX Item "dh_installmodules"
Inscrire les modules du noyau
.IP "\fBdh_installpam\fR\|(1)" 4
.IX Item "dh_installpam"
Installer les fichiers de support de \s-1PAM\s0
.IP "\fBdh_installppp\fR\|(1)" 4
.IX Item "dh_installppp"
Installer les fichiers ppp.ip\-up et ppp.ip\-down
.IP "\fBdh_installudev\fR\|(1)" 4
.IX Item "dh_installudev"
Installer les fichiers de règles udev
.IP "\fBdh_installwm\fR\|(1)" 4
.IX Item "dh_installwm"
Inscrire un gestionnaire de fenêtres (window manager)
.IP "\fBdh_installxfonts\fR\|(1)" 4
.IX Item "dh_installxfonts"
Inscrire les polices de caractères graphiques (X fonts)
.IP "\fBdh_link\fR\|(1)" 4
.IX Item "dh_link"
Créer les liens symboliques dans le répertoire de construction du
paquet
.IP "\fBdh_lintian\fR\|(1)" 4
.IX Item "dh_lintian"
Installer les fichiers « override » de lintian dans le
répertoire de construction du paquet
.IP "\fBdh_listpackages\fR\|(1)" 4
.IX Item "dh_listpackages"
Énumérer les paquets binaires que debhelper va traiter
.IP "\fBdh_makeshlibs\fR\|(1)" 4
.IX Item "dh_makeshlibs"
Créer automatiquement le fichier shlibs et exécuter
dpkg-gensymbols
.IP "\fBdh_md5sums\fR\|(1)" 4
.IX Item "dh_md5sums"
Créer le fichier DEBIAN/md5sums
.IP "\fBdh_movefiles\fR\|(1)" 4
.IX Item "dh_movefiles"
Déplacer des fichiers depuis debian/tmp dans des sous-paquets
.IP "\fBdh_perl\fR\|(1)" 4
.IX Item "dh_perl"
Déterminer les dépendances Perl et fait le ménage après MakeMaker
.IP "\fBdh_prep\fR\|(1)" 4
.IX Item "dh_prep"
Faire le ménage en vue de construire un paquet Debian
.IP "\fBdh_shlibdeps\fR\|(1)" 4
.IX Item "dh_shlibdeps"
Déterminer les dépendances envers les bibliothèques partagées
.IP "\fBdh_strip\fR\|(1)" 4
.IX Item "dh_strip"
Dépouiller les exécutables, les bibliothèques partagées et
certaines bibliothèques statiques
.IP "\fBdh_systemd_enable\fR\|(1)" 4
.IX Item "dh_systemd_enable"
Activer ou désactiver les fichiers unit de systemd
.IP "\fBdh_systemd_start\fR\|(1)" 4
.IX Item "dh_systemd_start"
Démarrer/arrêter/redémarrer des fichiers unit de systemd
.IP "\fBdh_testdir\fR\|(1)" 4
.IX Item "dh_testdir"
Vérifier le répertoire avant de construire un paquet Debian
.IP "\fBdh_testroot\fR\|(1)" 4
.IX Item "dh_testroot"
Vérifier que le paquet est construit avec les droits
nécessaires du superutilisateur (root)
.IP "\fBdh_usrlocal\fR\|(1)" 4
.IX Item "dh_usrlocal"
Migrer les répertoires usr/local dans les scripts de
maintenance du paquet
.SS "Commandes obsolètes"
.IX Subsection "Commandes obsolètes"
Quelques commandes debhelper sont obsolètes et ne devraient plus être
utilisées.
.IP "\fBdh_gconf\fR\|(1)" 4
.IX Item "dh_gconf"
Installer les fichiers par défaut de GConf et inscrire les
schémas (obsolète)
.IP "\fBdh_installmanpages\fR\|(1)" 4
.IX Item "dh_installmanpages"
Ancien programme d'installation des pages de manuel
(obsolète)
.SS "Autres commandes"
.IX Subsection "Autres commandes"
Si le nom d'un programme commence par \fBdh_\fR et qu'il n'est pas dans les
listes ci-dessus, cela signifie qu'il ne fait pas partie de la suite
debhelper. Cependant, il devrait tout de même fonctionner comme les autres
programmes décrits dans cette page.
.SH "FICHIERS DE CONFIGURATION DE DEBHELPER"
.IX Header "FICHIERS DE CONFIGURATION DE DEBHELPER"
Beaucoup de commandes de debhelper utilisent des fichiers du répertoire
\&\fIdebian/\fR pour piloter leur fonctionnement. Outre les fichiers
\&\fIdebian/changelog\fR et \fIdebian/control\fR, qui se trouvent dans tous les
paquets, et pas seulement dans ceux qui emploient debhelper, d'autres
fichiers peuvent servir à configurer le comportement des commandes
spécifiques de debhelper. Ces fichiers sont, en principe, nommés
debian/\fIpaquet\fR.toto (où \fIpaquet\fR est, bien sûr, à remplacer par le nom du
paquet concerné).
.PP
Par exemple, \fBdh_installdocs\fR utilise un fichier appelé
\&\fIdebian/package.docs\fR pour énumérer les fichiers de documentation qu'il
installera. Consulter les pages de manuel des différentes commandes pour
connaître le détail des noms et des formats des fichiers employés. D'une
façon générale, ces fichiers de configuration énumèrent les fichiers sur
lesquels devra porter l'action, à raison d'un fichier par ligne. Quelques
programmes de debhelper emploient des paires fichier/destination voire des
formats légèrement plus compliqués.
.PP
Veuillez noter que pour le premier (ou unique) paquet binaire listé dans
\&\fIdebian/control\fR, debhelper utilisera \fIdebian/toto\fR lorsqu'il n'y a aucun
fichier \fIdebian/\fIpaquet\fI.toto\fR. Cependant, c'est une bonne idée de garder
le préfixe \fI\fIpaquet\fI.\fR car c'est plus explicite. Les principales
exceptions sont les fichiers que debhelper installe par défaut dans chaque
paquet binaire lorsqu'il ne trouve pas de préfixe (comme \fIdebian/copyright\fR
ou \fIdebian/changelog\fR).
.PP
Dans quelques rares cas, il peut être utile d'exploiter différentes versions
de ces fichiers pour des architectures ou des systèmes d'exploitation
différents. S'il existe des fichiers appelés debian/\fIpaquet\fR.toto.\fI\s-1ARCH\s0\fR
ou debian/\fIpaquet\fR.toto.\fI\s-1OS\s0\fR, dans lesquels \fI\s-1ARCH\s0\fR et \fI\s-1OS\s0\fR correspondent
respectivement au résultat de « \fBdpkg-architecture \-qDEB_HOST_ARCH\fR » ou de
« \fBdpkg-architecture \-qDEB_HOST_ARCH_OS\fR », alors ils seront utilisés de
préférence aux autres fichiers plus généraux.
.PP
En général, ces fichiers de configuration sont employés pour indiquer des
listes de divers types de fichiers : documentation, fichiers d'exemple à
installer, fichiers à déplacer et ainsi de suite. Lorsque cela se justifie,
dans des cas comme ceux-ci, il est possible d'employer, dans ces fichiers,
les jokers (wildcard) standards de l'interpréteur de commandes (shell) (\fB?\fR
et \fB*\fR et \fB[\fR\fI..\fR\fB]\fR). Des commentaires peuvent être ajoutés dans ces
fichiers : les lignes commençant par \fB#\fR sont ignorées.
.PP
La syntaxe de ces fichiers est volontairement simple, pour les rendre
faciles à lire, à comprendre et à modifier.
.SS "Fichiers de configuration de l'exécutable debhelper."
.IX Subsection "Fichiers de configuration de l'exécutable debhelper."
Si vous avez besoin de plus de flexibilité, de nombreux outils de debhelper
(par exemple \fBdh_install\fR\|(1)) prennent en charge l'exécution d'un fichier
de configuration comme un script.
.PP
Pour utiliser cette fonctionnalité, il suffit de marquer le fichier comme
exécutable (\fB<chmod +x debian/\f(BIpaquet\fB.install \fR>). L'outil essaiera de
l'exécuter et utilisera la sortie du script. Le plus souvent, vous pouvez
utiliser \fBdh\-exec\fR\|(1) comme interpréteur du fichier de configuration pour
conserver la majorité de la syntaxe originale tout en gagnant en
flexibilité.
.PP
Lorsque vous utilisez des fichiers de configuration exécutables de
debhelper, veuillez vous souvenir des choses suivantes :
.IP "\(bu" 4
Le fichier de configuration exécutable \fBdoit\fR se terminer avec succès (le
code de retour doit l'indiquer).
.IP "\(bu" 4
La sortie sera utilisée exactement telle quelle. En particulier, debhelper
ne développera \fBpas\fR les jokers, ni ne supprimera les commentaires de la
sortie.
.PP
Si vous avez besoin de construire le paquet sur un système de fichiers où
l'on ne peut pas désactiver le bit d'exécution, vous pouvez utiliser
\&\fBdh\-exec\fR\|(1) et son script \fBstrip-output\fR.
.SH "OPTIONS PARTAGÉES DE DEBHELPER"
.IX Header "OPTIONS PARTAGÉES DE DEBHELPER"
Tous les programmes de debhelper acceptent les options suivantes.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
Mode verbeux : affiche toutes les commandes qui modifient le répertoire de
construction du paquet.
.IP "\fB\-\-no\-act\fR" 4
.IX Item "--no-act"
Empêche la construction de s'effectuer réellement. Si cette option est
utilisée avec \fB\-v\fR, le résultat sera l'affichage de ce que la commande
aurait fait.
.IP "\fB\-a\fR, \fB\-\-arch\fR" 4
.IX Item "-a, --arch"
Construit tous les paquets dépendants de l'architecture \fB\s-1DEB_HOST_ARCH\s0\fR.
.IP "\fB\-i\fR, \fB\-\-indep\fR" 4
.IX Item "-i, --indep"
Construit tous les paquets indépendants de l'architecture.
.IP "\fB\-p\fR\fIpaquet\fR, \fB\-\-package=\fR\fIpaquet\fR" 4
.IX Item "-ppaquet, --package=paquet"
Construit le paquet nommé \fIpaquet\fR. Cette option peut être répétée afin de
faire agir debhelper sur plusieurs paquets.
.IP "\fB\-s\fR, \fB\-\-same\-arch\fR" 4
.IX Item "-s, --same-arch"
Alias obsolète pour \fB\-a\fR.
.Sp
Cette option est supprimée dans le niveau de compatibilité 12.
.IP "\fB\-N\fR\fIpaquet\fR, \fB\-\-no\-package=\fR\fIpaquet\fR" 4
.IX Item "-Npaquet, --no-package=paquet"
Exclut le paquet indiqué du processus de construction, même si l'option
\&\fB\-a\fR, \fB\-i\fR ou \fB\-p\fR l'impliquait.
.IP "\fB\-\-remaining\-packages\fR" 4
.IX Item "--remaining-packages"
Exclut du processus de construction les paquets qui ont déjà été construits
préalablement par cette commande debhelper (c'est\-à\-dire, si la commande est
présente dans le journal de debhelper du paquet). Par exemple, si vous avez
besoin d'invoquer la commande avec des options spéciales seulement pour
certains paquets binaires, utilisez cette option lors de la dernière
invocation de la commande pour construire le reste des paquets avec les
options par défaut.
.IP "\fB\-\-ignore=\fR\fIfichier\fR" 4
.IX Item "--ignore=fichier"
Ignore le fichier indiqué. Cela peut être utilisé si \fIdebian/\fR contient un
fichier de configuration debhelper avec une commande qui ne doit pas être
prise en compte. Nota : \fIdebian/compat\fR, \fIdebian/control\fR et
\&\fIdebian/changelog\fR ne peuvent pas être ignorés, mais il n'existe aucune
raison valable de les ignorer.
.Sp
Par exemple, si vous récupérez en amont un fichier \fIdebian/init\fR que vous
ne voulez pas que \fBdh_installinit\fR installe, utilisez
\&\fB\-\-ignore=debian/init\fR
.IP "\fB\-P\fR\fItmpdir\fR, \fB\-\-tmpdir=\fR\fItmpdir\fR" 4
.IX Item "-Ptmpdir, --tmpdir=tmpdir"
Utilise le répertoire \fItmpdir\fR pour construire les paquets. Sinon, par
défaut, le répertoire utilisé est debian/\fIpaquet\fR
.IP "\fB\-\-mainpackage=\fR\fIpaquet\fR" 4
.IX Item "--mainpackage=paquet"
Cette option, peu utilisée, indique à debhelper le nom du « paquet
principal » pour lequel les fichiers \fIdebian/toto\fR peuvent être utilisés à
la place des fichiers habituels \fIdebian/paquet.toto\fR. Par défaut, debhelper
considère que le « paquet principal » est le premier paquet énuméré dans le
fichier \fIdebian/control\fR.
.IP "\fB\-O=\fR\fIoption\fR|\fIensemble\fR" 4
.IX Item "-O=option|ensemble"
Cette option est utilisée par \fBdh\fR\|(1) pour passer une ou plusieurs options,
indiquées par l'utilisateur, à toutes les commandes exécutées. Si la
commande prend en charge l'option ou l'ensemble d'options, elle prendra
effet. Si la commande n'accepte pas l'option (ou une partie de l'ensemble
d'options), elle sera ignorée.
.SH "OPTIONS COURANTES DE DEBHELPER"
.IX Header "OPTIONS COURANTES DE DEBHELPER"
Certains programmes de debhelper acceptent les options ci-dessous. Consulter
la page de manuel de chaque programme pour une explication complète du rôle
de ces options.
.IP "\fB\-n\fR" 4
.IX Item "-n"
Ne pas modifier les scripts de maintenance du paquet (\fIpostinst\fR,
\&\fIpostrm\fR, etc.)
.IP "\fB\-X\fR\fIélément\fR, \fB\-\-exclude=\fR\fIélément\fR" 4
.IX Item "-Xélément, --exclude=élément"
Permet d'exclure un élément du traitement. Cette option peut être employée
plusieurs fois afin d'exclure plusieurs éléments. L'\fIélément\fR est en
général une partie du nom de fichier, et tous les fichiers contenant le
texte indiqué seront exclus.
.IP "\fB\-A\fR, \fB\-\-all\fR" 4
.IX Item "-A, --all"
Précise que les fichiers (ou autres éléments) indiqués dans la ligne de
commande concernent \fBtous\fR les paquets construits et pas seulement le
premier.
.SH "OPTIONS DU PROCESSUS DE CONSTRUCTION"
.IX Header "OPTIONS DU PROCESSUS DE CONSTRUCTION"
Les programmes debhelper \fBdh_auto_\fR\fI*\fR comportent plusieurs processus de
construction et déterminent, de manière heuristique, lequel utiliser et
comment. Il peut être utile de modifier ce comportement par défaut. Tous ces
programmes \fBdh_auto_\fR\fI*\fR acceptent les options suivantes, typiquement
passées à \fBdh\fR\|(1), qui les passe ensuite à tous les programmes
\&\fBdh_auto_\fR\fI*\fR.
.IP "\fB\-S\fR\fIprocessus de construction\fR, \fB\-\-buildsystem=\fR\fIprocessus_de_construction\fR" 4
.IX Item "-Sprocessus de construction, --buildsystem=processus_de_construction"
Oblige à utiliser le processus de construction indiqué au lieu de tenter de
déterminer automatiquement celui qui pourrait être utilisable pour le
paquet.
.IP "\fB\-D\fR\fIrépertoire\fR, \fB\-\-sourcedirectory=\fR\fIrépertoire\fR" 4
.IX Item "-Drépertoire, --sourcedirectory=répertoire"
Considère que les sources du paquet sont situées dans le \fIrépertoire\fR
indiqué plutôt qu'au plus haut niveau de l'arborescence du paquet source.
.IP "\fB\-B\fR[\fIrépertoire\fR], \fB\-\-builddirectory=\fR[\fIrépertoire\fR]" 4
.IX Item "-B[répertoire], --builddirectory=[répertoire]"
Permet de construire le paquet en dehors de la structure source en utilisant
le \fIrépertoire\fR indiqué comme répertoire de construction. Si le paramètre
\&\fIrépertoire\fR n'est pas indiqué, un répertoire de construction par défaut
sera choisi.
.Sp
Si cette option n'est pas indiquée, la construction se fera dans
l'arborescence source à moins que le processus exige ou préfère le faire en
dehors de cette structure. Dans ce cas, le répertoire par défaut sera
utilisé même si \fB\-\-builddirectory\fR n'est pas indiqué.
.Sp
Même si le système préfère utiliser, pour la construction, un répertoire
situé en dehors de l'arborescence source, il autorise quand même la
construction dans l'arborescence source. Pour cela, il suffit d'utiliser un
chemin d'accès au répertoire de construction identique au chemin d'accès au
répertoire source.
.IP "\fB\-\-parallel\fR, \fB\-\-no\-parallel\fR" 4
.IX Item "--parallel, --no-parallel"
Détermine si la construction parallèle doit être utilisée, si le système
sous-jacent le permet. Le nombre de tâches parallèles est contrôlé, lors de
la construction, par la variable d'environnement \fB\s-1DEB_BUILD_OPTIONS\s0\fR
(\*(L"Charte Debian,\*(R" section 4.9.1). Ce nombre peut également être soumis aux
limites spécifiques du système de construction.
.Sp
Si aucune de ces options n'est précisée, debhelper active la parallélisation
par défaut (\fB\-\-parallel\fR) dans le niveau de compatibilité 10 (ou
supérieur), et la désactive (\fB\-\-no\-parallel\fR) dans les autres niveaux.
.Sp
Pour des raisons d'optimisation, \fBdh\fR essaiera de ne pas passer ces options
aux processus fils si elles ne sont pas nécessaires et qu'elles sont les
seules options. Cela arrive en particulier lorsque \fB\s-1DEB_BUILD_OPTIONS\s0\fR n'a
pas de paramètre \fIparallel\fR (ou si sa valeur est \fB1\fR).
.IP "\fB\-\-max\-parallel=\fR\fImaximum\fR" 4
.IX Item "--max-parallel=maximum"
Cette option implique \fB\-\-parallel\fR et permet de limiter le nombre de tâches
qui pourront être lancées lors d'une compilation parallèle. Si la
construction du paquet est connue pour ne fonctionner qu'avec un certain
niveau de parallélisme, il est possible de le régler à la valeur maximale
censée fonctionner, ou que vous souhaitez mettre en œuvre.
.Sp
En particulier, régler le maximum à \fB1\fR équivaut à l'utilisation de
\&\fB\-\-no\-parallel\fR.
.IP "\fB\-\-list\fR, \fB\-l\fR" 4
.IX Item "--list, -l"
Liste tous les processus de construction pris en charge par le
système. Cette liste inclut à la fois les processus par défaut et les
processus tiers (marqués comme tels). Cette option montre également le
processus de construction automatiquement sélectionné ou celui indiqué
manuellement avec l'option \fB\-\-buildsystem\fR.
.SH "NIVEAUX DE COMPATIBILITÉ"
.IX Header "NIVEAUX DE COMPATIBILITÉ"
Parfois, des modifications majeures de debhelper doivent être faites et vont
briser la compatibilité ascendante. Ces modifications sont nécessaires pour
conserver à debhelper ses qualités de conception et d'écriture, car les
besoins changent et le savoir-faire de l'auteur s'améliore. Pour éviter que
de tels changements ne cassent les paquets existants, un concept de niveau
de compatibilité debhelper a été introduit. On devra préciser à debhelper le
niveau de compatibilité qu'il doit employer, ce qui modifiera son
comportement de diverses manières.
.PP
Dans la version actuelle de debhelper, vous pouvez spécifier le niveau de
compatibilité à utiliser dans \fIdebian/control\fR en ajoutant une dépendance
de construction (Build-Depends) sur le paquet debhelper-compat. Par exemple,
pour exploiter la version 12, assurez-vous d'indiquer dans
\&\fIdebian/control\fR :
.PP
.Vb 1
\&  Build\-Depends: debhelper\-compat (= 12)
.Ve
.PP
Cela sert aussi à avoir une dépendance de construction sur une version
suffisante de debhelper. Ainsi il n'est pas nécessaire d'indiquer une
dépendance de construction particulière sur debhelper, sauf si vous avez
besoin d'une mise à jour spécifique (comme pour l'introduction d'une
nouvelle fonctionnalité ou une correction de bogue à l'intérieur d'un niveau
de compatibilité).
.PP
Veuillez noter que debhelper ne fournit pas debhelper-compat pour
experimental ou pour les niveaux en version bêta. Les paquets qui souhaitent
expérimenter avec cela devraient utiliser \fIdebian/compat\fR ou \fB\s-1DH_COMPAT\s0\fR.
.PP
Les versions précédentes de debhelper nécessitaient d'indiquer le niveau de
compatibilité dans le fichier \fIdebian/compat\fR, et la version actuelle
continue à le comprendre pour des raisons de compatibilité. Cependant, un
paquet ne devrait pas spécifier son niveau de compatibilité par plusieurs
méthodes à la fois. Pour utiliser cette méthode, \fIdebian/compat\fR doit
contenir le niveau de compatibilité comme une valeur entière, et rien
d'autre. Si vous indiquez le niveau de compatibilité ainsi, votre paquet
aura besoin d'une dépendance de construction versionnée sur debhelper, égale
(ou supérieure) au niveau de compatibilité utilisé. Ainsi, si vous indiquez
le niveau 12 dans \fIdebian/compat\fR, assurez-vous que le
fichier \fIdebian/control\fR contient :
.PP
.Vb 1
\&  Build\-Depends: debhelper (>= 12~)
.Ve
.PP
Sauf indication contraire, toute la documentation de debhelper suppose
l'utilisation du niveau de compatibilité le plus récent, et, dans la plupart
des cas ne précise pas si le comportement est différent avec les niveaux de
compatibilité antérieurs. De ce fait, si le niveau de compatibilité le plus
récent n'est pas celui utilisé, il est fortement conseillé de lire les
indications ci-dessous qui exposent les différences dans les niveaux de
compatibilité antérieurs.
.SS "Niveaux de compatibilité pris en charge"
.IX Subsection "Niveaux de compatibilité pris en charge"
Les niveaux de compatibilité sont les suivants :
.IP "v5" 4
.IX Item "v5"
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).
.Sp
Ce mode est déconseillé.
.IP "v6" 4
.IX Item "v6"
Les changements par rapport à la version 5 sont :
.RS 4
.IP "\-" 8
Les commandes qui génèrent des lignes de codes de maintenance les mettront
dans l'ordre inverse dans les scripts \fIprerm\fR et \fIpostrm\fR.
.IP "\-" 8
\&\fBdh_installwm\fR installera un lien vers une page de manuel esclave pour
\&\fIx\-window\-manager.1.gz\fR s'il voit la page de manuel dans le répertoire
\&\fIusr/share/man/man1\fR du répertoire de construction du paquet.
.IP "\-" 8
Auparavant, \fBdh_builddeb\fR ne supprimait pas les associations créées avec
\&\fB\s-1DH_ALWAYS_EXCLUDE\s0\fR s'il était configuré sur une liste d'éléments tels que
\&\fB\s-1CVS:\s0.svn:.git\fR. Maintenant il le fait.
.IP "\-" 8
\&\fBdh_installman\fR permet d'écraser les pages de manuel existantes dans le
répertoire de construction du paquet. Auparavant, il refusait en silence de
le faire.
.RE
.RS 4
.Sp
Ce mode est déconseillé.
.RE
.IP "v7" 4
.IX Item "v7"
Les changements par rapport à la version 6 sont :
.RS 4
.IP "\-" 8
\&\fBdh_install\fR cherchera récursivement les fichiers dans \fIdebian/tmp\fR s'il
ne les trouve pas dans le répertoire courant (ou dans le répertoire indiqué
par \fB\-\-sourcedir\fR). Cela permet à \fBdh_install\fR d'interopérer avec
\&\fBdh_auto_install\fR qui place les fichiers dans \fIdebian/tmp\fR, sans
nécessiter de paramètres particuliers.
.IP "\-" 8
\&\fBdh_clean\fR lit le répertoire \fIdebian/clean\fR et supprime les fichiers qui y
sont mentionnés.
.IP "\-" 8
\&\fBdh_clean\fR supprime les fichiers \fI*\-stamp\fR.
.IP "\-" 8
\&\fBdh_installchangelogs\fR déterminera à quel fichier correspond le changelog
amont si rien n'est indiqué.
.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 "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
.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.
.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_foo:
\&    dh_foo \-pmon_paquet
\&
\&  override_dh_bar:
\&    dh_bar
\&    dh_foo \-\-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 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 "v11" 4
.IX Item "v11"
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 "v12" 4
.IX Item "v12"
C'est la version dont l'usage est recommandé.
.Sp
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
\&\fBdh_installdeb\fR n'installe plus le fichier \fIconffiles\fR fournit par le
responsable. Ce fichier est obsolète depuis le niveau de compatibilité 3,
lorsque \fBdh_installdeb\fR a commencé à calculer automatiquement le
\&\fIconffiles\fR résultant du fichier control.
.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 "v13" 4
.IX Item "v13"
Ce niveau de compatibilité est encore en développement ; à utiliser avec
précaution.
.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.
.RE
.RS 4
.RE
.SH "REMARQUES"
.IX Header "REMARQUES"
.SS "Prise en charge de plusieurs paquets binaires"
.IX Subsection "Prise en charge de plusieurs paquets binaires"
Si le paquet source produit plus d'un paquet binaire, les programmes de
debhelper construiront tous les paquets binaires. Si le paquet source doit
construire un paquet dépendant de l'architecture et un paquet indépendant de
l'architecture, ce comportement ne conviendra pas. En effet, il convient de
construire les paquets dépendants de l'architecture dans « binary-arch » de
\&\fIdebian/rules\fR, et les paquets indépendants de l'architecture dans
« binary-indep ».
.PP
Pour résoudre ce problème, et pour un meilleur contrôle sur la construction
des paquets par debhelper, tous les programmes de debhelper acceptent les
options \fB\-a\fR, \fB\-i\fR, \fB\-p\fR et \fB\-s\fR. Ces options sont cumulatives. Si
aucune n'est précisée, les programmes de debhelper construisent tous les
paquets énumérés dans le fichier de contrôle, avec les exceptions
ci-dessous.
.PP
Tout d'abord, chaque paquet dont le champ \fBArchitecture\fR de
\&\fIdebian/control\fR ne contient pas l'architecture \fB\s-1DEB_HOST_ARCH\s0\fR sera exclu
(\*(L"Charte Debian,\*(R" section 5.6.8).
.PP
De plus, quelques autres paquets peuvent être exclus suivant le contenu de
la variable d'environnement \fB\s-1DEB_BUILD_PROFILES\s0\fR et les champs
\&\fBBuild-Profiles\fR des paragraphes \fIdebian/control\fR dans les paquets
binaires, conformément au brouillon de la charte (voir
<https://wiki.debian.org/BuildProfileSpec>).
.PP
\fIInteraction entre les sélections de paquets et les Build-Profiles\fR
.IX Subsection "Interaction entre les sélections de paquets et les Build-Profiles"
.PP
Les profils de construction (« Build-Profiles ») ont un effet sur le choix
des paquets inclus dans les mécanismes de sélection de paquets de
debhelper. Généralement, les sélections partent du principe que tous les
paquets sont activés. Cette section décrit comment les sélections
fonctionnent lorsqu'un paquet est désactivé par un profil de construction
(ou par son absence).
.IP "\fB\-a\fR/\fB\-\-arch\fR, \fB\-i\fR/\fB\-\-indep\fR ou aucune option de sélection (un simple appel « dh_X »)" 4
.IX Item "-a/--arch, -i/--indep ou aucune option de sélection (un simple appel « dh_X »)"
Le paquet désactivé par le profil est silencieusement exclu de la sélection.
.Sp
Veuillez noter que vous recevrez un avertissement si \fItous\fR les paquets
relatifs à cette sélection sont désactivés. Dans ce cas, il est généralement
d'aucune utilité de construire.
.IP "\fB\-N\fR \fIpaquet\fR / \fB\-\-no\-package\fR \fIpaquet\fR" 4
.IX Item "-N paquet / --no-package paquet"
Cette option est acceptée et ne fait rien.
.IP "\fB\-p\fR \fIpaquet\fR / \fB\-\-package\fR \fIpaquet\fR" 4
.IX Item "-p paquet / --package paquet"
Cette option est acceptée, mais debhelper n'agira pas sur le paquet.
.PP
Veuillez noter que cela n'a pas d'importance que le paquet soit activé ou
désactivé par défaut.
.SS "Génération automatique des scripts Debian d’installation"
.IX Subsection "Génération automatique des scripts Debian d’installation"
Certaines commandes de debhelper produisent automatiquement des lignes de
code de maintenance du paquet. Pour les inclure dans vos propres scripts de
maintenance du paquet, il convient d'ajouter \fB#DEBHELPER#\fR à l'endroit où
les lignes de code générées devront être insérées. \fB#DEBHELPER#\fR sera
remplacé, par les lignes de code générées automatiquement, lors de
l'exécution de \fBdh_installdeb\fR.
.PP
Si un script de maintenance n'existe pas et que debhelper doit y inclure
quelque chose, alors debhelper créera le script de maintenance complètement.
.PP
Toutes les commandes de debhelper qui produisent automatiquement des lignes
de code de cette façon peuvent inhiber cette production grâce à l'option
\&\fB\-n\fR (voir ci-dessus).
.PP
Nota : Les lignes de code insérées seront écrites dans le langage de
l'interpréteur de commandes (shell). De ce fait, il est impossible de les
placer directement dans un script Perl. Pour les insérer dans un script
Perl, voici une solution (s'assurer que \f(CW$1\fR, \f(CW$2\fR, etc., sont bien définis par
la commande set) :
.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("Le script debhelper a échoué avec le code d\*(Aqerreur : ${exit_code}");
\&     } else {
\&         die("Le script debhelper a été tué par le signal : ${signal}");
\&     }
\&  }
.Ve
.SS "Génération automatique des diverses dépendances."
.IX Subsection "Génération automatique des diverses dépendances."
Certaines commandes de debhelper peuvent nécessiter des dépendances entre le
paquet construit et d'autres paquets. Par exemple, si
\&\fBdh_installdebconf\fR\|(1) est employé, le paquet devra dépendre de debconf. Si
\&\fBdh_installxfonts\fR\|(1) est employé, le paquet deviendra dépendant d'une
version particulière de xutils. Maintenir ces dépendances induites peut être
pénible puisqu'elles découlent de la façon dont debhelper travaille. C'est
pourquoi debhelper offre une solution d'automatisation.
.PP
Toutes les commandes de ce type, outre qu'elles documentent, dans leur page
de manuel, les dépendances qu'elle induisent, généreront automatiquement une
variable de substitution nommée \fB${misc:depends}\fR. Si cette variable est
exploitée dans le dossier \fIdebian/control\fR, il sera automatiquement enrichi
des dépendances induites par debhelper.
.PP
Ce processus est entièrement indépendant de \fB${shlibs:Depends}\fR standard,
produite par \fBdh_makeshlibs\fR\|(1), et de \fB${perl:Depends}\fR produite par
\&\fBdh_perl\fR\|(1). Il est également possible de choisir de ne pas les utiliser
si les conjectures de debhelper ne correspondent pas à la réalité.
.SS "Répertoires de construction du paquet"
.IX Subsection "Répertoires de construction du paquet"
Par défaut, tous les programmes de debhelper supposent que le répertoire
temporaire utilisé pour construire l'arborescence des fichiers d'un paquet
est debian/\fIpaquet\fR.
.PP
Parfois, il peut être souhaitable d'utiliser un autre répertoire
temporaire. C'est obtenu grâce à l'attribut \fB\-P\fR. Par exemple,
\&\fBdh_installdocs \-Pdebian/tmp\fR utilisera \fBdebian/tmp\fR comme répertoire
temporaire. Nota : L'usage de \fB\-P\fR implique que les programmes de debhelper
ne construisent qu'un seul paquet à la fois. De ce fait, si le paquet source
génère plusieurs paquets binaires, il faudra employer également le paramètre
\&\fB\-p\fR pour préciser l'unique paquet binaire à construire.
.SS "udebs"
.IX Subsection "udebs"
Debhelper prend en charge la construction des udebs. Pour créer un udeb avec
debhelper, il faut ajouter « \fBPackage-Type: udeb\fR » aux lignes de paquet
dans \fIdebian/control\fR. Debhelper essayera de construire des udebs,
conformément aux règles de l'installateur Debian, en suffixant les fichiers
de paquets générés avec \fI.udeb\fR, en n'installant aucune documentation dans
un udeb, en omettant les scripts \fIpreinst\fR, \fIpostrm\fR, \fIprerm\fR et
\&\fIconfig\fR, etc.
.SH "VARIABLES D'ENVIRONNEMENT"
.IX Header "VARIABLES D'ENVIRONNEMENT"
Les variables d'environnement suivantes peuvent influencer le comportement
de debhelper. Il est important de noter que celles-ci doivent être des
variables existantes pour que cela fonctionne correctement (pas simplement
des variables de \fIMakefile\fR). Pour les définir proprement dans le fichier
\&\fIdebian/rules\fR, assurez vous de les exporter (« \fBexport\fR »). Par exemple
« \fBexport \s-1DH_VERBOSE\s0\fR ».
.IP "\fB\s-1DH_VERBOSE\s0\fR" 4
.IX Item "DH_VERBOSE"
Mettre cette variable à \fB1\fR valide le mode verbeux. Debhelper affichera
chaque commande exécutée. Valide aussi les journaux de construction bavards
pour certains systèmes de construction comme autoconf.
.IP "\fB\s-1DH_QUIET\s0\fR" 4
.IX Item "DH_QUIET"
Mettre cette variable à \fB1\fR valide le mode silencieux. Debhelper
n'affichera aucune commande appelant le système de construction amont, et dh
n'affichera aucune des sous-commandes appelées. En fonction du système de
construction amont, cela pourra le rendre encore plus silencieux. Cela
facilite la détection des messages importants, mais rend la sortie inutile
en tant que journal de construction. Cette valeur est ignorée si
\&\fB\s-1DH_VERBOSE\s0\fR est aussi positionnée.
.IP "\fB\s-1DH_COMPAT\s0\fR" 4
.IX Item "DH_COMPAT"
Indique temporairement le niveau de compatibilité avec lequel debhelper doit
fonctionner. Cette valeur supplante toute valeur précisée par Build-Depends
sur debhelper-compat ou dans \fIdebian/compat\fR.
.IP "\fB\s-1DH_NO_ACT\s0\fR" 4
.IX Item "DH_NO_ACT"
Mettre cette variable à \fB1\fR pour activer le mode simulation (no-act).
.IP "\fB\s-1DH_OPTIONS\s0\fR" 4
.IX Item "DH_OPTIONS"
Tout ce qui est indiqué dans cette variable sera passé en argument à toutes
les commandes debhelper.
.Sp
En utilisant \fBdh\fR\|(1), des options peuvent être passées à chaque commande
debhelper, ce qui est généralement mieux que d'utiliser \fB\s-1DH_OPTIONS\s0\fR.
.IP "\fB\s-1DH_ALWAYS_EXCLUDE\s0\fR" 4
.IX Item "DH_ALWAYS_EXCLUDE"
Si cette variable possède une valeur, elle sera ajoutée à l'option \fB\-X\fR de
toutes les commandes qui admettent cette option. De plus, \fBdh_builddeb\fR
fera un \fBrm \-rf\fR pour chaque chose correspondant à la valeur dans l'arbre
de construction de paquet.
.Sp
Cela peut être utile pour construire un paquet à partir d'une arborescence
\&\s-1CVS.\s0 Dans ce cas, le réglage de \fBDH_ALWAYS_EXCLUDE=CVS\fR empêchera les
répertoires \s-1CVS\s0 d'interférer subrepticement dans le paquet en
construction. Ou, si un paquet possède une source compressée,
(maladroitement) présente dans un répertoire \s-1CVS,\s0 il peut être utile
d'exporter \fBDH_ALWAYS_EXCLUDE=CVS\fR dans \fIdebian/rules\fR, pour que cette
variable soit prise en compte quel que soit l'endroit où le paquet est
construit.
.Sp
Des exclusions multiples peuvent être séparées avec des caractères deux
points, comme dans \fIDH_ALWAYS_EXCLUDE=CVS:.svn\fR.
.IP "\fB\s-1DH_EXTRA_ADDONS\s0\fR" 4
.IX Item "DH_EXTRA_ADDONS"
Les rajouts à \fBdh\fR indiqués seront exécutés lors de la séquence de
commandes. Cela équivaut à les indiquer avec le drapeau \fB\-\-with\fR dans le
fichier \fIdebian/rules\fR. Les rajouts précédés de \fB\-\-without\fR ne seront pas
exécutés, même s'ils sont indiqués dans cette variable d'environnement.
.Sp
Cela est prévu pour être utilisé par les dérivées ou les configurations
locales spécifiques qui ont besoin d'un rajout lors de plusieurs
construction, sans avoir à modifier un grand nombre de fichier \fIrules\fR. Il
est préférable d'éviter cette méthode et d'utiliser plutôt les drapeaux
\&\fB\-\-with\fR dans le fichier \fIrules\fR.
.SH "VOIR AUSSI"
.IX Header "VOIR AUSSI"
.IP "\fI/usr/share/doc/debhelper/examples/\fR" 4
.IX Item "/usr/share/doc/debhelper/examples/"
Un ensemble d'exemples de fichiers \fIdebian/rules\fR qui utilisent debhelper.
.IP "<http://joeyh.name/code/debhelper/>" 4
.IX Item "<http://joeyh.name/code/debhelper/>"
Le site internet de debhelper.
.SH "AUTEUR"
.IX Header "AUTEUR"
Joey Hess <joeyh@debian.org>
.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> ».