Provided by:
debhelper_9.20120115ubuntu3_all 
NOM
debhelper - ensemble d'outils regroupes sous le nom de debhelper
SYNOPSIS
dh_* [-v] [-a] [-i] [-s] [--no-act] [-ppaquet] [-Npaquet] [-Ptmpdir]
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 comprehensibles qui seront exploites dans
debian/rules pour automatiser les taches courantes liees a la
construction des paquets, d'ou un travail allege pour le responsable.
Dans une certaine mesure, cela signifie egalement que ces outils
peuvent etre adaptes aux modifications eventuelles de la Charte Debian.
Les paquets qui utiliseront debhelper ne necessiteront qu'une simple
reconstruction pour etre conformes aux nouvelles regles.
Un fichier debian/rules typique, exploitant debhelper, appellera
sequentiellement 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 creer un nouveau paquet Debian en utilisant debhelper, il suffit
de copier un des fichiers d'exemple et de le modifier manuellement. Il
est possible egalement 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
complementaires.
dh_auto_build(1)
construit automatiquement un paquet
dh_auto_clean(1)
fait le menage automatiquement apres une construction de paquet
dh_auto_configure(1)
configure automatiquement un paquet prealablement a sa construction
dh_auto_install(1)
lance automatiquement make install ou equivalent
dh_auto_test(1)
Execute automatiquement le jeu d'essai d'un paquet
dh_bugfiles(1)
installe les fichiers de personnalisation de rapports de bogue dans
les repertoires des paquets construits
dh_builddeb(1)
Construit des paquets binaires Debian
dh_clean(1)
nettoie les repertoires de construction du paquet
dh_compress(1)
comprime les fichiers dans le repertoire de construction du paquet
et modifie les liens symboliques en consequence
dh_fixperms(1)
ajuste les droits sur les fichiers du repertoire de construction du
paquet
dh_gconf(1)
Installe les fichiers par defaut de GConf et inscrit les schemas
dh_gencontrol(1)
produit et installe le fichier de controle
dh_icons(1)
Met a jour les caches des icones Freedesktop
dh_install(1)
installe les fichiers dans le repertoire 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 repertoires de construction du paquet
dh_installcron(1)
installe les scripts cron dans etc/cron.*
dh_installdeb(1)
installe des fichiers dans le repertoire DEBIAN
dh_installdebconf(1)
installe les fichiers utilises par debconf dans les repertoires de
construction du paquet
dh_installdirs(1)
cree des sous-repertoires dans le repertoire de construction du
paquet
dh_installdocs(1)
installe la documentation dans le repertoire de construction du
paquet
dh_installemacsen(1)
inscrit un paquet additionnel Emacs
dh_installexamples(1)
installe les fichiers d'exemples dans le repertoire 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 taches upstart et les scripts init dans le repertoire
de construction du paquet
dh_installlogcheck(1)
installe les fichiers de regles de verification 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 repertoire de construction du
paquet
dh_installmenu(1)
installe les fichiers du menu Debian dans le repertoire de
construction du paquet
dh_installmime(1)
installe les fichiers <<mime>> dans le repertoire 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 regles udev
dh_installwm(1)
inscrit un gestionnaire de fenetre (window manager)
dh_installxfonts(1)
inscrit les polices de caracteres graphiques (X fonts)
dh_link(1)
cree les liens symboliques dans le repertoire de construction du
paquet
dh_lintian(1)
installe les fichiers <<override>> de lintian dans le repertoire de
construction du paquet
dh_listpackages(1)
enumere les paquets binaires que debhelper va traiter
dh_makeshlibs(1)
cree automatiquement le fichier shlibs et execute dpkg-gensymbols
dh_md5sums(1)
cree le fichier DEBIAN/md5sums
dh_movefiles(1)
deplace des fichiers depuis debian/tmp dans des sous-paquets
dh_perl(1)
determine les dependances Perl et fait le menage apres MakeMaker
dh_prep(1)
fait le menage en vue de construire un paquet Debian
dh_shlibdeps(1)
determine les dependances envers les bibliotheques partagees
dh_strip(1)
depouille les executables, les bibliotheques partagees, et
certaines bibliotheques statiques
dh_testdir(1)
verifie le repertoire avant de construire un paquet Debian
dh_testroot(1)
verifie que le paquet est construit par le superutilisateur (root)
dh_usrlocal(1)
migre les repertoires usr/local dans les scripts de maintenance du
paquet
Commandes obsol`etes
Quelques commandes debhelper sont obsoletes et ne devraient plus etre
utilisees.
dh_desktop(1)
obsolete. Ne pas l'utiliser
dh_installmanpages(1)
ancien programme d'installation des pages de manuel (obsolete)
dh_python(1)
determine les dependances Python et ajoute des scripts de
maintenance Python postinst et prerm (obsolete)
dh_scrollkeeper(1)
obsolete. Ne pas l'utiliser
dh_suidregister(1)
programme d'inscription suid (obsolete)
dh_undocumented(1)
programme de creation de liens symboliques vers <<undocumented.7>>
(obsolete)
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 meme fonctionner comme les
autres programmes decrits dans cette page.
FICHIERS DE CONFIGURATION DE DEBHELPER
Beaucoup de commandes de debhelper utilisent des fichiers du repertoire
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 a configurer le comportement des commandes
specifiques de debhelper. Ces fichiers sont, en principe, nommes
debian/paquet.toto (ou paquet est, bien sur, a remplacer par le nom du
paquet concerne).
Par exemple, dh_installdocs utilise un fichier appele
debian/package.docs pour enumerer les fichiers de documentation qu'il
installera. Consulter les pages de manuel des differentes commandes
pour connaitre le detail des noms et des formats des fichiers employes.
D'une facon generale, ces fichiers de configuration enumerent les
fichiers sur lesquels devra porter l'action, a raison d'un fichier par
ligne. Quelques programmes de debhelper emploient des paires
fichier/destination voire des formats legerement plus compliques.
Note for the first (or only) binary package listed in debian/control,
debhelper will use debian/foo when there's no debian/package.foo file.
Dans quelques rares cas, il peut etre utile d'exploiter differentes
versions de ces fichiers pour des architectures ou des systemes
d'exploitation differents. S'il existe des fichiers appeles
debian/paquet.toto.ARCH ou debian/paquet.toto.OS, dans lesquels ARCH et
OS correspondent respectivement au resultat de <<dpkg-
architecture-qDEB_HOST_ARCH>> ou de <<dpkg-
architecture-qDEB_HOST_ARCH_OS>>, alors ils seront utilises de
preference aux autres fichiers plus generaux.
Mostly, these config files are used to specify lists of various types
of files. Documentation or example files to install, files to move, and
so on. When appropriate, in cases like these, you can use standard
shell wildcard characters (? and * and [..] character classes) in the
files. You can also put comments in these files; lines beginning with
# are ignored.
The syntax of these files is intentionally kept very simple to make
then easy to read, understand, and modify. If you prefer power and
complexity, you can make the file executable, and write a program that
outputs whatever content is appropriate for a given situation. When you
do so, the output is not further processed to expand wildcards or strip
comments.
OPTIONS PARTAG'EES DE DEBHELPER
Tous les programmes de debhelper acceptent les options suivantes:
-v, --verbose
Mode verbeux: affiche toutes les commandes qui modifient le
repertoire de construction du paquet.
--no-act
Empeche la construction de s'effectuer reellement. Si cette option
est utilisee avec -v, le resultat sera l'affichage de ce que la
commande aurait fait.
-a, --arch
Construit tous les paquets dependants de l'architecture.
-i, --indep
Construit tous les paquets independants de l'architecture.
-ppaquet, --package=paquet
Construit le paquet nomme <<paquet>>. Cette option peut etre
repetee afin de faire agir debhelper sur plusieurs paquets.
-s, --same-arch
Cette option etait plus intelligente de l'option -a, mais l'option
-a est maintenant tout aussi intelligente.
-Npaquet, --no-package=paquet
Exclut le paquet specifie du processus de construction, meme si
l'option -a, -i ou -p l'impliquait.
--remaining-packages
Exclut du processus de construction les paquets qui ont deja ete
construit prealablement par cette commande debhelper (c'est-a-dire,
si la commande est presente dans le journal de debhelper du
paquet). Par exemple, si vous avez besoin d'invoquer la commande
avec des options speciales seulement pour certains paquets
binaires, utilisez cette option lors de la derniere invocation de
la commande pour construire le reste des paquets avec les options
par defaut.
--ignore=fichier
Ignore le fichier specifie. Ceci peut etre utilise si debian/
contient un fichier de configuration debhelper avec une commande
qui ne doit pas etre pris en compte. Nota: debian/compat,
debian/control, et debian/changelog ne peuvent pas etre ignores,
mais il n'existe aucune raison valable de les ignorer.
Par exemple, si vous recuperez en amont un fichier debian/init que
vous ne voulez pas que dh_installinit installe, utilisez
--ignore=debian/init
-Ptmpdir, --tmpdir=tmpdir
Utilise le repertoire tmpdir pour construire les paquets. Sinon,
par defaut, le repertoire utilise est <<debian/paquet>>
--mainpackage=paquet
Cette option, peu utilisee, indique a debhelper le nom du << paquet
principal >> pour lequel les fichiers debian/toto peuvent etre
utilises a la place des fichiers habituels debian/paquet.toto. Par
defaut, debhelper considere que le << paquet principal >> est le
premier paquet enumere dans le fichier debian/control.
-O=option|ensemble
Cette option est utilisee par L <dh(1)> pour passer une ou
plusieurs options, specifiees par l'utilisateur, a toutes les
commandes executees. 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
ignoree.
OPTIONS COURANTES DE DEBHELPER
Certains programmes de debhelper acceptent les options ci-dessous.
Consulter la page de manuel de chaque programme pour une explication
complete du role de ces options.
-n Ne pas modifier les scripts de maintenance du paquet (postinst,
postrm, etc.).
-X'el'ement, --exclude='el'ement
Permet d'exclure un element du traitement. Cette option peut etre
employee plusieurs fois afin d'exclure plusieurs elements.
-A, --all
Precise que les fichiers (ou autres elements) indiques dans la
ligne de commande concernent TOUS les paquets construits et pas
seulement le premier.
OPTIONS DU PROCESSUS DE CONSTRUCTION
The following command line options are supported by all of the
dh_auto_* debhelper programs. These programs support a variety of build
systems, and normally heuristically determine which to use, and how to
use them. You can use these command line options to override the
default behavior. Typically these are passed to dh(1), which then
passes them to all the dh_auto_* programs.
-Sprocessus de construction, --buildsystem=processus de construction
Oblige a utiliser le processus de construction specifie au lieu de
tenter de determiner automatiquement celui qui pourrait etre
utilisable pour le paquet.
-Dr'epertoire, --sourcedirectory=r'epertoire
Considere que les sources du paquet sont situees dans le r'epertoire
specifie plutot qu'au plus haut niveau de l'arborescence du paquet
source.
-B[r'epertoire], --builddirectory=[r'epertoire]
Permet de construire le paquet en dehors de la structure source en
utilisant le r'epertoire specifie comme repertoire de construction.
Si le parametre r'epertoire n'est pas specifie, un repertoire de
construction par defaut sera choisi.
Si cette option n'est pas specifiee, la construction se fera dans
l'arborescence source a moins que le processus exige ou prefere le
faire en dehors de cette structure. Dans ce cas, le repertoire par
defaut sera utilise meme si --builddirectory n'est pas specifie.
Meme si le systeme prefere utiliser, pour la construction, un
repertoire situe en dehors de l'arborescence source, il autorise
quand meme la construction dans l'arborescence source. Pour cela,
il suffit d'utiliser un chemin d'acces au repertoire de
construction identique au chemin d'acces au repertoire source.
--parallel
Cette option active la construction parallele si le systeme sous-
jacent le permet. Le nombre de taches paralleles est controle, lors
de la construction, par la variable d'environnement
DEB_BUILD_OPTIONS ("Charte Debian, section 4.9.1"). Ce nombre peut
egalement etre soumis aux limites specifiques du systeme.
Si cette option n'est pas specifiee, debhelper n'activera pas, par
defaut, le parallelisme lors de la construction.
--max-parallel=maximum
Cette option implique --parallel et permet de limiter le nombre de
taches qui pourront etre lancees lors d'une compilation parallele.
Si la construction du paquet est connu pour ne fonctionner qu'avec
un certain niveau de parallelisme, il est possible de le regler a
la valeur maximum censee fonctionner, ou que vous souhaitez mettre
en oeuvre.
--list, -l
Liste tous les processus de construction supporte par le systeme.
Cette liste inclut a la fois les processus par defaut et les
processus tiers (marques comme tels). Cette option montre egalement
le processus de construction automatiquement selectionne ou celui
specifie manuellement avec l'option --buildsystem.
COMPATABILITY LEVELS
Parfois, des modifications majeures de debhelper doivent etre faites et
vont briser la compatibilite ascendante. Ces modifications sont
necessaires pour conserver a debhelper ses qualites de conception et
d'ecriture, car les besoins changent et le savoir-faire de l'auteur
s'ameliore. Pour eviter que de tels changements ne cassent les paquets
existants, un concept de niveau de compatibilite debhelper a ete
introduit. On precisera a debhelper le niveau de compatibilite qu'il
doit employer ce qui modifiera son comportement de diverses manieres.
Tell debhelper what compatibility level to use by writing a number to
debian/compat. For example, to turn on v9 mode:
% echo 9 > debian/compat
Your package will also need a versioned build dependency on a version
of debhelper equal to (or greater than) the compatibility level your
package uses. So for compatibility level 9, ensure debian/control has:
Build-Depends: debhelper (>= 9)
Sauf indication contraire, toute la documentation de debhelper suppose
l'utilisation du niveau de compatibilite le plus recent, et, dans la
plupart des cas ne precise pas si le comportement est different avec
les niveaux de compatibilite anterieurs. De ce fait, si le niveau de
compatibilite le plus recent n'est pas celui utilise, il est fortement
conseille de lire les indications ci-dessous qui exposent les
differences dans les niveaux de compatibilite anterieurs.
Les niveaux de compatibilite sont les suivants:
v1 C'est le niveau initial de compatibilite de debhelper d'ou son
numero 1. Dans ce mode, debhelper emploiera debian/tmp comme
repertoire de l'arborescence du premier paquet binaire enumere dans
le fichier control et << debian/paquet >> pour tous les autres.
Ce mode est deconseille.
v2 Dans ce mode, debhelper emploiera uniformement << debian/paquet >>
comme repertoire de l'arborescence de chaque paquet construit.
Ce mode est deconseille.
v3 Ce mode fonctionne comme v2 mais avec les ajouts suivants:
- Les fichiers de configuration de debhelper acceptent les
jokers* et? lorsque cela a un sens. Pour desactiver cette
substitution et utiliser ces caracteres tels quels, il
suffit de les prefixer avec une barre contre-oblique
(backslash).
- Les scripts de maintenance du paquet (postinst et postrm)
feront appel a ldconfig quand dh_makeshlibs sera lance.
- Chaque fichier de etc/ est automatiquement marque par
dh_installdeb comme un fichier de configuration.
Ce mode est deconseille.
v4 Les changements par rapport a la version 3 sont:
- dh_makeshlibs -V n'inclura pas la partie Debian du numero
de version dans la ligne de dependance produite dans le
fichier shlibs.
- Il est fortement conseille de mettre le nouveau
${misc:Depends} dans debian/control pour completer le
champs ${shlibs:Depends}.
- dh_fixperms rendra executables tous les fichiers des
repertoires bin/ et etc/init.d.
- dh_link corrigera les liens existants pour les rendre
conformes a la Charte Debian.
Ce mode est deconseille.
v5 Les changements par rapport a la version 4 sont:
- Les commentaires sont ignores 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'ou proviennent ces symboles.
- dh_installdocs saute l'installation des fichiers vides.
- dh_install genere des erreurs si les jokers (wildcards) ne
correspondent a rien.
v6 Les changements par rapport a la version 5 sont:
- Les commandes qui generent des lignes de codes de
maintenance les mettront dans l'ordre inverse dans les
scripts prerm et postrm.
- 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 repertoire usr/share/man/man1 du repertoire
de construction du paquet.
- dh_builddeb, prealablement, ne supprimait pas les
associations crees avec DH_ALWAYS_EXCLUDE s'il etait
configure sur une liste d'elements tels que CVS:.svn:.git.
Maintenant il le fait.
- Dh_installman permet d'ecraser les pages de man existantes
dans le repertoire de construction du paquet.
Prealablement, il refusait en silence de le faire.
v7 Les changements par rapport a la version 6 sont:
- dh_install cherchera recursivement les fichiers dans
debian/tmp s'il ne les trouve pas dans le repertoire
courant (ou dans le repertoire specifie par --sourcedir).
Cela permet a dh_install d'interoperer avec
dh_auto_install, qui place les fichiers dans debian/tmp,
sans necessiter de parametres particuliers.
- dh_clean lit le repertoire debian/clean et supprime les
fichiers qui y sont mentionnes.
- dh_clean supprime les fichiers *-stamp.
- dh_installchangelogs determinera a quel fichier correspond
le changelog amont si rien n'est specifie.
v8 Les changements par rapport a la version 7 sont:
- Les commandes echoueront plutot que de produire une alerte
lorsqu'elles recevront des options inconnues.
- dh_makeshlibs va executer le programme dpkg-gensymbols sur
toutes les bibliotheques partagees qu'il genere pour les
fichiers shlibs. -X peut alors etre utilise pour exclure
certaines bibliotheques. En outre, les bibliotheques
rangees a des emplacements inhabituels que pkg-gensymbols
n'aurait pas traitees avant qu'elles ne lui soient
transmises, induisent un changement de comportement qui
peut causer l'echec de la construction de certains paquets.
- dh exige que la sequence a executer soit specifiee en tant
que premier parametre. Tous les commutateurs doivent venir
apres. C'est a dire qu'il faut ecrire <<dh$@--toto>>, et
non <<dh--toto$@>>
- Dh_auto_* utilise preferentiellement Module::Build de Perl
au lieu de Makefile.PL.
v9 C'est la version dont l'usage est recommande.
Changes from v8 are:
- Multiarch support. In particular, dh_auto_configure passes
multiarch directories to autoconf in --libdir and
--libexecdir.
- dh is aware of the usual dependencies between targets in
debian/rules. So, "dh binary" will run any build, build-
arch, build-indep, install, etc targets that exist in the
rules file. There's no need to define an explicit binary
target with explicit dependencies on the other targets.
- dh_strip compresses debugging symbol files to reduce the
installed size of -dbg packages.
- dh_auto_configure does not include the source package name
in --libexecdir when using autoconf.
- dh does not default to enabling --with=python-support
- All of the dh_auto_* debhelper programs and dh set
environment variables listed by dpkg-buildflags, unless
they are already set. They support DEB_BUILD_OPTIONS=noopt
too.
- dh_auto_configure passes CFLAGS to perl Makefile.PL and
Build.PL
- dh_strip puts separated debug symbols in a location based
on their build-id.
- Executable debhelper config files are run and their output
used as the configuration.
v10 This compatibility level is still open for development; use with
caution.
Changes from v9 are:
- None yet..
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 dependant de l'architecture, et un paquet
independant de l'architecture, ce comportement ne conviendra pas. En
effet, il convient de construire les paquets dependants de
l'architecture dans << binary-arch >> de debian/rules, et les paquets
independants de l'architecture dans << binary-indep >>.
Pour resoudre ce probleme, et pour un meilleur controle 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 precisee, les programmes de debhelper
construisent tous les paquets enumeres dans le fichier de controle.
G'en'eration 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# a
l'endroit ou les lignes de code generees devront etre inserees.
#DEBHELPER# sera remplace, par les lignes de code generees
automatiquement, lors de l'execution de dh_installdeb.
Si un script de maintenance n'existe pas et que debhelper doit y
inclure quelque chose, alors debhelper creera le script de maintenance
completement.
Toutes les commandes de debhelper qui produisent automatiquement des
lignes de code de cette facon peuvent inhiber cette production grace a
l'option -n (voir ci-dessus).
Nota: Les lignes de code inserees seront ecrites dans le langage de
l'interpreteur de commandes (shell). De ce fait, il est impossible de
les placer directement dans un script Perl. Pour les inserer dans un
script Perl, voici une solution. (S'assurer que $1, $2, etc. sont bien
definis par la commande set.) :
my $temp="set -e\nset -- @ARGV\n" . << 'EOF';
#DEBHELPER#
EOF
system ($temp) / 256 == 0
or die "Probleme avec le script de S<debhelper :> $!";
G'en'eration automatique des diverses d'ependances.
Some debhelper commands may make the generated package need to depend
on some other packages. For example, if you use dh_installdebconf(1),
your package will generally need to depend on debconf. Or if you use
dh_installxfonts(1), your package will generally need to depend on a
particular version of xutils. Keeping track of these miscellaneous
dependencies can be annoying since they are dependent on how debhelper
does things, so debhelper offers a way to automate it.
Toutes les commandes de ce type, outre qu'elles documentent, dans leur
page de manuel, les dependances qu'elle induisent, genereront
automatiquement une variable de substitution nommee ${misc:depends}. Si
cette variable est exploitee dans le dossier debian/control, il sera
automatiquement enrichi des dependances induites par debhelper.
Ce processus est entierement independant de ${shlibs:Depends} standard,
produite par dh_makeshlibs(1), et de ${perl:Depends} produite par
dh_perl(1). Il est egalement possible de choisir de ne pas les utiliser
si les conjectures de debhelper ne correspondent pas a la realite.
R'epertoires de construction du paquet
Par defaut, tous les programmes de debhelper supposent que le
repertoire temporaire utilise pour construire l'arborescence des
fichiers d'un paquet est debian/paquet.
Parfois, il peut etre souhaitable d'utiliser un autre repertoire
temporaire. Ceci est obtenu grace au parametre -P. Par exemple,
dh_installdocs-Pdebian/tmp utilisera debian/tmp comme repertoire
temporaire. Nota: L'usage de -P implique que les programmes de
debhelper ne construisent qu'un seul paquet a la fois. De ce fait, si
le paquet source genere plusieurs paquets binaires, il faudra employer
egalement le parametre -p pour preciser l'unique paquet binaire a
construire.
udebs
Debhelper includes support for udebs. To create a udeb with debhelper,
add "Package-Type: udeb" to the package's stanza in debian/control.
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.
VARIABLES D'ENVIRONNEMENT
DH_VERBOSE
Mettre cette variable a 1 valide le mode verbeux. Debhelper
affichera chaque commande executee qui modifie des fichiers.
DH_COMPAT
Indique temporairement le niveau de compatibilite auquel debhelper
doit fonctionner. Cette valeur supplante la valeur precisee dans
debian/compat.
DH_NO_ACT
Mettre cette variable a 1 pour activer le mode simulation (no-act).
DH_OPTIONS
Anything in this variable will be prepended to the command line
arguments of all debhelper commands.
When using dh(1), it can be passed options that will be passed on
to each debhelper command, which is generally better than using
DH_OPTIONS.
DH_ALWAYS_EXCLUDE
Si cette variable possede une valeur, elle sera ajoutee a l'option
-X de toutes les commandes qui admettent cette option. De plus,
dh_builddeb fera un rm -rf quelque chose, correspondant a la valeur
dans l'arbre de construction de paquet.
Ceci peut etre utile pour construire un paquet a partir d'une
arborescence CVS. Dans ce cas, le reglage de DH_ALWAYS_EXCLUDE=CVS
empechera les repertoires CVS d'interferer subrepticement dans le
paquet en construction. Ou, si un paquet possede une source
compressee, (maladroitement) presente dans un repertoire CVS, il
peut etre utile d'exporter DH_ALWAYS_EXCLUDE=CVS dans debian/rules,
pour que cette variable soit prise en compte quel que soit
l'endroit ou le paquet est construit.
Des exclusions multiples peuvent etre separees avec des caracteres
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
Valery Perrin <valery.perrin.debian@free.fr> le 17 septembre 2005.
Derniere mise a jour le 3 avril 2011.
L'equipe de traduction a fait le maximum pour realiser une adaptation
francaise de qualite.
Cette traduction est geree dynamiquement par po4a. Certains paragraphes
peuvent, eventuellement, apparaitre en anglais. Ils correspondent a des
modifications ou des ajouts recents du mainteneur, non encore
incorpores dans la traduction francaise.
La version originale anglaise de ce document est toujours consultable
via la commande man-Lennom_du_man.
N'hesitez pas a signaler a l'auteur ou au traducteur, selon le cas,
toute erreur dans cette page de manuel.