1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
*****************************************************
* GENERATED FILE, DO NOT EDIT *
* THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
*****************************************************
This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.
In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.
=encoding UTF-8
=head1 NOM
deb-substvars - Variables de substitution de source Debian
=head1 SYNOPSIS
B<debian/substvars>, B<debian/>I<paquet-binaire>B<.substvars>, variables
=head1 DESCRIPTION
Avant que B<dpkg-source>, B<dpkg-gencontrol> et B<dpkg-genchanges> n'écrivent leurs informations de contrôle (dans le fichier source de contrôle B<.dsc> pour B<dpkg-source> et sur la sortie standard pour B<dpkg-gencontrol> et B<dpkg-genchanges>), ils réalisent quelques substitutions de variables dans le fichier de sortie.
=head2 Syntaxe des variables
Une substitution de variable est de la S<forme :> B<${>I<nom-variable>B<}>. Les noms de variable consistent en caractères alphanumériques (a-zA-Z0-9), traits d'union (-) et S<« deux> S<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.
=head2 Syntaxe des fichiers
Les variables de substitution peuvent être spécifiées dans un fichier. Ces fichiers consistent en lignes de forme I<nom>B<=>I<valeur> ou I<nom>B<?=>I<valeur>. L'opérateur B<=> assigne une variable de substitution normale, alors que l'opérateur B<?=> (depuis S<dpkg 1.21.8)> assigne une variable de substitution optionnelle qui n'émettra pas d'avertissement même si elle n'est pas utilisée. Les espaces vides à la fin de chaque ligne, les lignes vides et les lignes commençant par le symbole B<#> (les commentaires) sont ignorés.
=head2 Substitution
On peut définir les variables en utilisant l'option commune B<-V>. On peut aussi se servir du fichier B<debian/substvars> (ou tout autre fichier avec l'option commune B<-T>).
Quand toutes les substitutions ont été faites, chaque occurrence de la chaîne B<${}> (laquelle n'est pas une variable de substitution réelle) est remplacée par un signe B<$>. Cela peut être utilisé comme une séquence d'échappement telle que B<${}{>I<VARIABLE>B<}> qui finira sous la forme B<${>I<VARIABLE>B<}> 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 B<Package>, B<Source> et B<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 B<${Description}> est positionnée sur S<« toto> est truc.${Newline}toto est S<super. »> et si vous avez le champ S<suivant :>
Description: application toto
${Description}
.
Encore du texte.
Le résultat final S<sera :>
Description: application toto
toto est truc.
toto est super.
.
Encore du texte.
=head2 Variables internes
En outre, les variables standard suivantes sont toujours S<disponibles :>
=over
=item B<Arch>
L'architecture de l'hôte actuel (c'est-à-dire l'architecture pour laquelle le paquet est construit, équivalent de B<DEB_HOST_ARCH>).
=item B<vendor:Nom>
Le nom du fabriquant actuel (depuis S<dpkg 1.20.0).> Cette valeur vient du champ B<Vendor> du fichier d'origine du fabricant actuel, comme B<dpkg-vendor>(1) pourrait le récupérer.
=item B<vendor:Id>
L'identifiant du fabricant actuel (depuis S<dpkg 1.20.0).> C'est simplement la variante en bas de casse de B<vendor:Name>.
=item B<source:Version>
Version du paquet source (depuis S<dpkg 1.13.19).>
=item B<source:Upstream-Version>
La version amont du paquet source, avec éventuellement S<l'« epoch »> de la version Debian (depuis S<dpkg 1.13.19).>
=item B<binary:Version>
La version du paquet binaire (qui peut être différente de B<source:Version> dans un binNMU par exemple ; depuis S<dpkg 1.13.19).>
=item B<Source-Version>
La version du paquet source, selon le fichier changelog. Cette variable est maintenant B<obsolète> et produit une erreur lors de son utilisation, car sa signification est distincte de sa fonction. Utilisez plutôt B<source:Version> ou B<binary:Version>.
=item B<source:Synopsis>
Le synopsis du paquet source, extrait du champ B<Description> du paragraphe source, s'il existe (depuis S<dpkg 1.19.0).>
=item B<source:Extended-Description>
La description étendue du paquet source, extraite du champ B<Description> du paragraphe source, s'il existe (depuis S<dpkg 1.19.0).>
=item B<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 S<« control »> ; quand on fixe cette variable, cela modifie la valeur de ce champ. Quand elle est indéterminée, B<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.
S<B<Remarque> :> 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.
=item B<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 B<Installed-Size> (qu'elle soit définie explicitement ou calculée par défaut) avant qu'elle soit copiée dans le champ B<Installed-Size> du fichier S<« control ».>
=item B<S:>I<nom-de-champ>
La valeur du champ I<nom-de-champ> du paragraphe source (qui doit être classiquement en majuscules, depuis S<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.
=item B<F:>I<nom-de-champ>
La valeur du champ I<nom-de-champ> 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.
=item B<Format>
La version du format du fichier B<.changes> produite par la version des scripts construisant le source. Quand on détermine cette variable, le contenu du champ B<Format> dans le fichier B<.changes> est aussi modifié.
=item B<Newline>, B<Space>, B<Tab>
Ces variables contiennent chacune le caractère correspondant.
=item B<shlibs:>I<champ-dépendance>
Les variables déterminées de cette façon sont produites par B<dpkg-shlibdeps>.
=item B<dpkg:Upstream-Version>
La version amont de dpkg (depuis S<dpkg 1.13.19).>
=item B<dpkg:Version>
La version complète de dpkg (depuis S<dpkg 1.13.19).>
=back
=head1 FICHIERS
=over
=item B<debian/substvars>
La liste des variables de substitution et leurs valeurs.
=back
=head1 VOIR AUSSI
B<dpkg>(1), B<dpkg-vendor>(1), B<dpkg-genchanges>(1), B<dpkg-gencontrol>(1), B<dpkg-shlibdeps>(1), B<dpkg-source>(1).
=head1 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>.
|
