Provided by:
dpkg-dev_1.16.0.3ubuntu5_all 
NOM
deb-substvars - Variables de substitution de source Debian
SYNOPSIS
substvars
DESCRIPTION
Avant que dpkg-source, dpkg-gencontrol et dpkg-genchanges n'ecrivent
leurs informations de controle (dans le fichier source de controle .dsc
pour dpkg-source et sur la sortie standard pour dpkg-gencontrol et
dpkg-genchanges), ils realisent 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 caracteres alphanumeriques, traits
d'union et << deux points >> ; ils commencent par une lettre ou un
chiffre. La substitution se fait repetitivement jusqu'a ce qu'il n'en
reste aucune a faire ; le texte entier du champ apres la substitution
est reexamine pour chercher d'autres substitutions.
Quand toutes les substitutions ont ete faites, chaque occurrence de la
chaine ${} (laquelle n'est pas une substitution autorisee) est
remplacee par un signe $.
Lorsque le remplacement de variables est effectue sur tous les champs
de controle, certains de ces champs sont utilises et necessaires
pendant la constructions alors meme que la substitution n'a pas encore
pu etre effectuee. Cela explique pourquoi il n'est pas possible
d'utiliser de variables dans les champs Package, Source et
Architecture.
La substitution de variables se fait dans le contexte des champs apres
leur analyse. En consequence, si vous souhaitez qu'une variable soit
remplacee sur plusieurs lignes, il n'est pas necessaire de placer un
espace apres le retour a la ligne. Cela se fait implicitement quand le
champ est affiche. Par exemple, si la variable ${Description} est
positionnee sur << foo est bar.${Newline}foo est super. >> et si vous
avez le champ suivant :
Description: application foo
${Description}
.
Encore du texte.
Le resultat final sera :
Description: application foo
foo est bar.
foo est super.
.
More text.
On peut definir 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 compose de lignes de la forme suivante :
nom=valeur. Les espaces residuels sur chaque ligne, les lignes vides et
les lignes qui commencent par un symbole # sont ignores.
En outre, les variables standard suivantes sont disponibles :
Arch L'architecture pour laquelle on construit (tiree de dpkg
--print-architecture).
source:Version
La version du paquet source.
source:Upstream-Version
La version amont du paquet source, avec eventuellement
l'<< epoch >> de la version debian.
binary:Version
La version du paquet binaire (qui peut etre differente de
source:Version dans un binNMU par exemple).
Source-Version
La version du paquet source, selon le fichier changelog. Cette
variable est maintenant d'econseill'ee car sa signification est
distincte de sa fonction. Utilisez plutot source:Version ou
binary:Version.
Installed-Size
La taille de tous les fichiers installes du paquet. Cette valeur
est copiee dans le champ adequat du fichier << control >> ;
Quand on fixe cette variable, cela modifie la valeur de ce
champ. Quand elle est indeterminee, dpkg-gencontrol use de la
commande du -k debian/tmp pour trouver une valeur par defaut.
Extra-Size
L'espace disque supplementaire utilise pour l'installation du
paquet. Quand on fixe cette variable, on ajoute sa valeur a la
valeur de la variable Installed-Size (qu'elle soit definie
explicitement ou calculee par defaut) avant que la variable
Installed-Size ne soit copiee dans le champ du fichier
<< control >>.
F:fieldname
La valeur du champ fieldname affiche en sortie et qui doit etre
classiquement en majuscules. Quand on fixe ces variables, cela
ne prend effet que la ou elles sont effectivement developpees.
Format La version du format du fichier .changes produite par la version
des scripts construisant le source. Quand on determine cette
variable, le contenu du champ Format dans le fichier .changes
est aussi modifie.
Newline, Space, Tab
Ces variables contiennent chacune le caractere correspondant.
shlibs:dependencyfield
Les variables determinees de cette facon sont produites par
dpkg-shlibdeps.
dpkg:Upstream-Version
La version amont de dpkg.
dpkg:Version
La version complete de dpkg.
Quand une variable est referencee mais n'est pas definie, cela produit
un avertissement et une valeur nulle est assumee.
FICHIERS
debian/substvars
La liste des variables de substitution et leurs valeurs.
BOGUES
Le moment ou a lieu le remplacement d'un champ par rapport a certaines
determinations de champ affichees sur la sortie standard est plutot
embrouille.
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 superieure pour le copyright. Il n'y a PAS de
garantie.
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006.
Nicolas Francois, 2006. Veuillez signaler toute erreur a
<debian-l10n-french@lists.debian.org>.