Vous êtes sur le wiki de développement du projet SLIS

Bien choisir le numéro de version d'un module SLIS

Notion de version

Nom de distribution SLIS

Le nom de version d'une distribution slis permet d'identifier l'ensemble des paquets à un instant donné. Il est possible alors de définir différents ensembles, notamment ceux correspondant aux versions en production et ceux correspondants aux versions de développement.

Ce nom de distribution se retrouve donc sur la première ligne du fichier debian/changelog de chaque paquet.

Exemples : slis40, slis41, etc.

slis-coffee (4.0.2) slis40; urgency=low

  * it now makes the coffee

  <...>

Version d'un paquet SLIS

Chaque module se trouvant dans le répertoire sources/tags a un numéro de version. Pour un paquet slis-coffee nous aurons des répertoires du type :

sources/tags/slis-coffee/<version_slis_majeur>.<version_slis_mineur>.<revision_majeur>[.<revision_mineur>]

avec :

  • <version_slis_majeur> et <version_slis_mineur> correspondent au numéro de distribution (par exemple 4.0)
  • <revision_majeur> correspond à une modification dans le cas où le paquet se trouve dans une distribution en développement. Ce dernier commence à 1.
  • <revision_mineur> correspond à une modification dans le cas où le paquet se trouve dans une distribution en production.

Version d'un paquet Debian ayant été modifié pour SLIS

Si il est nécessaire de modifier un paquet Debian existant afin d'y intégrer des fonctionnalités nécessaires au SLIS, le numéro de version devient :

<version_debian>+slis.<version_slis_majeur>.<version_slis_mineur>.<revision_majeur>[.<revision_mineur>]

avec, en plus des points précédents :

  • <version_debian> correspond à l'intégralité du numéro de version du paquet Debian original

Si jamais les modifications sont mises à jour pour partir d'une nouvelle version du paquet Debian, <revision_majeur> redevient 1.

Principe de versionnement

Dans le cas d'une distribution en développement

Supposons une modification du paquet slis-coffee dans une version de slis en développement dont le dernier tag est 4.1.3. La prochaine version du paquet sera donc 4.1.4.

Pour cela il faut :

  1. Modifier le fichier debian/changelog pour que la distribution et le numéro de version correspondent respectivement à slis41 et 4.1.3 ;
  2. Utiliser la commande svn-buildpackage (contenu dans la distribution debian) commme indiqué dans sur cette page ;
  3. publier le paquet sur le dépôt de paquet APT en utilisant dput.

Dans le cas d'une distribution en production

(par exemple dans le cas d'une correction d'un bug)

Supposons que nous venons de trouver un bug sur slis-coffee dont la version de paquet est 4.0.1 et dont la version de distribution est slis40. Une fois le bug corrigé il faudra donc tagger le paquet avec la version 4.0.1.1.

Pour cela il faut :

  1. Modifier le fichier debian/changelog pour que la distribution et le numéro de version correspondent respectivement à slis40 et 4.0.1.1 ;
  2. Utiliser la commande svn-buildpackage (contenu dans la distribution debian) commme indiqué dans sur cette page ;
  3. publier le paquet sur le dépôt de paquet APT en utilisant dput.

QR Code
QR Code devel:versionning (generated for current page)