Provided by: dpkg-dev_1.16.0.3ubuntu5_all bug

NOM

       deb-version - Format du numero de version des paquets Debian

SYNOPSIS

       [ epoch:] version_amont [-r'evision_debian ]

DESCRIPTION

       Les numeros de version utilises 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
              etre omis (dans ce cas, la valeur nulle est implicite). S'il est
              omis,  la  version_amont  ne  doit  pas  contenir  de  caractere
              deux-points.

              Cette  valeur est destinee a permettre de gerer des erreurs dans
              les anciens numeros de version d'un paquet ou un changement dans
              la methode de numerotation des versions amont.

       upstream_version
              Ceci  est  la  partie  principale  du  numero  de  version. Cela
              correspond normalement au numero de version du paquet  d'origine
              qui  a  servi  a  creer  le  fichier  .deb.  Le format d'origine
              specifie par l'auteur est generalement conserve ; cependant,  il
              arrive  qu'il  soit necessaire d'adapter ce numero pour qu'il se
              conforme au format du systeme de gestion de paquet et du procede
              de comparaison des numeros de version.

              Le principe de comparaison du systeme de gestion de paquet en ce
              qui concerne la version_amont est decrite ci-dessous. La  partie
              version_amont du numero est obligatoire.

              La   version_amont   ne   doit   contenir   que  des  caracteres
              alphanumeriques  ("A-Za-z0-9")   et   les   carateres   suivants
              (".+-:~").  Et  devrait commencer par un chiffre. S'il n'y a pas
              de partie revision_Debian alors le caractere tilde  ("~")  n'est
              pas  autorise ;  si  il  n'y  a  pas  de  epoch,  alors c'est le
              caractere ("deux points, :") qui n'est pas autorises.

       debian_revision
              Cette partie du numero de version indique la version  du  paquet
              Debian  a  partir  du  numero  de la version amont. Elle ne doit
              contenir que des symboles alphanumeriques ("A-Za-z0-9")  et  les
              trois caracteres (".+~"). Elle est analysee de la meme facon que
              la version_amont.

              Cette partie est facultative ; si elle n'est pas  present  alors
              c'est  que  la version_amont ne doit pas contenir de signe moins
              ("-").  Ce  format  est  pour  le  cas  ou  un  logiciel  a  ete
              directement  concu comme paquet Debian, il y a donc qu'une seule
              << debianisation >> et donc par suite pas besoin d'indication de
              revision.

              Il  est  convenu  de  repartir  a  '1' pour la r'evision_debian a
              chaque fois que la version_amont est incrementee.

              Dpkg s'arretera au  dernier  signe  moins  ("-")  du  numero  de
              version (s'il y en a un) pour determiner la partie version_amont
              et la version_Debian. L'absence de revision_Debian est  comparee
              avant  sa presence, mais notez que la revision_Debian est partie
              la moins significative du numero de version.

   Algorithme de classement
       Les parties version_amont et  revision_Debian  sont  comparees  par  le
       systeme de gestion de paquet en utilisant le meme algorithme :

       Les chaines sont comparees de la gauche vers la droite.

       Pour commencer, la premiere partie de chaque chaine composee uniquement
       de caracteres non numeriques est  determinee.  Puis  ces  deux  parties
       (l'une  peut  etre vide) sont comparees lexicalement. Si une difference
       est trouvee, elle est retournee. La comparaison lexicale est  effectuee
       sur une version modifiee des valeurs ASCII afin que les lettres passent
       avant les autres caracteres et que les tildes ("~") passent avant  tout
       tous  les  caracteres,  meme  la  fin  d'une  partie.  Par exemple, les
       elements suivants sont ordonnes ainsi : << ~~ >>,  << ~~a >>,  << ~ >>,
       partie vide, << a >>.

       Puis, le debut de ce qui reste des chaines de caracteres qui ne doivent
       plus contenir que des chiffres est determine.  Ces  valeurs  numeriques
       sont  comparees,  et  les differences sont remontees. Dans le cas d'une
       chaine vide (ce qui peut arriver si une  chaine  est  plus  longue  que
       l'autre lors de la comparaison) elle compte pour un zero.

       Ces   deux  etapes  (comparaison  et  suppression  des  caracteres  non
       numeriques puis de suppression des caracteres numeriques dans le  debut
       de  la  chaine) sont repetees jusqu'a ce qu'une difference soit trouvee
       ou la fin des chaines atteinte.

       Notez que le role de epoch est de permettre de se sortir  de  problemes
       de  numerotation  de  version,  et  de  faire  face a des situations de
       changement de logique de numerotation. Cela n'est pas destine  a  faire
       face  a  des  numeros de version qui contiennent des chaines de lettres
       que le systeme de gestion de paquet  ne  sait  pas  interpreter  (comme
       << ALPHA >>, << pre- >>)ou d'autres choses stupides.

CAVEATS

       Le  caractere  tilde  (<< ~ >>)  et  sa  propriete  speciale  pour  les
       comparaisons ont ete introduites dans la version 1.10 de dpkg. Ce n'est
       qu'a  partir des versions superieures (1.10.x) que certaines parties de
       dpkg-dev ont commence a gerer ce systeme.

VOIR AUSSI

       deb-control(5), deb(5), dpkg(1).

AUTEURS

       Copyright (C) 1996,1997,1998 Ian Jackson et Christian Schwarz
       Copyright (C) 2007 Frank Lichtenheld

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