295 lines
9.4 KiB
HTML
295 lines
9.4 KiB
HTML
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<HTML><HEAD><TITLE>Man page of DH_INSTALL</TITLE>
|
||
</HEAD><BODY>
|
||
<H1>DH_INSTALL</H1>
|
||
Section: Debhelper (1)<BR>Updated: 2020-03-27<BR><A HREF="#index">Index</A>
|
||
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<A NAME="lbAB"> </A>
|
||
<H2>NOM</H2>
|
||
|
||
|
||
|
||
dh_install - Installer les fichiers dans le répertoire de construction du
|
||
paquet
|
||
<A NAME="lbAC"> </A>
|
||
<H2>SYNOPSIS</H2>
|
||
|
||
|
||
|
||
<B>dh_install</B> [<B>-X</B><I>élément</I>] [<B>--autodest</B>]
|
||
[<B>--sourcedir=</B><I>répertoire</I>] [<I>options_de_debhelper</I>]
|
||
[<I>fichier|répertoire</I> ... <I>répertoire_destination</I>]
|
||
<A NAME="lbAD"> </A>
|
||
<H2>DESCRIPTION</H2>
|
||
|
||
|
||
|
||
<B>dh_install</B> 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 <B>dh_install</B><I>*</I> 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. <B>dh_install</B>, 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 <B>dh_movefiles</B>.
|
||
<P>
|
||
|
||
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
|
||
<B>dh_install</B> 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 à <I>Makefile</I> de mettre tout dans <I>debian/tmp</I> puis
|
||
d'utiliser <B>dh_install</B> pour déplacer les répertoires et les fichiers
|
||
depuis cet emplacement temporaire vers les répertoires de construction
|
||
appropriés de chaque paquet.
|
||
<P>
|
||
|
||
Depuis la version 7 de debhelper, <B>dh_install</B> cherchera dans
|
||
l'arborescence <I>debian/tmp</I> pour trouver les fichiers s'il ne les trouve
|
||
pas dans le répertoire courant (ou dans celui indiqué par l'utilisation de
|
||
<B>--sourcedir</B>).
|
||
<A NAME="lbAE"> </A>
|
||
<H2>FICHIERS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="1">debian/<I>paquet</I>.install<DD>
|
||
|
||
|
||
É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.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
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
|
||
<B>dh_install</B> déterminera automatiquement la destination à utiliser, comme
|
||
si l'option <B>--autodest</B> avait été utilisée.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Supports substitution variables in compat 13 and later as documented in
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7).
|
||
<DT id="2">debian/not-installed<DD>
|
||
|
||
|
||
Utilisé avec les options obsolètes <B>--list-missing</B> et
|
||
<B>--fail-missing</B>. Consultez <B><A HREF="/cgi-bin/man/man2html?1+dh_missing">dh_missing</A></B>(1) pour la documentation de ce
|
||
fichier.
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>OPTIONS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="3"><B>--list-missing</B><DD>
|
||
|
||
|
||
<B>Obsolète</B> : veuillez utiliser <B>dh_missing --list-missing</B> à la place. Si
|
||
vous utilisez cette option, <B>dh_install</B> appellera <B>dh_missing</B> avec cette
|
||
option après le traitement de tous les fichiers. Consultez <B><A HREF="/cgi-bin/man/man2html?1+dh_missing">dh_missing</A></B>(1)
|
||
pour la documentation de cette option.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Cette option est supprimée dans le niveau de compatibilité 12.
|
||
<DT id="4"><B>--fail-missing</B><DD>
|
||
|
||
|
||
<B>Obsolète</B> : veuillez utiliser <B>dh_missing --fail-missing</B> à la place. Si
|
||
vous utilisez cette option, <B>dh_install</B> appellera <B>dh_missing</B> avec cette
|
||
option après le traitement de tous les fichiers. Consultez <B><A HREF="/cgi-bin/man/man2html?1+dh_missing">dh_missing</A></B>(1)
|
||
pour la documentation de cette option.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Cette option est supprimée dans le niveau de compatibilité 12.
|
||
<DT id="5"><B>--sourcedir=</B><I>répertoire</I><DD>
|
||
|
||
|
||
Cherche dans le répertoire indiqué les fichiers à installer.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Nota : Cette option ne fait pas la même chose que <B>--sourcedirectory</B>
|
||
utilisée par <B>dh_auto_</B><I>*</I>. Il est rare d'avoir besoin d'utiliser cette
|
||
option puisque <B>dh_install</B> cherche automatiquement les fichiers dans
|
||
<I>debian/tmp</I> depuis la version 7 de debhelper.
|
||
<DT id="6"><B>--autodest</B><DD>
|
||
|
||
|
||
Avec ce paramètre, <B>dh_install</B> 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
|
||
<I>debian/paquet.install</I>, ni en ligne de commande. <B>dh_install</B> détermine
|
||
les répertoires de destination selon la règle suivante :
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Il enlève <I>debian/tmp</I> (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
|
||
<I>debian/tmp/usr/bin</I>, alors il sera copié dans <I>debian/paquet/usr/</I>. Si le
|
||
fichier à installer est <I>debian/tmp/etc/passwd</I>, il sera copié dans
|
||
<I>debian/paquet/etc/</I>.
|
||
<DT id="7"><I>fichier|répertoire</I> ... <I>répertoire_destination</I><DD>
|
||
|
||
|
||
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 <B>dh_install</B>.
|
||
</DL>
|
||
<A NAME="lbAG"> </A>
|
||
<H2>EXEMPLES</H2>
|
||
|
||
|
||
|
||
Here are some small examples of configuration files for dh_install.
|
||
<P>
|
||
|
||
|
||
|
||
<PRE>
|
||
# Install my-prog into usr/bin (as "usr/bin/my-prog")
|
||
my-prog usr/bin
|
||
|
||
# Install a plugins directory into usr/share/my-prog
|
||
# (as "usr/share/my-prog/plugins/")
|
||
plugins usr/share/my-prog
|
||
|
||
# Install a file with spaces in into usr/share/my-prog/data
|
||
# (as "usr/share/my-prog/data/my datafile with spaces.txt")
|
||
# ASSUMES COMPAT 13, where substitution patterns are available
|
||
my${Space}datafile${Space}with${Space}spaces.txt usr/share/my-prog/data
|
||
|
||
# Install a library into the multi-arch lib directory
|
||
# ASSUMES COMPAT 13, where substitution patterns are available
|
||
build/output/libfrop*.so.* usr/lib/${DEB_HOST_MULTIARCH}
|
||
|
||
</PRE>
|
||
|
||
|
||
<A NAME="lbAH"> </A>
|
||
<H2>LIMITES</H2>
|
||
|
||
|
||
|
||
<B>dh_install</B> 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à.
|
||
<P>
|
||
|
||
En revanche, le renommage peut être effectué en utilisant <B>dh_exec</B> avec le
|
||
niveau de compatibilité 9 ou supérieur. Un exemple de fichier
|
||
debian/<paquet>.install utilisant <B>dh_exec</B> ressemblerait à :
|
||
<P>
|
||
|
||
|
||
|
||
<PRE>
|
||
#!/usr/bin/dh-exec
|
||
debian/default.conf => /etc/mon-paquet/start.conf
|
||
|
||
</PRE>
|
||
|
||
|
||
<P>
|
||
|
||
Veuillez vous souvenir de ces trois remarques :
|
||
<DL COMPACT>
|
||
<DT id="8">•<DD>
|
||
Le paquet doit utiliser le niveau de compatibilité 9 ou supérieur (voir
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)) ;
|
||
<DT id="9">•<DD>
|
||
Le paquet doit contenir une dépendance de construction sur dh_exec ;
|
||
<DT id="10">•<DD>
|
||
Le fichier install doit être marqué comme exécutable.
|
||
</DL>
|
||
<A NAME="lbAI"> </A>
|
||
<H2>VOIR AUSSI</H2>
|
||
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
|
||
<P>
|
||
|
||
Ce programme fait partie de debhelper.
|
||
<A NAME="lbAJ"> </A>
|
||
<H2>AUTEUR</H2>
|
||
|
||
|
||
|
||
Joey Hess <<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>>
|
||
<A NAME="lbAK"> </A>
|
||
<H2>TRADUCTION</H2>
|
||
|
||
|
||
|
||
Cette traduction est maintenue à l'aide de l'outil po4a
|
||
<URL:<A HREF="http://po4a.alioth.debian.org/">http://po4a.alioth.debian.org/</A>> par l'équipe francophone de traduction
|
||
de Debian.
|
||
<P>
|
||
|
||
Veuillez signaler toute erreur de traduction en écrivant à
|
||
<<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>> ou par un rapport de bogue sur le paquet
|
||
debhelper.
|
||
<P>
|
||
|
||
Vous pouvez toujours avoir accès à la version anglaise de ce document en
|
||
utilisant la commande « man -L C <section> <page_de_man> ».
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="11"><A HREF="#lbAB">NOM</A><DD>
|
||
<DT id="12"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||
<DT id="13"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||
<DT id="14"><A HREF="#lbAE">FICHIERS</A><DD>
|
||
<DT id="15"><A HREF="#lbAF">OPTIONS</A><DD>
|
||
<DT id="16"><A HREF="#lbAG">EXEMPLES</A><DD>
|
||
<DT id="17"><A HREF="#lbAH">LIMITES</A><DD>
|
||
<DT id="18"><A HREF="#lbAI">VOIR AUSSI</A><DD>
|
||
<DT id="19"><A HREF="#lbAJ">AUTEUR</A><DD>
|
||
<DT id="20"><A HREF="#lbAK">TRADUCTION</A><DD>
|
||
</DL>
|
||
<HR>
|
||
This document was created by
|
||
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
||
using the manual pages.<BR>
|
||
Time: 00:05:00 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|