NOM
deb-version - Format du numéro de version des paquets Debian
SYNOPSIS
[ epoch:] version_amont [-rvision_debian ]
Les numros de version utiliss 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 ne doit pas contenir de caractre
deux-points.
Cette valeur est destine permettre de grer des erreurs dans les
anciens numros de version d'un paquet ou un changement dans la
mthode de numrotation des versions amont.
upstream_version
Ceci est la partie principale du numro de version. Cela
correspond normalement au numro de version du paquet d'origine
qui a servi crer le fichier .deb. Le format d'origine spcifi
par l'auteur est gnralement conserv ; cependant, il arrive qu'il
soit ncessaire d'adapter ce numro pour qu'il se conforme au
format du systme de gestion de paquet et du procd de comparaison
des numros de version.
Le principe de comparaison du systme de gestion de paquet en ce
qui concerne la version_amont est dcrite ci-dessous. La partie
version_amont du numro est obligatoire.
La version_amont ne doit contenir que des caractres
alphanumriques ("A-Za-z0-9") et les caratres suivants (".+-:~").
Et devrait commencer par un chiffre. S'il n'y a pas de partie
revision_Debian alors le caractre tilde ("~") n'est pas
autoris ; si il n'y a pas de epoch, alors c'est le caractre
("deux points, :") qui n'est pas autoriss.
debian_revision
Cette partie du numro de version indique la version du paquet
Debian partir du numro de la version amont. Elle ne doit
contenir que des symboles alphanumriques ("A-Za-z0-9") et les
trois caractres (".+~"). Elle est analyse de la mme faon que la
version_amont.
Cette partie est facultative ; si elle n'est pas prsent alors
c'est que la version_amont ne doit pas contenir de signe moins
("-"). Ce format est pour le cas o un logiciel a t directement
conu comme paquet Debian, il y a donc qu'une seule
debianisation et donc par suite pas besoin d'indication de
rvision.
Il est convenu de repartir '1' pour la rvision_debian chaque
fois que la version_amont est incrmente.
Dpkg s'arrtera au dernier signe moins ("-") du numro de version
(s'il y en a un) pour dterminer la partie version_amont et la
version_Debian. L'absence de revision_Debian est compare avant
sa prsence, mais notez que la revision_Debian est partie la
moins significative du numro de version.
Algorithme de classement
Les parties version_amont et revision_Debian sont compares par le
systme de gestion de paquet en utilisant le mme algorithme :
Les chanes sont compares de la gauche vers la droite.
Pour commencer, la premire partie de chaque chane compose uniquement de
caractres non numriques est dtermine. Puis ces deux parties (l'une peut
tre vide) sont compares lexicalement. Si une diffrence est trouve, elle
est retourne. La comparaison lexicale est effectue sur une version
modifie des valeurs ASCII afin que les lettres passent avant les autres
caractres et que les tildes ("~") passent avant tout tous les
caractres, mme la fin d'une partie. Par exemple, les lments suivants
sont ordonns ainsi : ~~ , ~~a , ~ , partie vide, a .
Puis, le dbut de ce qui reste des chanes de caractres qui ne doivent
plus contenir que des chiffres est dtermin. Ces valeurs numriques sont
compares, et les diffrences sont remontes. Dans le cas d'une chane vide
(ce qui peut arriver si une chane est plus longue que l'autre lors de
la comparaison) elle compte pour un zro.
Ces deux tapes (comparaison et suppression des caractres non numriques
puis de suppression des caractres numriques dans le dbut de la chane)
sont rptes jusqu' ce qu'une diffrence soit trouve ou la fin des chanes
atteinte.
Notez que le rle de epoch est de permettre de se sortir de problmes de
numrotation de version, et de faire face des situations de changement
de logique de numrotation. Cela n'est pas destin faire face des
numros de version qui contiennent des chanes de lettres que le systme
de gestion de paquet ne sait pas interprter (comme ALPHA , pre- )ou
d'autres choses stupides.
CAVEATS
Le caractre tilde ( ~ ) et sa proprit spciale pour les comparaisons ont
t introduites dans la version 1.10 de dpkg. Ce n'est qu'a partir des
versions suprieures (1.10.x) que certaines parties de dpkg-dev ont
commenc
grer ce systme.
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 suprieure pour le copyright. Il n'y a PAS de
garantie.
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006.
Nicolas Franois, 2006. Veuillez signaler toute erreur
<debian-l10n-french@lists.debian.org>.