Provided by: dpkg-dev_1.16.0.3ubuntu5_all bug

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