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

This is the main part of the version number. It is usually the version number of the original ("upstream") package from which the .deb file has been made, if this is applicable. Usually this will be in the same format as that specified by the upstream author(s); however, it may need to be reformatted to fit into the package management system's format and comparison scheme.

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.

The upstream-version may contain only alphanumerics ("A-Za-z0-9") and the characters . + - : ~ (full stop, plus, hyphen, colon, tilde) and should start with a digit. If there is no debian-revision then hyphens are not allowed; if there is no epoch then colons are not allowed.

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.

It is optional; if it isn't present then the upstream-version may not contain a hyphen. This format represents the case where a piece of software was written specifically to be turned into a Debian package, and so there is only one "debianisation" of it and therefore no revision indication is required.

It is conventional to restart the debian-revision at '1' each time time the upstream-version is increased.

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.

First the initial part of each string consisting entirely of non-digit characters is determined. These two parts (one of which may be empty) are compared lexically. If a difference is found it is returned. The lexical comparison is a comparison of ASCII values modified so that all the letters sort earlier than all the non-letters and so that a tilde sorts before anything, even the end of a part. For example, the following parts are in sorted order: '~~', '~~a', '~', the empty part, '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.

Note that the purpose of epochs is to allow us to leave behind mistakes in version numbering, and to cope with situations where the version numbering scheme changes. It is not intended to cope with version numbers containing strings of letters which the package management system cannot interpret (such as 'ALPHA' or 'pre-'), or with silly orderings.

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.

TRADUCTION

Ariel VARDI <[email protected]>, 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez signaler toute erreur à <[email protected]>.