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

1.19.7                                             2022-05-25                                     deb-version(7)