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.

       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 répertoire courant (ou dans celui indiqué par l'utilisation de
       --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.

           Les variables de substitution sont  prises  en  charge   dans  les  niveaux  de  compatibilité 13  et
           ultérieurs comme documenté dans debhelper(7).

       debian/not-installed
           Utilisé  avec les options obsolètes --list-missing et --fail-missing. Consultez dh_missing(1) pour la
           documentation de ce fichier.

OPTIONS

       --list-missing
           Obsolète : veuillez utiliser dh_missing --list-missing à la place. Si  vous  utilisez  cette  option,
           dh_install appellera dh_missing avec cette option après le traitement de tous les fichiers. Consultez
           dh_missing(1) pour la documentation de cette option.

           Cette option est supprimée dans le niveau de compatibilité 12.

       --fail-missing
           Obsolète :  veuillez  utiliser  dh_missing  --fail-missing à la place. Si vous utilisez cette option,
           dh_install appellera dh_missing avec cette option après le traitement de tous les fichiers. Consultez
           dh_missing(1) pour la documentation de cette option.

           Cette option est supprimée dans le niveau de compatibilité 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.

EXEMPLES

       Voici quelques courts exemples de fichiers de configuration pour dh_install.

           # Installation de mon-prog dans usr/bin (« usr/bin/mon-prog »)
           mon-prog usr/bin

           # Installation d'un répertoire de greffons dans usr/share/mon-prog
           # (sous « usr/share/mon-prog/plugins/ »")
           plugins usr/share/mon-prog

           # Installation d'un fichier avec des espaces dans usr/share/mon-prog/data
           # (sous « usr/share/my-prog/data/mon_fichier-de-données avec espaces.txt »)
           # SUPPOSE COMPAT 13 où les motifs de substitution sont disponibles
           my${Space}fichier${Space}with${Space}spaces.txt usr/share/mon-prog/data

           # Installe une bibliothèque dans le répertoire
           # de bibliothèques multi-arch
           # SUPPOSE COMPAT 13 où les motifs de substitution sont disponibles
           build/output/libfrop*.so.* usr/lib/${DEB_HOST_MULTIARCH}

CONTRAINTES

       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> ».

13.14.1ubuntu5                                     2024-03-01                                      DH_INSTALL(1)