Provided by: dpkg-dev_1.22.18ubuntu3_all 
NOM
deb-substvars - Variables de substitution de source Debian
SYNOPSIS
debian/substvars, debian/paquet-binaire.substvars, variables
DESCRIPTION
Avant que dpkg-source, dpkg-gencontrol et dpkg-genchanges n'écrivent leurs informations de contrôle (dans
le fichier source de contrôle .dsc pour dpkg-source et sur la sortie standard pour dpkg-gencontrol et
dpkg-genchanges), ils réalisent quelques substitutions de variables dans le fichier de sortie.
Syntaxe des variables
Une substitution de variable est de la forme : ${nom-variable}. 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.
Syntaxe des fichiers
Substitution variables can be specified in a file. These files consist of lines of the form name=value,
name?=value, or name!=value. The = operator assigns a normal substitution variable, the ?= operator
(since dpkg 1.21.8) assigns an optional substitution variable which will emit no warnings even if unused,
and the != operator (since dpkg 1.22.7) assigns a required substitution variable which will error out if
unused. Trailing whitespace on each line, blank lines, and lines starting with a # symbol (comments) are
ignored.
Substitution
On peut définir les variables en utilisant l'option commune -V. On peut aussi se servir du fichier
debian/substvars (ou tout autre fichier avec l'option commune -T).
Quand toutes les substitutions ont été faites, chaque occurrence de la chaîne ${} (laquelle n'est pas une
variable de substitution réelle) est remplacée par un signe $. Cela peut être utilisé comme une séquence
d'échappement telle que ${}{VARIABLE} qui finira sous la forme ${VARIABLE} sur la sortie.
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.
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
Package, Source et Architecture.
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 ${Description} est positionnée sur « toto est truc.${Newline}toto est super. » et si vous
avez le champ suivant :
Description: application toto
${Description}
.
Encore du texte.
Le résultat final sera :
Description: application toto
toto est truc.
toto est super.
.
Encore du texte.
Variables internes
En outre, les variables standard suivantes sont toujours disponibles :
Arch
L'architecture de l'hôte actuel (c'est-à-dire l'architecture pour laquelle le paquet est construit,
équivalent de DEB_HOST_ARCH).
vendor:Nom
The current vendor name (since dpkg 1.20.0). This value comes from the Vendor field for the current
vendor's origin file, as dpkg-vendor(1) would retrieve it.
vendor:Id
L'identifiant du fabricant actuel (depuis dpkg 1.20.0). C'est simplement la variante en bas de casse
de vendor:Name.
source:Version
Version du paquet source (depuis dpkg 1.13.19).
source:Upstream-Version
La version amont du paquet source, avec éventuellement l'« epoch » de la version Debian (depuis
dpkg 1.13.19).
binary:Version
La version du paquet binaire (qui peut être différente de source:Version dans un binNMU par exemple ;
depuis dpkg 1.13.19).
Source-Version
La version du paquet source, selon le fichier changelog. Cette variable est maintenant obsolète et
produit une erreur lors de son utilisation, car sa signification est distincte de sa fonction.
Utilisez plutôt source:Version ou binary:Version.
source:Synopsis
Le synopsis du paquet source, extrait du champ Description du paragraphe source, s'il existe (depuis
dpkg 1.19.0).
source:Extended-Description
La description étendue du paquet source, extraite du champ Description du paragraphe source, s'il
existe (depuis dpkg 1.19.0).
Installed-Size
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, dpkg-gencontrol 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, les liens physiques étant
comptés une seule fois comme des fichiers ordinaires.
Note: Take into account that this can only ever be an approximation, as the actual size used on the
installed system will depend greatly on the filesystem used and its parameters, which might end up
using either more or less space than the specified in this field.
Extra-Size
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 Installed-Size (qu'elle soit définie explicitement ou
calculée par défaut) avant qu'elle soit copiée dans le champ Installed-Size du fichier « control ».
S:field-name
The value of the source stanza field field-name (which must be given in the canonical capitalization;
since dpkg 1.18.11). Setting these variables has no effect other than on places where they are
expanded explicitly. These variables are only available when generating binary control files.
F:field-name
The value of the output field field-name (which must be given in the canonical capitalization).
Setting these variables has no effect other than on places where they are expanded explicitly.
Format
La version du format du fichier .changes produite par la version des scripts construisant le source.
Quand on détermine cette variable, le contenu du champ Format dans le fichier .changes est aussi
modifié.
Newline, Space, Tab
Ces variables contiennent chacune le caractère correspondant.
shlibs:champ-dépendance
Les variables déterminées de cette façon sont produites par dpkg-shlibdeps.
dpkg:Upstream-Version
La version amont de dpkg (depuis dpkg 1.13.19).
dpkg:Version
La version complète de dpkg (depuis dpkg 1.13.19).
FICHIERS
debian/substvars
La liste des variables de substitution et leurs valeurs.
VOIR AUSSI
dpkg(1), dpkg-vendor(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-shlibdeps(1), dpkg-source(1).
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez
signaler toute erreur à <debian-l10n-french@lists.debian.org>.
1.22.18 2025-04-28 deb-substvars(5)