182 lines
9.2 KiB
HTML
182 lines
9.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of deb-substvars</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>deb-substvars</H1>
|
|
Section: suite dpkg (5)<BR>Updated: 2020-03-23<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>
|
|
|
|
deb-substvars - Variables de substitution de source Debian
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
substvars
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Avant que <B>dpkg-source</B>, <B>dpkg-gencontrol</B> et <B>dpkg-genchanges</B>
|
|
n'écrivent leurs informations de contrôle (dans le fichier source de
|
|
contrôle <B>.dsc</B> pour <B>dpkg-source</B> et sur la sortie standard pour
|
|
<B>dpkg-gencontrol</B> et <B>dpkg-genchanges</B>), ils réalisent quelques
|
|
substitutions de variables dans le fichier de sortie.
|
|
<P>
|
|
Une substitution de variable est de la forme : <B>${</B><I>nom-variable</I><B>}</B>. Les
|
|
noms de variable consistent en caractères alphanumériques (a-zA-Z0-9),
|
|
traits d'union (-) et « deux points » (:) ; ils commencent par une lettre ou
|
|
un chiffre et sont sensibles à la casse même si ils se réfèrent à d'autres
|
|
entités qui préservent la casse. La substitution se fait répétitivement
|
|
jusqu'à ce qu'il n'en reste aucune à faire ; le texte entier du champ après
|
|
la substitution est réexaminé pour chercher d'autres substitutions.
|
|
<P>
|
|
Quand toutes les substitutions ont été faites, chaque occurrence de la
|
|
chaîne <B>${}</B> (laquelle n'est pas une substitution autorisée) est remplacée
|
|
par un signe <B>$</B>.
|
|
<P>
|
|
Alors que le remplacement de variables est effectué sur tous les champs de
|
|
contrôle, certains de ces champs sont utilisés et nécessaires pendant la
|
|
construction alors même que la substitution n'a pas encore pu être
|
|
effectuée. Cela explique pourquoi il n'est pas possible d'utiliser de
|
|
variables dans les champs <B>Package</B>, <B>Source</B> et <B>Architecture</B>.
|
|
<P>
|
|
La substitution de variables se fait dans le contenu des champs après leur
|
|
analyse. En conséquence, si vous souhaitez qu'une variable soit remplacée
|
|
sur plusieurs lignes, il n'est pas nécessaire de placer une espace après le
|
|
retour à la ligne. Cela se fait implicitement quand le champ est
|
|
affiché. Par exemple, si la variable <B>${Description}</B> est positionnée sur
|
|
« foo est bar.${Newline}foo est super. » et si vous avez le champ suivant :
|
|
<P>
|
|
<BR> Description: application foo
|
|
<BR> ${Description}
|
|
<BR> .
|
|
<BR> Encore du texte.
|
|
<P>
|
|
Le résultat final sera :
|
|
<P>
|
|
<BR> Description: application foo
|
|
<BR> foo est bar.
|
|
<BR> foo est super.
|
|
<BR> .
|
|
<BR> Encore du texte.
|
|
<P>
|
|
On peut définir les variables en utilisant l'option commune <B>-V</B>. On peut
|
|
aussi se servir du fichier <B>debian/substvars</B> (ou tout autre fichier avec
|
|
l'option <B>-T</B>). Ce fichier est composé de lignes de la forme suivante :
|
|
<I>nom</I><B>=</B><I>valeur</I>. Les espaces résiduelles sur chaque ligne, les lignes
|
|
vides et les lignes qui commencent par un symbole <B>#</B> sont ignorées.
|
|
<P>
|
|
En outre, les variables standard suivantes sont disponibles :
|
|
<DL COMPACT>
|
|
<DT id="1"><B>Arch</B><DD>
|
|
L'architecture de l'hôte actuel (c'est-à-dire l'architecture pour laquelle
|
|
le paquet est construit, équivalent de <B>DEB_HOST_ARCH</B>).
|
|
<DT id="2"><B>source:Version</B><DD>
|
|
Version du paquet source (depuis dpkg 1.13.19).
|
|
<DT id="3"><B>source:Upstream-Version</B><DD>
|
|
La version amont du paquet source, avec éventuellement l'« epoch » de la
|
|
version Debian (depuis dpkg 1.13.19).
|
|
<DT id="4"><B>binary:Version</B><DD>
|
|
La version du paquet binaire (qui peut être différente de <B>source:Version</B>
|
|
dans un binNMU par exemple ; depuis dpkg 1.13.19).
|
|
<DT id="5"><B>Source-Version</B><DD>
|
|
La version du paquet source, selon le fichier changelog. Cette variable est
|
|
maintenant <B>obsolète</B> et produit une erreur lors de son utilisation car sa
|
|
signification est distincte de sa fonction. Utilisez plutôt
|
|
<B>source:Version</B> ou <B>binary:Version</B>.
|
|
<DT id="6"><B>source:Synopsis</B><DD>
|
|
Le synopsis du paquet source, extrait du champ <B>Description</B> du paragraphe
|
|
source, s'il existe (depuis dpkg 1.19.0).
|
|
<DT id="7"><B>source:Extended-Description</B><DD>
|
|
La description étendue du paquet source, extraite du champ <B>Description</B> du
|
|
paragraphe source, s'il existe (depuis dpkg 1.19.0).
|
|
<DT id="8"><B>Installed-Size</B><DD>
|
|
La taille approximative de tous les fichiers installés du paquet. Cette
|
|
valeur est copiée dans le champ adéquat du fichier « control » ; quand on
|
|
fixe cette variable, cela modifie la valeur de ce champ. Quand elle est
|
|
indéterminée, <B>dpkg-gencontrol</B> calcule la valeur par défaut en
|
|
additionnant la taille de chaque fichier ordinaire et lien symbolique
|
|
arrondie en unité d'un kio utilisée et sur la base d'un kio pour n'importe
|
|
quel type d'objet du système de fichiers.
|
|
<P>
|
|
<B>Remarque</B> : Il faut tenir compte que cela ne peut jamais être qu'une
|
|
approximation dans la mesure où la taille véritablement occupée sur un
|
|
système installé dépend largement du système de fichiers utilisé et de ses
|
|
paramètres, ce qui pourrait finir par l'utilisation de plus ou moins
|
|
d'espace que ce qui est spécifié dans ce champ.
|
|
<DT id="9"><B>Extra-Size</B><DD>
|
|
L'espace disque supplémentaire utilisé pour l'installation du paquet. Quand
|
|
on fixe cette variable, on ajoute sa valeur à la valeur de la variable
|
|
<B>Installed-Size</B> (qu'elle soit définie explicitement ou calculée par
|
|
défaut) avant qu'elle soit copiée dans le champ <B>Installed-Size</B> du fichier
|
|
« control ».
|
|
<DT id="10"><B>S:</B><I>nom-de-champ</I><DD>
|
|
La valeur du champ <I>nom-de-champ</I> du paragraphe source (qui doit être
|
|
classiquement en majuscules, depuis dpkg 1.18.11). Quand on fixe ces
|
|
variables, cela ne prend effet que là où elles sont explicitement
|
|
développées. Ces variables ne sont disponibles que lors de la création des
|
|
fichiers de contrôle binaires.
|
|
<DT id="11"><B>F:</B><I>nom-de-champ</I><DD>
|
|
La valeur du champ <I>nom-de-champ</I> affichée en sortie (qui doit être
|
|
classiquement en majuscules). Quand on fixe ces variables, cela ne prend
|
|
effet que là où elles sont explicitement développées.
|
|
<DT id="12"><B>Format</B><DD>
|
|
La version du format du fichier <B>.changes</B> produite par la version des
|
|
scripts construisant le source. Quand on détermine cette variable, le
|
|
contenu du champ <B>Format</B> dans le fichier <B>.changes</B> est aussi modifié.
|
|
<DT id="13"><B>Newline</B>, <B>Space</B>, <B>Tab</B><DD>
|
|
Ces variables contiennent chacune le caractère correspondant.
|
|
<DT id="14"><B>shlibs:</B><I>champ-dépendance</I><DD>
|
|
Les variables déterminées de cette façon sont produites par
|
|
<B>dpkg-shlibdeps</B>.
|
|
<DT id="15"><B>dpkg:Upstream-Version</B><DD>
|
|
La version amont de dpkg (depuis dpkg 1.13.19).
|
|
<DT id="16"><B>dpkg:Version</B><DD>
|
|
La version complète de dpkg (depuis dpkg 1.13.19).
|
|
</DL>
|
|
<P>
|
|
|
|
Quand une variable est référencée mais n'est pas définie, cela produit un
|
|
avertissement et une valeur vide est supposée.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>FICHIERS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="17"><B>debian/substvars</B><DD>
|
|
La liste des variables de substitution et leurs valeurs.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>VOIR AUSSI</H2>
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg">dpkg</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-genchanges">dpkg-genchanges</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-gencontrol">dpkg-gencontrol</A></B>(1),
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-shlibdeps">dpkg-shlibdeps</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-source">dpkg-source</A></B>(1).
|
|
<A NAME="lbAG"> </A>
|
|
<H2>TRADUCTION</H2>
|
|
|
|
Ariel VARDI <<A HREF="mailto:ariel.vardi@freesbee.fr">ariel.vardi@freesbee.fr</A>>, 2002.
|
|
Philippe Batailler, 2006.
|
|
Nicolas François, 2006.
|
|
Veuillez signaler toute erreur à <<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="18"><A HREF="#lbAB">NOM</A><DD>
|
|
<DT id="19"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="20"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="21"><A HREF="#lbAE">FICHIERS</A><DD>
|
|
<DT id="22"><A HREF="#lbAF">VOIR AUSSI</A><DD>
|
|
<DT id="23"><A HREF="#lbAG">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:02 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|