NOM
deb-substvars - Variables de substitution de source Debian
SYNOPSIS
substvars
Avant que dpkg-source, dpkg-gencontrol et dpkg-genchanges n'crivent
leurs informations de contrle (dans le fichier source de contrle .dsc
pour dpkg-source et sur la sortie standard pour dpkg-gencontrol et
dpkg-genchanges), ils ralisent quelques substitutions de variables dans
le fichier de sortie.
Une substitution de variable est de la forme : ${nom-variable}. Les
noms de variable consistent en caractres alphanumriques, traits d'union
et deux points ; ils commencent par une lettre ou un chiffre. La
substitution se fait rptitivement jusqu' ce qu'il n'en reste aucune
faire ; le texte entier du champ aprs la substitution est rexamin pour
chercher d'autres substitutions.
Quand toutes les substitutions ont t faites, chaque occurrence de la
chane ${} (laquelle n'est pas une substitution autorise) est remplace
par un signe $.
Lorsque le remplacement de variables est effectu sur tous les champs de
contrle, certains de ces champs sont utiliss et ncessaires pendant la
constructions alors mme que la substitution n'a pas encore pu tre
effectue. Cela explique pourquoi il n'est pas possible d'utiliser de
variables dans les champs Package, Source et Architecture.
Variable substitution happens on the content of the fields after they
have been parsed, thus if you want a variable to expand over multiple
lines you do not have to include a space after the newline. This is
done implicitly when the field is output. For example, if the variable
${Description} is set to "foo is bar.${Newline}foo is great." and if
you have the following field:
Description: foo application
${Description}
.
More text.
It will result in:
Description: foo application
foo is bar.
foo is great.
.
More text.
On peut dfinir les variables en utilisant l'option commune -V. On peut
aussi se servir du fichier debian/substvars (ou tout autre fichier avec
l'option -T). Ce fichier est compos de lignes de la forme suivante :
nom=valeur. Les espaces rsiduels sur chaque ligne, les lignes vides et
les lignes qui commencent par un symbole # sont ignors.
En outre, les variables standard suivantes sont disponibles :
Arch L'architecture pour laquelle on construit (tire de dpkg
--print-architecture).
source:Version
La version du paquet source.
source:Upstream-Version
La version amont du paquet source, avec ventuellement l' epoch
de la version debian.
binary:Version
La version du paquet binaire (qui peut tre diffrente de
source:Version dans un binNMU par exemple).
Source-Version
La version du paquet source, selon le fichier changelog. Cette
variable est maintenant dconseille car sa signification est
distincte de sa fonction. Utilisez plutt source:Version ou
binary:Version.
Installed-Size
La taille de tous les fichiers installs du paquet. Cette valeur
est copie dans le champ adquat du fichier control ; Quand on
fixe cette variable, cela modifie la valeur de ce champ. Quand
elle est indtermine, dpkg-gencontrol use de la commande du -k
debian/tmp pour trouver une valeur par dfaut.
Extra-Size
L'espace disque supplmentaire utilis pour l'installation du
paquet. Quand on fixe cette variable, on ajoute sa valeur la
valeur de la variable Installed-Size (qu'elle soit dfinie
explicitement ou calcule par dfaut) avant que la variable
Installed-Size ne soit copie dans le champ du fichier control .
F:fieldname
La valeur du champ fieldname affich en sortie et qui doit tre
classiquement en majuscules. Quand on fixe ces variables, cela
ne prend effet que l o elles sont effectivement dveloppes.
Format La version du format du fichier .changes produite par la version
des scripts construisant le source. Quand on dtermine cette
variable, le contenu du champ Format dans le fichier .changes
est aussi modifi.
Newline, Space, Tab
Ces variables contiennent chacune le caractre correspondant.
shlibs:dependencyfield
Les variables dtermines de cette faon sont produites par
dpkg-shlibdeps.
dpkg:Upstream-Version
La version amont de dpkg.
dpkg:Version
La version complte de dpkg.
Quand une variable est rfrence mais n'est pas dfinie, cela produit un
avertissement et une valeur nulle est assume.
FICHIERS
debian/substvars
La liste des variables de substitution et leurs valeurs.
BOGUES
Le moment o a lieu le remplacement d'un champ par rapport certaines
dterminations de champ affiches sur la sortie standard est plutt
embrouill.
VOIR AUSSI
dpkg(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-shlibdeps(1),
dpkg-source(1).
AUTEUR
Copyright (C) 1995-1996 Ian Jackson
Copyright (C) 2000 Wichert Akkerman
Ce programme est un logiciel libre ; voyez la GNU General Public
Licence version 2 ou suprieure pour le copyright. Il n'y a PAS de
garantie.
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006.
Nicolas Franois, 2006. Veuillez signaler toute erreur
<debian-l10n-french@lists.debian.org>.