Fabriquer une version

In English

Voici quelques étapes simples pour fabriquer une version, lisez la politique de version pour plus d'informations au sujet de quand une version devrait être faite. Fondamentalement, nous avons quatre étapes principales, "construire le paquet", "tester", "téléverser sur SourceForge" et "marquer SVN".

Récupérer la version de SVN

Récupérez le dernier SVN, ou la révision (ou date) que vous voudriez pour faire la version. Par exemple pour récupérer la version de apertium-oc-ca du 10 juin 2007, utilisez :

$ svn co -r '{2007-06-10}' https://svn.code.sf.net/p/apertium/svn/trunk/apertium-oc-ca

Éditer les fichiers de construction

D'abord mettez à jour les fichiers de construction pour indiquer la nouvelle version.

Édition de Makefile.am :

-VERSION=1.0.2
+VERSION=1.0.3

Édition de configure.ac :

-AC_INIT([apertium-oc-ca], [1.0.2], [<maintainer email>])
-AM_INIT_AUTOMAKE([apertium-oc-ca], [1.0.2], no-define)
+AC_INIT([apertium-oc-ca], [1.0.3], [<maintainer email>])
+AM_INIT_AUTOMAKE([apertium-oc-ca], [1.0.3], no-define)

Construire le paquet

Lancer autogen.sh:

$ ./autogen.sh 

$ make dist

Vous devriez maintenant avoir un fichier dans le répertoire source appelé apertium-oc-ca-1.0.3.tar.gz.

Tester

Copier le fichier temporairement quelque part, extraire son contenu, et le tester.

$ mkdir /tmp/test
$ ./configure --prefix=/tmp/test
$ make
$ make install

Si vous obtenez des erreurs, revenez en arrière, corrigez-les dans SVN et recommencez. SI l'erreur est dans cette révision, pas dans l'entête SVN, revenez alors à la révision que vous avez vérifiée et faites une note dans le ChangeLog sur ce que vous avez modifié.

Exemple de contenu du ChangeLog :

Wed 20 Jun 2007 08:45:42 BST

  * New release version 1.0.3
  * Updated Makefile.am to fix 'make install' problem. See
    bug #3 in Bugzilla.

Fabriquer une version dans SourceForge

Pour cette étape, vous aurez besoin d'être un administrateur sur SourceForge. La première chose est de vous logger sur SourceForge et d'aller sur la page du projet apertium. Allez au "Develop tab", puis "Project admin" tab, et descendez au "Gestionnaire de fichier" et cliquez.

Le "Gestionnaire de fichier" est étonnamment direct. Cliquez droit sur le répertoire dans lequel vous boulez téléverser (ou créez un nouveau répertoire en cliquant droit sur <<ROOT>>) et cliquez sur "Uploads here". Ensuite cliquez sur "Upload file" en haut et choisissez le fichier que vous voulez téléverser.

Si vous ne pouvez pas cliquer droit, alors cliquez sur l'icone ressemblant à une roue à gauche du répertoire.

Marquer la version que vous venez de faire dans SVN

Dans SVN, on marque une version en utilisant la commande copy.

S'il y a déjà un module dans le répertoire /tags/ pour le module que vous packagez, sautez l'étape suivante, si vous n'en avez pas besoin :

$ svn mkdir https://svn.code.sf.net/p/apertium/svn/tags/apertium-oc-ca

Maintenant pour marquer la version, faites :

$ svn copy https://svn.code.sf.net/p/apertium/svn/trunk/apertium-oc-ca \
https://svn.code.sf.net/p/apertium/svn/tags/apertium-oc-ca/release-1.0.3 -m "Tagging release"
$ svn commit