NOM

       deb-substvars - Variables de substitution de source Debian

SYNOPSIS

       debian/substvars, debian/binary-package.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.

       After all the substitutions have been done each occurrence of the string ${} (which is not a legal
       substitution) is replaced with a $ sign. This can be used as an escape sequence such as ${}{VARIABLE}
       which will end up as ${VARIABLE} on the output.

       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: foo application
         ${Description}
         .
         More text.

       Le résultat final sera :

        Description: foo application
         foo is bar.
         foo is great.
         .
         More text.

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

       vendor:Name
           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
           The current vendor ID (since dpkg 1.20.0). This is just the lowercase variant of 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
           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. With hardlinks only being counted once as a regular file.

           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-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.21.1                                             2024-02-23                                   deb-substvars(5)