NOM
dh_install - installe les fichiers dans le rpertoire de construction du
paquet
SYNOPSIS
dh_install [-Xlment] [--autodest] [--sourcedir=rpertoire]
[optionsdedebhelper] [fichier[...]destination]
dh_install est un programme de la suite debhelper charg de
l'installation des fichiers dans les rpertoires de construction des
paquets. Il existe plein de commandes dh_install* qui grent
l'installation de types de fichiers particuliers tels que les
documentations, les exemples, les pages de manuel, et ainsi de suite.
Ces commandes spcifiques doivent tre employes autant que possible car
elles prsentent souvent un savoir-faire supplmentaire pour ces tches
particulires. dh_install, en revanche, est utile pour installer tout le
reste, c'est--dire tous les fichiers pour lesquels aucun savoir-faire
particulier n'est ncessaire. Ce programme vient en remplacement de
l'ancien programme dh_movefiles.
Ce programme peut tre utilis de deux faons diffrentes. S'il n'y a qu'un
ou deux fichiers que Makefile n'installe pas de lui mme, il suffit
d'excuter dh_install en le configurant pour installer ces fichiers. Par
contre, avec un paquet source qui construit plusieurs paquets binaires,
il est prfrable de demander Makefile de mettre tout dans debian/tmp
puis d'utiliser dh_install pour dplacer les rpertoires et les fichiers
depuis cet emplacement temporaire vers les rpertoires de construction
appropris de chaque paquet.
Depuis la version 7 de debhelper, dh_install cherchera dans
l'arborescence debian/tmp pour trouver les fichiers s'il ne les trouve
pas dans le rpertoire courant (ou dans celui indiqu par l'utilisation
de --sourcedir).
FICHIERS
debian/paquet.install
numre les fichiers installer dans chaque paquet ainsi que le
rpertoire o ils doivent tre installs. Ce fichier est form d'une
suite de lignes. Chaque ligne indique un ou plusieurs fichiers
installer et se termine par le rpertoire o doit tre faite
l'installation. Le nom des fichiers (ou des rpertoires) installer
doit tre fourni avec un chemin relatif au rpertoire courant, alors
que le rpertoire de destination est indiqu relativement au
rpertoire de construction du paquet. Il est possible d'employer des
jokers (wildcard) dans les noms des fichiers installer ( partir de
la version 3).
OPTIONS
--list-missing
Cette option impose dh_install de garder la trace des fichiers
qu'il installe et, la fin, de comparer cette liste aux fichiers du
rpertoire source. Si un des fichiers (ou des liens symboliques) du
rpertoire source, n'tait pas install quelque part, il le
signalerait par un message sur stderr.
Cette option peut tre utile dans le cas d'un gros paquet pour
lequel on veut tre certain de ne pas oublier l'installation d'un
des nouveaux fichiers rcemment ajouts dans la version.
Nota: Les fichiers qui sont exclus par l'option -X n'entranent
aucun message d'erreur.
--fail-missing
Cette option est similaire --list-missing, sauf que, si un fichier
est oubli, cela produira non seulement un message sur stderr mais
galement un chec du programme avec une valeur de retour diffrente
de zro.
-Xlment, --exclude=lment
Exclut du traitement les fichiers qui comportent lment n'importe o
dans leur nom.
--sourcedir=rpertoire
Cherche dans le rpertoire spcifi les fichiers installer.
Nota: Cette option ne fait pas la mme chose que --sourcedirectory
utilise par dh_auto_*. Il est rare d'avoir besoin d'utiliser cette
option puisque dh_install cherche automatiquement les fichiers dans
debian/tmp depuis la version 7 de debhelper.
--autodest
Avec ce paramtre, dh_install dtermine de lui-mme le rpertoire de
destination des lments installs. Si cette option est spcifie, il ne
faut indiquer les rpertoires de destination, ni dans les fichiers
debian/paquet.install, ni en ligne de commande. dh_install dtermine
les rpertoires de destination selon la rgle suivante:
Il enlve debian/tmp (ou le nom du rpertoire source, s'il a t
indiqu) du dbut du chemin du fichier, s'il est prsent, et copie le
fichier dans le rpertoire de construction du paquet, sous
l'arborescence indique pour le fichier source. Par exemple, si
l'objet installer est le rpertoire debian/tmp/usr/bin, alors il
sera copi dans debian/paquet/usr/. Si le fichier installer est
debian/tmp/etc/passwd, il sera copi dans debian/paquet/etc/.
Nota: Si le nom du fichier (ou le motif d'un ensemble de fichiers)
est indiqu sur une ligne du fichier debian/paquet.install, sans que
la destination soit prcise, alors dh_install dterminera
automatiquement la destination, mme en l'absence de l'option
--autodest.
fichier [...] destination
Permet d'numrer les fichiers (ou les rpertoires) installer ainsi
que leur destination. Les fichiers indiqus seront installs dans le
premier paquet trait par dh_install.
EXEMPLE
Par exemple: le Makefile du paquet gnre un fichier binaire, une page de
manuel et une bibliothque dans le rpertoire adquat de debian/tmp.
L'objectif est de mettre la bibliothque dans le paquet binaire libtoto
et le reste dans le paquet binaire toto. Le fichier rules excutera
dh_install--sourcedir=debian/tmp. Dans ce cas, il faut crer un fichier
debian/toto.install qui contienne:
usr/bin
usr/share/man/man1
Tandis que debian/libtoto.install devra contenir:
usr/lib/libtoto*.so.*
S'il faut aussi crer le paquet libtoto-dev alors le fichier
debian/libtoto-dev.install devra contenir:
usr/include
usr/lib/libfoo*.so
usr/share/man/man3
LIMITES
dh_install ne peut pas renommer les fichiers ou les rpertoires, il peut
seulement les implanter n'importe o dans l'arbre de construction du
paquet mais avec le nom qu'ils possdent dj.
VOIR AUSSI
debhelper(7)
Ce programme fait partie 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.