.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_INSTALLDEB 1"
.TH DH_INSTALLDEB 1 "2021-03-06" "13.3.4" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOM"
.IX Header "NOM"
dh_installdeb \- Installer des fichiers dans le répertoire \s-1DEBIAN\s0
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdh_installdeb\fR [\fIoptions_de_debhelper\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdh_installdeb\fR est le programme de la suite debhelper chargé de
l'installation des fichiers dans le répertoire \fI\s-1DEBIAN\s0\fR du répertoire de
construction du paquet ainsi que du réglage correct des droits sur ces
fichiers.
.SH "FICHIERS"
.IX Header "FICHIERS"
.IP "\fIpaquet\fR.postinst" 4
.IX Item "paquet.postinst"
.PD 0
.IP "\fIpaquet\fR.preinst" 4
.IX Item "paquet.preinst"
.IP "\fIpaquet\fR.postrm" 4
.IX Item "paquet.postrm"
.IP "\fIpaquet\fR.prerm" 4
.IX Item "paquet.prerm"
.PD
Ces scripts de maintenance sont installés dans le répertoire \fI\s-1DEBIAN\s0\fR.
.Sp
\&\fBdh_installdeb\fR réalisera la substitution des items connus du format
\&\fB#TOKEN#\fR. En général, les scripts voudront inclure l'item \fB#DEBHELPER#\fR
pour bénéficier des scripts de l'interpréteur de commandes générés par les
commandes debhelper (y compris ceux de \fBdh_installdeb\fR quand il traite les
fichiers \fIpaquet\fR.maintscript).
.Sp
L'item \fB#DEBHELPER#\fR devrait être placé sur sa ligne propre parce qu'il est
souvent remplacé par un script multiligne de l'interpréteur de commandes.
.IP "\fIpaquet\fR.triggers" 4
.IX Item "paquet.triggers"
.PD 0
.IP "\fIpaquet\fR.shlibs" 4
.IX Item "paquet.shlibs"
.PD
Ces fichiers de contrôle sont installés dans le répertoire \fI\s-1DEBIAN\s0\fR.
.Sp
Veuillez noter que \fIpaquet\fR.shlibs est uniquement installé si le niveau de
compatibilité est 9 ou inférieur. En version 10, veuillez utiliser
\&\fBdh_makeshlibs\fR\|(1).
.IP "\fIpaquet\fR.conffiles" 4
.IX Item "paquet.conffiles"
Historiquement ce fichier était nécessaire pour marquer manuellement les
fichiers comme des conffiles. Cependant il est devenu obsolète de facto
depuis que debhelper détermine automatiquement quels fichiers doivent être
marqués comme conffiles.
.Sp
Jusqu'à la version 11, ce fichier de contrôle était installé dans le dossier
\&\fI\s-1DEBIAN\s0\fR. À partir de la version 12, ce fichier est ignoré en silence.
.IP "\fIpaquet\fR.maintscript" 4
.IX Item "paquet.maintscript"
Les lignes de ce fichier correspondent à des commandes et leurs paramètres
de \fBdpkg\-maintscript\-helper\fR\|(1). « maint-script-parameters » ne devrait
\&\fIpas\fR être inclus car debhelper l'ajoutera automatiquement.
.Sp
Exemple :
.Sp
.Vb 4
\&    # Correct
\&    rm_conffile /etc/obsolete.conf 0.2~ toto
\&    # INCORRECT
\&    rm_conffile /etc/obsolete.conf 0.2~ toto \-\- "$@"
.Ve
.Sp
Dans les niveaux de compatibilité 10 ou suivants, tous les métacaractères de
l'interpréteur de commandes seront protégés, aussi du code arbitraire
d'interpréteur de commandes ne peut pas être inséré ici. Par exemple, une
ligne comme \f(CW\*(C`mv_conffile /etc/oldconffile /etc/newconffile\*(C'\fR insérera des
extraits du script de maintenance dans tous les scripts de maintenance,
suffisant pour déplacer le fichier \fIconffile\fR.
.Sp
L'intention était aussi d'échapper les métacaractères du shell dans les
modes précédents. Cependant, cela ne fonctionnait pas correctement et il
était possible d'embarquer du code shell arbitraire dans les modes
précédents.
.Sp
L'outil \fBdh_installdeb\fR effectuera quelques validations basiques sur
certaines commandes listées dans ce fichier pour éviter les erreurs
habituelles. Cette validation renvoie un avertissement depuis la version 10,
et une erreur en version 12.
.Sp
Les variables de substitution sont prises en charge  dans les niveaux de
compatibilité 13 et ultérieurs comme documenté dans \fBdebhelper\fR\|(7).
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-D\fR\fIITEM=VALEUR\fR, \fB\-\-define\fR \fIITEM=VALEUR\fR" 4
.IX Item "-DITEM=VALEUR, --define ITEM=VALEUR"
Définit les items qui doivent être remplacés dans les scripts du responsable
quand ils sont créés. Veuillez noter que les contraintes décrites dans
\&\*(L"Restrictions dans les noms d'item\*(R" s'appliquent aussi aux items définis
en ligne de commande. Les noms d'item non valables déclencheront une erreur.
.Sp
Dans un cas simple, ce paramètre fera que \fB#\f(BI\s-1ITEM\s0\fB#\fR sera remplacé par
\&\fI\s-1VALEUR\s0\fR. Si \fI\s-1VALEUR\s0\fR commence par un signe \fI@\fR littéral, alors \fI\s-1VALEUR\s0\fR
est censé pointer vers un fichier contenant la valeur réelle à insérer.
.Sp
Un item déclaré de façon explicite avec ce paramètre remplacera les items
internes.
.Sp
Exemples de tests pour aider à mieux comprendre :
.Sp
.Vb 6
\&        cat >> debian/postinst <<EOF
\&        #SIMPLE#
\&        #FILEBASED#
\&        EOF
\&        echo \-n "valeur_complexe" > un_fichier
\&    dh_installdeb \-\-define SIMPLE=direct \-\-define FILEBASED=@un_fichier
.Ve
.Sp
Dans cet exemple, \fB#SIMPLE#\fR sera développé en \fBdirect\fR et \fB#FILEBASED#\fR
sera développé en \fBvaleur_complexe\fR.
.Sp
Il est aussi possible de fixer des valeurs spécifiques à un paquet pour un
item donné. Cela est utilisé quand \fBdh_installdeb\fR agit sur plusieurs
paquets qui ont besoin de valeurs distinctes pour le même item. Cela est
obtenu en préfixant le nom de l'item par \fBpkg.\f(BInom-paquet\fB.\fR.
.Sp
Cela peut être utilisé comme dans l'exemple suivant :
.Sp
.Vb 10
\&        cat >> debian/toto.postinst <<EOF
\&        # Script pour #PACKAGE#
\&        #TOKEN#
\&        EOF
\&        cat >> debian/titi.postinst <<EOF
\&        # Script pour #PACKAGE#
\&        #TOKEN#
\&        EOF
\&        cat >> debian/truc.postinst <<EOF
\&        # Script pour #PACKAGE#
\&        #TOKEN#
\&        EOF
\&    dh_installdeb \-ptoto \-ptiti \-ptruc  \-\-define TOKEN=default \-\-define pkg.titi.TOKEN=valeur\-unique\-titi \e
\&      \-\-define pkg.truc.TOKEN=valeur\-unique\-truc
.Ve
.Sp
Dans cet exemple, \fB#TOKEN#\fR sera développé en \fBdefault\fR dans
\&\fIdebian/toto.postinst\fR, en \fBvaleur-unique-titi\fR dans
\&\fIdebian/titi.postinst\fR et en \fBvaleur-unique-truc\fR dans
\&\fIdebian/truc.postinst\fR.
.Sp
Notez que les items de \fB#pkg.*#\fR seront visibles dans tous les scripts
actifs. Par exemple, il est possible de faire référence à
\&\fB#pkg.titi.TOKEN#\fR dans \fIdebian/toto.postinst\fR et il sera remplacé par
\&\fBvaleur-unique-titi\fR.
.SH "SUBSTITUTION DANS LES SCRIPTS DU RESPONSABLE"
.IX Header "SUBSTITUTION DANS LES SCRIPTS DU RESPONSABLE"
\&\fBdh_installdeb\fR remplacera automatiquement les items suivants dans un
script fourni par le responsable (s'il n'est pas remplacé au moyen de \fB\-D\fR
ou \fB\-\-define\fR) :
.IP "#DEBHELPER#" 4
.IX Item "#DEBHELPER#"
Cet item est par défaut remplacé par les lignes de code générées par les
commandes de debhelper. Cela comprend les lignes de code générées par
\&\fBdh_installdeb\fR à partir du fichier \fIpaquet\fR.maintscript (s'il est
présent).
.IP "#DEB_HOST_\fI\s-1NOM\s0\fR#, #DEB_BUILD_\fI\s-1NOM\s0\fR#, #DEB_TARGET_\fI\s-1NOM\s0\fR#" 4
.IX Item "#DEB_HOST_NOM#, #DEB_BUILD_NOM#, #DEB_TARGET_NOM#"
Ces items sont remplacés par leur variable respective venant de
\&\fBdpkg\-architecture\fR\|(1). Dans presque tous les cas, vous voudrez utiliser la
variante \fB#DEB_HOST_\f(BI\s-1NOM\s0\fB\fR dans un script pour vous assurer d'obtenir
la valeur correcte lors d'une construction croisée.
.Sp
Dans un souci de qualité, les items avec ce motif qui ne correspondent pas à
une variable de \fBdpkg\-architecture\fR\|(1) seront laissés tels quels.
.IP "#ENV.\fI\s-1NOM\s0\fR#" 4
.IX Item "#ENV.NOM#"
Les items de cette forme seront remplacés par la valeur de la variable
d'environnement correspondante. Si la variable d'environnement n'est pas
définie, l'item est remplacé par une chaîne vide.
.Sp
Notez qu'il y a des restrictions sur les noms pouvant être utilisés voir
\&\*(L"Restrictions dans les noms d'item\*(R").
.IP "#PACKAGE#" 4
.IX Item "#PACKAGE#"
Cet item est remplacé par défaut par le nom du paquet qui contiendra le
script réel.
.SS "Restrictions dans les noms d'item"
.IX Subsection "Restrictions dans les noms d'item"
Tous les items destinés à être remplacés doivent correspondre à l'expression
rationnelle : #[A\-Za\-z0\-9_.+]+#
.PP
Les items qui ne correspondent pas à cette expression rationnelle seront
ignorés silencieusement s'ils sont présents dans un modèle de script. Les
noms d'item non valables passés à \fB\-D\fR ou \fB\-\-define\fR feront que
\&\fBdh_installdeb\fR rejettera la commande avec une erreur dans la plupart des
cas.
.SH "VOIR AUSSI"
.IX Header "VOIR AUSSI"
\&\fBdebhelper\fR\|(7)
.PP
Ce programme fait partie de debhelper.
.SH "AUTEUR"
.IX Header "AUTEUR"
Joey Hess <joeyh@debian.org>
.SH "TRADUCTION"
.IX Header "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.
.PP
Veuillez signaler toute erreur de traduction en écrivant à
<debian\-l10n\-french@lists.debian.org> ou par un rapport de bogue sur le paquet
debhelper.
.PP
Vous pouvez toujours avoir accès à la version anglaise de ce document en
utilisant la commande « man \-L C <section> <page_de_man> ».