151 lines
7.7 KiB
HTML
151 lines
7.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of deb-version</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>deb-version</H1>
|
|
Section: suite dpkg (7)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOM</H2>
|
|
|
|
deb-version - Format du numéro de version des paquets Debian
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
[<I>epoch</I><B>:</B>]<I>version_amont</I>[<B>-</B><I>révision_debian</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Les numéros de version utilisés pour les paquets sources et binaires se
|
|
composent de trois parties. Celles-ci sont :
|
|
<DL COMPACT>
|
|
<DT id="1"><I>epoch</I><DD>
|
|
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 <I>version_amont</I>
|
|
peut ne pas contenir de caractère deux-points.
|
|
<DT id="2"><DD>
|
|
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.
|
|
<DT id="3"><I>version_amont</I><DD>
|
|
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 <I>.deb</I>, 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.
|
|
<DT id="4"><DD>
|
|
Le principe de comparaison du système de gestion de paquets en ce qui
|
|
concerne la <I>version_amont</I> est décrit ci-dessous. La partie
|
|
<I>version_amont</I> du numéro de version est obligatoire.
|
|
<DT id="5"><DD>
|
|
La <I>version_amont</I> ne doit contenir que des caractères alphanumériques
|
|
(« A-Za-z0-9 ») et les caractères <B>.</B> <B>+</B> <B>-</B> <B>:</B> <B>~</B> (point, plus,
|
|
tiret, deux-points, tilde) et devrait commencer par un chiffre. S'il n'y a
|
|
pas de partie <I>révision_Debian</I> alors le tiret n'est pas autorisé ; s'il
|
|
n'y a pas d'<I>epoch</I>, alors c'est le caractère deux-points qui n'est pas
|
|
autorisé.
|
|
<DT id="6"><I>révision_Debian</I><DD>
|
|
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 <B>+</B> <B>.</B> <B>~</B> (plus, point, tilde). Elle
|
|
est analysée de la même façon que la <I>version_amont</I>.
|
|
<DT id="7"><DD>
|
|
Cette partie est facultative ; si elle n'est pas présente, la
|
|
<I>version_amont</I> 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.
|
|
<DT id="8"><DD>
|
|
Il est convenu de repartir à « 1 » pour la <I>révision_Debian</I> à chaque fois
|
|
que la <I>version_amont</I> est incrémentée.
|
|
<DT id="9"><DD>
|
|
Dpkg s'arrêtera au dernier tiret du numéro de version (s'il y en a un) pour
|
|
déterminer la partie <I>version_amont</I> et la <I>révision_Debian</I>. L'absence de
|
|
<I>révision_Debian</I> est comparée avant sa présence, mais il faut noter que la
|
|
<I>révision_Debian</I> est la partie la moins significative du numéro de
|
|
version.
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H3>Algorithme de tri</H3>
|
|
|
|
Les parties <I>version_amont</I> et <I>révision_Debian</I> sont comparées par le
|
|
système de gestion de paquet en utilisant le même algorithme :
|
|
<P>
|
|
|
|
Les chaînes sont comparées de la gauche vers la droite.
|
|
<P>
|
|
|
|
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 ».
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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 <B>pas</B> 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.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
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.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>VOIR AUSSI</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-control">deb-control</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?5+deb">deb</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?1+dpkg">dpkg</A></B>(1).
|
|
<A NAME="lbAH"> </A>
|
|
<H2>TRADUCTION</H2>
|
|
|
|
Ariel VARDI <<A HREF="mailto:ariel.vardi@freesbee.fr">ariel.vardi@freesbee.fr</A>>, 2002.
|
|
Philippe Batailler, 2006.
|
|
Nicolas François, 2006.
|
|
Veuillez signaler toute erreur à <<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="10"><A HREF="#lbAB">NOM</A><DD>
|
|
<DT id="11"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="12"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAE">Algorithme de tri</A><DD>
|
|
</DL>
|
|
<DT id="14"><A HREF="#lbAF">NOTES</A><DD>
|
|
<DT id="15"><A HREF="#lbAG">VOIR AUSSI</A><DD>
|
|
<DT id="16"><A HREF="#lbAH">TRADUCTION</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:02 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|