NOM
debhelper - ensemble d'outils regroups sous le nom de debhelper
SYNOPSIS
dh_* [-v] [-a] [-i] [-s] [--no-act] [-ppaquet] [-Npaquet] [-Ptmpdir]
Debhelper facilite la construction des paquets Debian. La philosophie
qui sous-tend debhelper est de fournir une collection de petits outils
simples et facilement comprhensibles qui seront exploits dans
debian/rules pour automatiser les tches courantes lies la construction
des paquets, d'o un travail allg pour le responsable. Dans une certaine
mesure, cela signifie galement que ces outils peuvent tre adapts aux
modifications ventuelles de la Charte Debian. Les paquets qui
utiliseront debhelper ne ncessiteront qu'une simple reconstruction pour
tre conformes aux nouvelles rgles.
Un fichier debian/rules typique, exploitant debhelper, appellera
squentiellement plusieurs des commandes de debhelper ou bien utilisera
dh(1) pour automatiser ce processus. Des exemples de fichiers
debian/rules qui exploitent debhelper se trouvent dans
/usr/share/doc/debhelper/examples/
Pour crer 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 dh-make qui contient une commande
dh_make automatisant partiellement le processus. Pour se familiariser
avec ces concepts, le paquet Debian maint-guide contient un cours sur
la construction d'un premier paquet avec debhelper.
COMMANDES DE DEBHELPER
Voici la liste des commandes debhelper disponibles. Consulter leurs
pages de manuel respectives pour obtenir des informations
complmentaires.
dh_auto_build(1)
construit automatiquement un paquet
dh_auto_clean(1)
fait le mnage automatiquement aprs une construction de paquet
dh_auto_configure(1)
configure automatiquement un paquet pralablement sa construction
dh_auto_install(1)
lance automatiquement make install ou quivalent
dh_auto_test(1)
Excute automatiquement le jeu d'essai d'un paquet
dh_bugfiles(1)
installe les fichiers de personnalisation de rapports de bogue dans
les rpertoires des paquets construits
dh_builddeb(1)
Construit des paquets binaires Debian
dh_clean(1)
nettoie les rpertoires de construction du paquet
dh_compress(1)
comprime les fichiers dans le rpertoire de construction du paquet
et modifie les liens symboliques en consquence
dh_desktop(1)
obsolte. Ne pas l'utiliser
dh_fixperms(1)
ajuste les droits sur les fichiers du rpertoire de construction du
paquet
dh_gconf(1)
install GConf defaults files and register schemas
dh_gencontrol(1)
produit et installe le fichier de contrle
dh_icons(1)
Met jour les caches des icnes Freedesktop
dh_install(1)
installe les fichiers dans le rpertoire de construction du paquet
dh_installcatalogs(1)
installe et inscrit les catalogues SGML
dh_installchangelogs(1)
installe les journaux de suivi des modifications (changelog) dans
les rpertoires de construction du paquet
dh_installcron(1)
installe les scripts cron dans etc/cron.*
dh_installdeb(1)
installe des fichiers dans le rpertoire DEBIAN
dh_installdebconf(1)
installe les fichiers utiliss par debconf dans les rpertoires de
construction du paquet
dh_installdirs(1)
cre des sous-rpertoires dans le rpertoire de construction du paquet
dh_installdocs(1)
installe la documentation dans le rpertoire de construction du
paquet
dh_installemacsen(1)
inscrit un paquet additionnel emacs
dh_installexamples(1)
installe les fichiers d'exemples dans le rpertoire de construction
du paquet
dh_installifupdown(1)
installe les accroches (hooks) if-up et if-down
dh_installinfo(1)
installe les fichiers info
dh_installinit(1)
installe les tches upstart et les scripts init dans le rpertoire de
construction du paquet
dh_installlogcheck(1)
installe les fichiers de rgles de vrification des journaux
(logcheck rulefiles) dans etc/logcheck/
dh_installlogrotate(1)
installe les fichiers de configuration de la rotation des journaux
(logrotate)
dh_installman(1)
installe les pages de manuel dans le rpertoire de construction du
paquet
dh_installmanpages(1)
ancien programme d'installation des pages de manuel (obsolte)
dh_installmenu(1)
installe les fichiers du menu Debian dans le rpertoire de
construction du paquet
dh_installmime(1)
installe les fichiers mime dans le rpertoire de construction du
paquet
dh_installmodules(1)
inscrit les modules avec modutils
dh_installpam(1)
installe les fichiers de support de PAM
dh_installppp(1)
installe les fichiers ppp.ip-up et ppp.ip-down
dh_installudev(1)
installe les fichiers de rgles udev
dh_installwm(1)
inscrit un gestionnaire de fentre (window manager)
dh_installxfonts(1)
inscrit les polices de caractres graphiques (X fonts)
dh_link(1)
cre les liens symboliques dans le rpertoire de construction du
paquet
dh_lintian(1)
installe les fichiers override de lintian dans le rpertoire de
construction du paquet
dh_listpackages(1)
numre les paquets binaires que debhelper va traiter
dh_makeshlibs(1)
cre automatiquement le fichier shlibs et excute dpkg-gensymbols
dh_md5sums(1)
cre le fichier DEBIAN/md5sums
dh_movefiles(1)
dplace des fichiers depuis debian/tmp dans des sous-paquets
dh_perl(1)
dtermine les dpendances Perl et fait le mnage aprs MakeMaker
dh_prep(1)
fait le mnage en vue de construire un paquet Debian
dh_python(1)
dtermine les dpendances Python et ajoute des scripts de maintenance
Python postinst et prerm (obsolte)
dh_scrollkeeper(1)
obsolte. Ne pas l'utiliser
dh_shlibdeps(1)
dtermine les dpendances envers les bibliothques partages
dh_strip(1)
dpouille les excutables, les bibliothques partages, et certaines
bibliothques statiques
dh_suidregister(1)
programme d'inscription suid (obsolte)
dh_testdir(1)
vrifie le rpertoire avant de construire un paquet Debian
dh_testroot(1)
vrifie que le paquet est construit par le superutilisateur (root)
dh_undocumented(1)
programme de cration de liens symboliques vers undocumented.7
(obsolte)
dh_usrlocal(1)
migre les rpertoires usr/local dans les scripts de maintenance du
paquet
Commandes obsoltes
Quelques commandes debhelper sont obsoltes et ne devraient plus tre
utilises.
Autres commandes
Si le nom d'un programme commence par dh_ 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 mme fonctionner comme les
autres programmes dcrits dans cette page.
FICHIERS DE CONFIGURATION DE DEBHELPER
Beaucoup de commandes de debhelper utilisent des fichiers du rpertoire
debian/ pour piloter leur fonctionnement. Outre les fichiers
debian/changelog et debian/control, 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
spcifiques de debhelper. Ces fichiers sont, en principe, nomms
debian/paquet.toto (o paquet est, bien sr, remplacer par le nom du
paquet concern).
Par exemple, dh_installdocs utilise un fichier appel
debian/package.docs pour numrer les fichiers de documentation qu'il
installera. Consulter les pages de manuel des diffrentes commandes pour
connatre le dtail des noms et des formats des fichiers employs. D'une
faon gnrale, ces fichiers de configuration numrent 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 lgrement plus compliqus.
Nota: Lorsqu'un paquet est le premier (ou le seul) paquet binaire numr
dans le fichier debian/control, debhelper exploitera debian/toto si
aucun fichier debian/paquet.toto n'est prsent.
Dans quelques rares cas, il peut tre utile d'exploiter diffrentes
versions de ces fichiers pour des architectures ou des systmes
d'exploitation diffrents. S'il existe des fichiers appels
debian/paquet.toto.ARCH ou debian/paquet.toto.OS, dans lesquels ARCH et
OS correspondent respectivement au rsultat de dpkg-architecture
-qDEB_HOST_ARCH ou de dpkg-architecture -qDEB_HOST_ARCH_OS, alors ils
seront utiliss de prfrence aux autres fichiers plus gnraux.
Dans beaucoup de cas, ces fichiers de configuration sont employs pour
indiquer divers types de fichiers. Documentation, fichiers d'exemples
installer, fichiers dplacer 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) standard de l'interprteur de
commandes (shell) (?, * et [..]).
Il est galement possible de placer des commentaires dans ces fichiers.
Les lignes dbutant par # sont ignores.
OPTIONS PARTAGES DE DEBHELPER
Tous les programmes de debhelper acceptent les options suivantes:
-v, --verbose
Mode verbeux: affiche toutes les commandes qui modifient le
rpertoire de construction du paquet.
--no-act
Empche la construction de s'effectuer rellement. Si cette option
est utilise avec -v, le rsultat sera l'affichage de ce que la
commande aurait fait.
-a, --arch
Construit tous les paquets dpendants de l'architecture.
-i, --indep
Construit tous les paquets indpendants de l'architecture.
-ppaquet, --package=paquet
Construit le paquet nomm paquet. Cette option peut tre rpte afin de
faire agir debhelper sur plusieurs paquets.
-s, --same-arch
cette option tait plus intelligente de l'option-a, mais l'option-a
est maintenant tout aussi intelligente.
-Npaquet, --no-package=paquet
Exclut le paquet spcifi du processus de construction, mme si
l'option -a, -i ou -p l'impliquait.
--remaining-packages
Exclut du processus de construction les paquets qui ont dj t
construit pralablement par cette commande debhelper (c'est--dire,
si la commande est prsente dans le journal de debhelper du paquet).
Par exemple, si vous avez besoin d'invoquer la commande avec des
options spciales seulement pour certains paquets binaires, utilisez
cette option lors de la dernire invocation de la commande pour
construire le reste des paquets avec les options par dfaut.
--ignore=fichier
Ignore le fichier spcifi. Ceci peut tre utilis si debian/ contient
un fichier de configuration debhelper avec une commande qui ne doit
pas tre pris en compte. Nota: debian/compat, debian/control, et
debian/changelog ne peuvent pas tre ignors, mais il n'existe aucune
raison valable de les ignorer.
Par exemple, si vous rcuprez en amont un fichier debian/init que
vous ne voulez pas que dh_installinit installe, utilisez
--ignore=debian/init
-Ptmpdir, --tmpdir=tmpdir
Utilise le rpertoire tmpdir pour construire les paquets. Sinon, par
dfaut, le rpertoire utilis est debian/paquet
--mainpackage=paquet
Cette option, peu utilise, indique debhelper le nom du paquet
principal pour lequel les fichiers debian/toto peuvent tre utiliss
la place des fichiers habituels debian/paquet.toto. Par dfaut,
debhelper considre que le paquet principal est le premier paquet
numr dans le fichier debian/control.
-O=option|bundle
This is used by dh(1) when passing user-specified options to all
the commands it runs. If the command supports the specified option
or option bundle, it will take effect. If the command does not
support the option (or any part of an option bundle), it will be
ignored.
OPTIONS COURANTES DE DEBHELPER
Certains programmes de debhelper acceptent les options ci-dessous.
Consulter la page de manuel de chaque programme pour une explication
complte du rle de ces options.
-n Ne pas modifier les scripts de maintenance du paquet (postinst,
postrm, etc.).
-Xlment, --exclude=lment
Permet d'exclure un lment du traitement. Cette option peut tre
employe plusieurs fois afin d'exclure plusieurs lments.
-A, --all
Prcise que les fichiers (ou autres lments) indiqus dans la ligne de
commande concernent TOUS les paquets construits et pas seulement le
premier.
OPTIONS DU PROCESSUS DE CONSTRUCTION
Les programmes debhelper dh_auto_* comportent plusieurs processus de
construction et dterminent, de manire heuristique, lequel utiliser et
comment. Il peut tre utile de modifier ce comportement par dfaut. Tous
ces programmes dh_auto_* acceptent les options suivantes:
-Sprocessus de construction, --buildsystem=processus de construction
Oblige utiliser le processus de construction spcifi au lieu de
tenter de dterminer automatiquement celui qui pourrait tre
utilisable pour le paquet.
-Drpertoire, --sourcedirectory=rpertoire
Considre que les sources du paquet sont situes dans le rpertoire
spcifi plutt qu'au plus haut niveau de l'arborescence du paquet
source.
-B[rpertoire], --builddirectory=[rpertoire]
Permet de construire le paquet en dehors de la structure source en
utilisant le rpertoire spcifi comme rpertoire de construction. Si
le paramtre rpertoire n'est pas spcifi, un rpertoire de
construction par dfaut sera choisi.
Si cette option n'est pas spcifie, la construction se fera dans
l'arborescence source moins que le processus exige ou prfre le
faire en dehors de cette structure. Dans ce cas, le rpertoire par
dfaut sera utilis mme si --builddirectory n'est pas spcifi.
Mme si le systme prfre utiliser, pour la construction, un rpertoire
situ en dehors de l'arborescence source, il autorise quand mme la
construction dans l'arborescence source. Pour cela, il suffit
d'utiliser un chemin d'accs au rpertoire de construction identique
au chemin d'accs au rpertoire source.
--parallel
Enable parallel builds if underlying build system supports them.
The number of parallel jobs is controlled by the DEB_BUILD_OPTIONS
environment variable ("Debian Policy, section 4.9.1") at build
time. It might also be subject to a build system specific limit.
If this option is not specified, debhelper currently defaults to
not allowing parallel package builds.
--max-parallel=maximum
This option implies --parallel and allows further limiting the
number of jobs that can be used in a parallel build. If the package
build is known to only work with certain levels of concurrency, you
can set this to the maximum level that is known to work, or that
you wish to support.
--list, -l
Liste tous les processus de construction support par le systme.
Cette liste inclut la fois les processus par dfaut et les
processus tiers (marqus comme tels). Cette option montre galement
le processus de construction automatiquement slectionn ou celui
spcifi manuellement avec l'option --buildsystem.
REMARQUES
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 dpendant de l'architecture, et un paquet
indpendant de l'architecture, ce comportement ne conviendra pas. En
effet, il convient de construire les paquets dpendants de
l'architecture dans binary-arch de debian/rules, et les paquets
indpendants de l'architecture dans binary-indep.
Pour rsoudre ce problme, et pour un meilleur contrle sur la
construction des paquets par debhelper, tous les programmes de
debhelper acceptent les options -a, -i, -p, et -s. Ces options sont
cumulatives. Si aucune n'est prcise, les programmes de debhelper
construisent tous les paquets numrs dans le fichier de contrle.
Gnration automatique des scripts Debian de maintenance du paquet
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 #DEBHELPER#
l'endroit o les lignes de code gnres devront tre insres. #DEBHELPER#
sera remplac, par les lignes de code gnres automatiquement, lors de
l'excution de dh_installdeb.
Si un script de maintenance n'existe pas et que debhelper doit y
inclure quelque chose, alors debhelper crera le script de maintenance
compltement.
Toutes les commandes de debhelper qui produisent automatiquement des
lignes de code de cette faon peuvent inhiber cette production grce
l'option -n (voir ci-dessus).
Nota: Les lignes de code insres seront crites dans le langage de
l'interprteur de commandes (shell). De ce fait, il est impossible de
les placer directement dans un script Perl. Pour les insrer dans un
script Perl, voici une solution. (S'assurer que $1, $2, etc. sont bien
dfinis par la commande set.)
my $temp="set -e\nset -- @ARGV\n" . << 'EOF';
#DEBHELPER#
EOF
system ($temp) / 256 == 0
or die "Problme avec le script de S<debhelper :> $!";
Gnration automatique des diverses dpendances.
Certaines commandes de debhelper peuvent ncessiter des dpendances entre
le paquet construit et d'autres paquets. Par exemple, si
dh_installdebconf(1) est employ, le paquet devra dpendre de debconf. Si
dh_installxfonts(1) est employ, le paquet deviendra dpendant d'une
version particulire de xutils. Maintenir ces dpendances induites peut
tre pnible puisqu'elles dcoulent de la faon dont debhelper travaille.
C'est pourquoi debhelper offre une solution d'automatisation.
Toutes les commandes de ce type, outre qu'elles documentent, dans leur
page de manuel, les dpendances qu'elle induisent, gnreront
automatiquement une variable de substitution nomme ${misc:depends}. Si
cette variable est exploite dans le dossier debian/control, il sera
automatiquement enrichi des dpendances induites par debhelper.
Ce processus est entirement indpendant de ${shlibs:Depends} standard,
produite par dh_makeshlibs(1), et de ${perl:Depends} produite par
dh_perl(1). Il est galement possible de choisir de ne pas les utiliser
si les conjectures de debhelper ne correspondent pas la ralit.
Rpertoires de construction du paquet
Par dfaut, tous les programmes de debhelper supposent que le rpertoire
temporaire utilis pour construire l'arborescence des fichiers d'un
paquet est debian/paquet.
Parfois, il peut tre souhaitable d'utiliser un autre rpertoire
temporaire. Ceci est obtenu grce au paramtre -P. Par exemple,
dh_installdocs-Pdebian/tmp utilisera debian/tmp comme rpertoire
temporaire. Nota: L'usage de -P implique que les programmes de
debhelper ne construisent qu'un seul paquet la fois. De ce fait, si le
paquet source gnre plusieurs paquets binaires, il faudra employer
galement le paramtre -p pour prciser l'unique paquet binaire
construire.
Niveaux de compatibilit de debhelper
Parfois, des modifications majeures de debhelper doivent tre faites et
vont briser la compatibilit ascendante. Ces modifications sont
ncessaires pour conserver debhelper ses qualits de conception et
d'criture, car les besoins changent et le savoir-faire de l'auteur
s'amliore. Pour viter que de tels changements ne cassent les paquets
existants, un concept de niveau de compatibilit debhelper a t
introduit. On prcisera debhelper le niveau de compatibilit qu'il doit
employer ce qui modifiera son comportement de diverses manires.
Tell debhelper what compatibility level to use by writing a number to
debian/compat. For example, to turn on v8 mode:
% echo 8 > debian/compat
Sauf indication contraire, toute la documentation de debhelper suppose
l'utilisation du niveau de compatibilit le plus rcent, et, dans la
plupart des cas ne prcise pas si le comportement est diffrent avec les
niveaux de compatibilit antrieurs. De ce fait, si le niveau de
compatibilit le plus rcent n'est pas celui utilis, il est fortement
conseill de lire les indications ci-dessous qui exposent les diffrences
dans les niveaux de compatibilit antrieurs.
Les niveaux de compatibilit sont les suivants:
v1 C'est le niveau initial de compatibilit de debhelper d'o son numro
1. Dans ce mode, debhelper emploiera debian/tmp comme rpertoire de
l'arborescence du premier paquet binaire numr dans le fichier de
contrle et debian/paquet pour tous les autres.
Ce mode est dconseill.
v2 Dans ce mode, debhelper emploiera uniformment debian/paquet comme
rpertoire de l'arborescence de chaque paquet construit.
Ce mode est dconseill.
v3 This mode works like v2, with the following additions:
- Les fichiers de configuration de debhelper acceptent les
jokers * et ? lorsque cela a un sens. Pour dsactiver cette
substitution et utiliser ces caractres tels quels, il
suffit de les prfixer avec une barre contre-oblique
(backslash).
- Les scripts de maintenance du paquet (postinst et postrm)
feront appel ldconfig quand dh_makeshlibs sera lanc.
- Chaque fichier de etc/ est automatiquement marqu par
dh_installdeb comme un fichier de configuration.
Ce mode est dconseill.
v4 Changes from v3 are:
- dh_makeshlibs -V n'inclura pas la partie Debian du numro de
version dans la ligne de dpendance produite dans le fichier
shlibs.
- Il est fortement conseill de mettre le nouveau
${misc:Depends} dans debian/control pour complter le champs
${shlibs:Depends}.
- dh_fixperms rendra excutables tous les fichiers des
rpertoires bin/ et etc/init.d.
- dh_link corrigera les liens existants pour les rendre
conformes la Charte Debian.
Ce mode est dconseill.
v5 Changes from v4 are:
- Les commentaires sont ignors dans les fichiers de
configuration de debhelper.
- dh_strip --dbg-package indique maintenant le nom du paquet
qui doit recevoir les symboles de mise au point et non plus
les paquets d'o proviennent ces symboles.
- dh_installdocs saute l'installation des fichiers vides.
- dh_install gnre des erreurs si les jokers (wildcards) ne
correspondent rien.
v6 Changes from v5 are:
- Les commandes qui gnrent des lignes de codes de maintenance
les mettront dans l'ordre inverse dans les scripts postrm
et prerm.
- dh_installwm installera un lien vers une page de manuel
esclave pour x-window-manager.1.gz s'il voit la page de
manuel dans le rpertoire usr/share/man/man1 du rpertoire de
construction du paquet.
- dh_builddeb, pralablement, ne supprimait pas les
associations cres avec DH_ALWAYS_EXCLUDE s'il tait configur
sur une liste d'lments tels que CVS:.svn:.git. Maintenant
il le fait.
- Dh_installman permet d'craser les pages de man existantes
dans le rpertoire de construction du paquet. Pralablement,
il refusait en silence de le faire.
v7 Changes from v6 are:
- dh_install cherchera rcursivement les fichiers dans
debian/tmp s'il ne les trouve pas dans le rpertoire courant
(ou dans le rpertoire spcifi par --sourcedir). Cela permet
dh_install d'interoprer avec dh_auto_install, qui place les
fichiers dans debian/tmp, sans ncessiter de paramtres
particuliers.
- dh_clean lit le rpertoire debian/clean et supprime les
fichiers qui y sont mentionns.
- dh_clean supprime les fichiers *-stamp.
- dh_installchangelogs dterminera quel fichier correspond le
changelog amont si rien n'est spcifi.
v8 C'est la version dont l'usage est recommand.
Changes from v7 are:
- Commands will fail rather than warning when they are passed
unknown options.
- dh_makeshlibs will run dpkg-gensymbols on all shared
libraries that it generates shlibs files for. So -X can be
used to exclude libraries. Also, libraries in unusual
locations that dpkg-gensymbols would not have processed
before will be passed to it, a behavior change that can
cause some packages to fail to build.
- dh requires the sequence to run be specified as the first
parameter, and any switches come after it. Ie, use "dh $@
--foo", not "dh --foo $@"
dh_auto_* prefer to use perl's Module::Build in preference
to Makefile.PL.
udebs
Debhelper includes support for udebs. To create a udeb with debhelper,
add "Package-Type: udeb" to the package's stanza in debian/control, and
build-depend on debhelper (>= 4.2). Debhelper will try to create udebs
that comply with debian-installer policy, by making the generated
package files end in ".udeb", not installing any documentation into a
udeb, skipping over preinst, postrm, prerm, and config scripts, etc.
Autres remarques
Gnralement, si un programme de debhelper a besoin qu'un rpertoire
existe dans debian/, il le crera. Ce comportement n'est pas document
dans toutes les pages de manuel, mais, par exemple, le dh_installdeb
sait qu'il doit crer le rpertoire debian/paquet/DEBIAN/ avant de tenter
de mettre des fichiers dedans. De mme, dh_installmenu sait qu'il est
ncessaire d'avoir un rpertoire debian/paquet/usr/share/menu/ avant
d'installer les fichiers menu, etc.
Ds qu'un paquet emploie debhelper pour sa construction, il faut vrifier
que debhelper a bien t ajout la ligne Build-Depends dans le fichier
debian/control. Il convient galement de s'assurer que la version de
debhelper indique dans build-depend est au moins gale au niveau de
compatibilit de debhelper utilise pour la construction du paquet. Ainsi
si le paquet emploie le niveau 7 de compatibilit:
Build-Depends: debhelper (>= 7)
VARIABLES D'ENVIRONNEMENT
DH_VERBOSE
Mettre cette variable 1 valide le mode verbeux. Debhelper
affichera chaque commande excute qui modifie des fichiers.
DH_COMPAT
Indique temporairement le niveau de compatibilit auquel debhelper
doit fonctionner. Cette valeur supplante la valeur prcise dans
debian/compat.
DH_NO_ACT
Mettre cette variable 1 pour activer le mode simulation (no-act).
DH_OPTIONS
Tout ce qui est indiqu dans cette variable sera pass en argument
toutes les commandes debhelper. Les options spcifiques une
commande seront ignores par les commandes qui n'exploitent pas
cette option.
Ce comportement est utile dans quelques situations, par exemple,
pour passer -p toutes les commandes de debhelper qui seront
excutes. Une bonne faon d'employer DH_OPTIONS est d'utiliser des
triplets Cible-spcifiqueVariableValeurs dans le fichier
debian/rules. Consulter la documentation de make pour obtenir des
prcisions sur cette mthode.
DH_ALWAYS_EXCLUDE
Si cette variable possde une valeur, elle sera ajoute l'option -X
de toutes les commandes qui admettent cette option. De plus,
dh_builddeb fera un rm -rf quelque chose, correspondant la valeur
dans l'arbre de construction de paquet.
Ceci peut tre utile pour construire un paquet partir d'une
arborescence CVS. Dans ce cas, le rglage de DH_ALWAYS_EXCLUDE=CVS
empchera les rpertoires CVS d'interfrer subrepticement dans le
paquet en construction. Ou, si un paquet possde une source
compresse, (maladroitement) prsente dans un rpertoire CVS, il peut
tre utile d'exporter DH_ALWAYS_EXCLUDE=CVS dans debian/rules, pour
que cette variable soit prise en compte quel que soit l'endroit o
le paquet est construit.
Des exclusions multiples peuvent tre spares avec des caractres deux
points, comme dans DH_ALWAYS_EXCLUDE=CVS:.svn.
VOIR AUSSI
/usr/share/doc/debhelper/examples/
Un ensemble d'exemples de fichiers debian/rules qui utilisent
debhelper.
<http://kitenet.net/~joey/code/debhelper/>
Le site internet de debhelper.
AUTEUR
Joey Hess <joeyh@debian.org>
TRADUCTION
Valry Perrin <valery.perrin.debian@free.fr> le 17 septembre 2005.
Dernire mise jour le 29 septembre 2009.
L'quipe de traduction a fait le maximum pour raliser une adaptation
franaise de qualit.
Cette traduction est gre dynamiquement par po4a. Certains paragraphes
peuvent, ventuellement, apparatre en anglais. Ils correspondent des
modifications ou des ajouts rcents du mainteneur, non encore incorpors
dans la traduction franaise.
La version originale anglaise de ce document est toujours consultable
via la commande man-Lennom_du_man.
N'hsitez pas signaler l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.