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,  traits  d'union  et  « deux  points » ;  ils
       commencent par une lettre ou un chiffre. 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 contexte 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   The current host architecture (i.e. the architecture the  package  is  being  built
              for, the equivalent of DEB_HOST_ARCH).

       source:Version
              La version du paquet source.

       source:Upstream-Version
              La  version  amont  du paquet source, avec éventuellement l'« epoch » de la version
              debian.

       binary:Version
              La version du paquet binaire (qui peut être différente de  source:Version  dans  un
              binNMU par exemple).

       Source-Version
              La  version  du  paquet  source,  selon  le  fichier  changelog. Cette variable est
              maintenant déconseillée car sa signification est distincte de sa fonction. Utilisez
              plutôt source:Version ou binary:Version.

       Installed-Size
              The  approximate  total size of the package's installed files. This value is copied
              into the corresponding control file field; setting it will modify the value of that
              field.  If  this variable is not set dpkg-gencontrol will compute the default value
              by accumulating the size of each regular file and symlink rounded  to  1  KiB  used
              units, and a baseline of 1 KiB for any other filesystem object type.

              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 que  la  variable
              Installed-Size ne soit copiée dans le champ du fichier « control ».

       F:fieldname
              La  valeur  du  champ fieldname affiché en sortie et qui doit être classiquement en
              majuscules. Quand on fixe ces variables, cela ne prend effet que là où  elles  sont
              effectivement 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:dependencyfield
              Les variables déterminées de cette façon sont produites par dpkg-shlibdeps.

       dpkg:Upstream-Version
              La version amont de dpkg.

       dpkg:Version
              La version complète de dpkg.

       Quand une variable est référencée mais n'est pas définie, cela produit un avertissement et
       une valeur nulle 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>.