Provided by: dpkg-dev_1.19.7ubuntu2_all bug

NOM

       deb-substvars - Variables de substitution de source Debian

SYNOPSIS

       substvars

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.

       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.

       Quand  toutes  les  substitutions  ont  été  faites,  chaque  occurrence  de la chaîne ${}
       (laquelle n'est pas une substitution autorisée) est remplacée par un signe $.

       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  « foo  est  bar.${Newline}foo  est  super. »  et  si  vous avez le champ
       suivant :

        Description: application foo
         ${Description}
         .
         Encore du texte.

       Le résultat final sera :

        Description: application foo
         foo est bar.
         foo est super.
         .
         Encore du texte.

       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 -T). Ce fichier est composé
       de lignes de la forme suivante : nom=valeur. Les espaces résiduelles sur chaque ligne, les
       lignes vides et les lignes qui commencent par un symbole # sont ignorées.

       En outre, les variables standard suivantes sont 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).

       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.

              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.

       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:nom-de-champ
              La  valeur  du champ nom-de-champ 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.

       F:nom-de-champ
              La valeur du champ 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.

       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).

       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.

FICHIERS

       debian/substvars
              La liste des variables de substitution et leurs valeurs.

VOIR AUSSI

       dpkg(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>.