Provided by: debhelper_11.1.6ubuntu2_all 

NOM
dh_install - Installer les fichiers dans le répertoire de construction du paquet
SYNOPSIS
dh_install [-Xélément] [--autodest] [--sourcedir=répertoire] [options_de_debhelper]
[fichier|répertoire ... répertoire_destination]
DESCRIPTION
dh_install est un programme de la suite debhelper chargé de l'installation des fichiers dans les
répertoires de construction des paquets. Il existe plein de commandes dh_install* qui gèrent
l'installation de types de fichier particuliers tels que les documentations, les exemples, les pages de
manuel, et ainsi de suite. Ces commandes spécifiques doivent être employées autant que possible car elles
présentent souvent un savoir-faire supplémentaire pour ces tâches particulières. 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 nécessaire. Ce programme vient en remplacement de l'ancien programme dh_movefiles.
Ce programme peut être utilisé de deux façons différentes. S'il n'y a qu'un ou deux fichiers que Makefile
n'installe pas lui même, il suffit d'exécuter dh_install en le configurant pour installer ces fichiers.
Par contre, avec un paquet source qui construit plusieurs paquets binaires, il est préférable de demander
à Makefile de mettre tout dans debian/tmp puis d'utiliser dh_install pour déplacer les répertoires et les
fichiers depuis cet emplacement temporaire vers les répertoires de construction appropriés de chaque
paquet.
From debhelper compatibility level 7 on, dh_install will fall back to looking in debian/tmp for files, if
it does not find them in the current directory (or wherever you've told it to look using --sourcedir).
FICHIERS
debian/paquet.install
Énumère les fichiers à installer dans chaque paquet ainsi que le répertoire où ils doivent être
installés. Ce fichier est formé d'une suite de lignes. Chaque ligne indique un ou plusieurs fichiers
à installer et se termine par le répertoire où doit être faite l'installation. Le nom des fichiers
(ou des répertoires) à installer doit être fourni avec un chemin relatif au répertoire courant, alors
que le répertoire de destination est indiqué relativement au répertoire de construction du paquet. Il
est possible d'employer des jokers (wildcard) dans les noms des fichiers à installer.
Nota : Si le nom du fichier (ou le motif d'un ensemble de fichiers) est indiqué tout seul, sans que
la destination ne soit précisée, alors dh_install déterminera automatiquement la destination à
utiliser, comme si l'option --autodest avait été utilisée.
debian/not-installed
Used with the deprecated --list-missing and --fail-missing options. Please refer to dh_missing(1) for
the documentation of this file.
OPTIONS
--list-missing
Deprecated: Please use dh_missing --list-missing instead. If you use this option, dh_install will
call dh_missing with that option after it has processed all the files. Please see dh_missing(1) for
the documentation of this option.
This option is removed in compat 12.
--fail-missing
Deprecated: Please use dh_missing --fail-missing instead. If you use this option, dh_install will
call dh_missing with that option after it has processed all the files. Please see dh_missing(1) for
the documentation of this option.
This option is removed in compat 12.
--sourcedir=répertoire
Cherche dans le répertoire indiqué les fichiers à installer.
Nota : Cette option ne fait pas la même chose que --sourcedirectory utilisée 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 paramètre, dh_install détermine de lui-même le répertoire de destination des éléments
installés. Si cette option est indiquée, il ne faut indiquer les répertoires de destination, ni dans
les fichiers debian/paquet.install, ni en ligne de commande. dh_install détermine les répertoires de
destination selon la règle suivante :
Il enlève debian/tmp (ou le nom du répertoire source, s'il a été indiqué) du début du chemin du
fichier, s'il est présent, et copie le fichier dans le répertoire de construction du paquet, sous
l'arborescence indiquée pour le fichier source. Par exemple, si l'objet à installer est le répertoire
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/.
fichier|répertoire ... répertoire_destination
Permet d'énumérer les fichiers (ou les répertoires) à installer ainsi que leur destination. Les
fichiers indiqués seront installés dans le premier paquet traité par dh_install.
LIMITES
dh_install ne peut pas renommer les fichiers ou les répertoires, il peut seulement les implanter
n'importe où dans l'arbre de construction du paquet mais avec les noms qu'ils possèdent déjà.
En revanche, le renommage peut être effectué en utilisant dh_exec avec le niveau de compatibilité 9 ou
supérieur. Un exemple de fichier debian/<paquet>.install utilisant dh_exec ressemblerait à :
#!/usr/bin/dh-exec
debian/default.conf => /etc/mon-paquet/start.conf
Veuillez vous souvenir de ces trois remarques :
• Le paquet doit utiliser le niveau de compatibilité 9 ou supérieur (voir debhelper(7)) ;
• Le paquet doit contenir une dépendance de construction sur dh_exec ;
• Le fichier install doit être marqué comme exécutable.
VOIR AUSSI
debhelper(7)
Ce programme fait partie de debhelper.
AUTEUR
Joey Hess <joeyh@debian.org>
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.
Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
un rapport de bogue sur le paquet debhelper.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
<section> <page_de_man> ».
11.1.6ubuntu2 2018-05-10 DH_INSTALL(1)