NOM

       deb-version - Format du numéro de version des paquets Debian

SYNOPSIS

       [epoch:]version_amont[-révision_debian]

DESCRIPTION

       Les numéros de version utilisés pour les paquets sources et binaires se composent de trois
       parties. Celles-ci sont :

       epoch  Ce nombre est un entier positif (usuellement petit). Il peut  être  omis  (dans  ce
              cas,  la  valeur  nulle est implicite). S'il est omis, la version_amont peut ne pas
              contenir de caractère deux-points.

              Cette valeur est destinée à permettre de gérer des erreurs dans les anciens numéros
              de  version  d'un  paquet  ou  un  changement  dans  la méthode de numérotation des
              versions amont.

       version_amont
              Cela est la partie principale du numéro de version. Cela correspond normalement  au
              numéro de version du paquet d'origine (« upstream ») qui a servi à créer le fichier
              .deb, si cela peut s'appliquer. Le  format  d'origine  spécifié  par  l'auteur  est
              généralement  conservé ;  cependant,  il  arrive qu'il soit nécessaire d'adapter ce
              numéro pour qu'il se conforme au format du système  de  gestion  de  paquet  et  du
              procédé de comparaison des numéros de version.

              Le  principe  de comparaison du système de gestion de paquets en ce qui concerne la
              version_amont est décrit ci-dessous. La partie version_amont du numéro  de  version
              est obligatoire.

              La   version_amont   ne   doit   contenir   que   des   caractères  alphanumériques
              (« A-Za-z0-9 ») et les caractères . + -  :  ~  (point,  plus,  tiret,  deux-points,
              tilde)   et   devrait   commencer  par  un  chiffre.  S'il  n'y  a  pas  de  partie
              révision_Debian alors le tiret n'est pas autorisé ; s'il n'y a pas  d'epoch,  alors
              c'est le caractère deux-points qui n'est pas autorisé.

       révision_Debian
              Cette  partie  du numéro de version indique la version du paquet Debian à partir du
              numéro de la version amont. Elle ne doit contenir que des symboles  alphanumériques
              et  les  caractères  + . ~ (plus, point, tilde). Elle est analysée de la même façon
              que la version_amont.

              Cette partie est facultative ; si elle n'est pas présente, la version_amont ne doit
              pas  contenir  de  tiret.  Ce  format  est  prévu  pour le cas où un logiciel a été
              directement conçu comme paquet Debian, il n'y a donc qu'une seule « debianisation »
              et donc par la suite pas besoin d'indication de révision.

              Il  est  convenu  de  repartir à « 1 » pour la révision_Debian à chaque fois que la
              version_amont est incrémentée.

              Dpkg s'arrêtera au dernier tiret du numéro  de  version  (s'il  y  en  a  un)  pour
              déterminer   la   partie   version_amont   et   la  révision_Debian.  L'absence  de
              révision_Debian est  comparée  avant  sa  présence,  mais  il  faut  noter  que  la
              révision_Debian est la partie la moins significative du numéro de version.

   Algorithme de tri
       Les  parties  version_amont et révision_Debian sont comparées par le système de gestion de
       paquet en utilisant le même algorithme :

       Les chaînes sont comparées de la gauche vers la droite.

       Pour commencer, la première partie de chaque chaîne composée uniquement de caractères  non
       numériques  est  déterminée.  Puis  ces deux parties (l'une peut être vide) sont comparées
       lexicalement. Si une différence est trouvée, elle est renvoyée.  La  comparaison  lexicale
       est  effectuée  sur  une  version  modifiée des valeurs ASCII afin que les lettres passent
       avant les autres caractères et que les tildes ("~") passent  avant  tous  les  caractères,
       même la fin d'une partie. Par exemple, les éléments suivants sont ordonnés ainsi : « ~~ »,
       « ~~a », « ~ », partie vide, « a ».

       Puis, le début de ce qui reste des chaînes de caractères qui ne doivent plus contenir  que
       des  chiffres est déterminé. Ces valeurs numériques sont comparées et les différences sont
       remontées. Dans le cas d'une chaîne vide (ce qui peut  arriver  si  une  chaîne  est  plus
       longue que l'autre lors de la comparaison) elle compte pour un zéro.

       Ces  deux  étapes  (comparaison  et  suppression  des  caractères  non  numériques puis de
       suppression des caractères numériques dans le début de la chaîne) sont répétées jusqu'à ce
       qu'une différence soit trouvée ou la fin des chaînes atteinte.

       Notez  que le rôle de epoch est de permettre de se sortir des problèmes de numérotation de
       version, et de faire face à des situations de changement de logique de numérotation.  Cela
       n'est  pas  destiné  à  faire face à des numéros de version qui contiennent des chaînes de
       lettres que le système de gestion de paquet ne  sait  pas  interpréter  (comme  « ALPHA »,
       « pre- ») ou d'autres choses stupides.

NOTES

       Le  caractère  tilde  (« ~ »)  et  sa  propriété  spéciale  pour  les comparaisons ont été
       introduites dans la version 1.10 de dpkg. Ce n'est qu'à partir  des  versions  supérieures
       (1.10.x) que certaines parties des scripts de construction de dpkg ont commencé à gérer ce
       système.

VOIR AUSSI

       deb-control(5), deb(5), dpkg(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>.