# Guide du testeur WeeChat

Sébastien Helleu
`<flashcode@flashtux.org>`
version 1.1.1, 2015-04-12

## 1. Objet

Beaucoup d’utilisateurs nous demandent comment aider WeeChat. La façon la plus facile (et aussi la plus rusée) consiste à le tester !

Le test est une partie très importante du développement de logiciel et ne devrait pas être sous-estimé. Lorsque de nouvelles fonctionnalités sont implémentées, elles doivent être testées, mais pour certaines fonctionnalités il y a trop de cas à tester et les développeurs ne peuvent pas tout tester.

Par exemple : l’extension charset introduite dans WeeChat WeeChat 0.2.2 : aucun de nous (développeurs, contributeurs et testeurs) n’utilisait de canaux avec des caractères spéciaux dans leurs noms et quand la version 0.2.2 a été rendue disponible, nous avons reçu de nombreuses remontées d’utilisateurs russes. Si nous avons plus de testeurs, cela ne devrait pas arriver à nouveau dans le futur.

Tester les versions stables de WeeChat est inutile car les développeurs sont constamment occupés à implémenter de nouvelles fonctionnalités (et à corriger des anciens bugs).

## 2. Préparez votre système

Cela nous aiderait beaucoup si vous activiez les fichiers core Linux : si WeeChat se plante, Linux écrit un fichier core. Ce fichier contient des informations importantes pour le debug, pour savoir exactement où le problème se situe dans WeeChat).

Si vous utilisez le shell bash, ajoutez cette ligne dans votre `~/.bashrc` :

    ulimit -c unlimited

## 3. Téléchargement de la version devel

Le code tout frais (avec les derniers bugs et fonctionnalités) est stocké dans GIT.

Vous pouvez décider de le construire manuellement (méthode recommandée) :

- la version GIT peut être construite et installée en parallèle de la version stable,

- vous n’avez pas besoin d’accès root ni de sacrifier votre version stable de WeeChat.

### 3.1. Obtenir et compiler les sources

Créez tout d’abord un répertoire, par exemple weechat-git :

    $ mkdir ~/weechat-git
    $ cd ~/weechat-git

Si vous avez git installé, vous pouvez cloner la base GIT (recommandé) :

    $ git clone https://github.com/weechat/weechat.git
    $ cd weechat

Note | Plus tard, vous pourrez utiliser la commande "`git pull`" dans ce répertoire pour obtenir juste les deltas avec la version d’aujourd’hui.

Sinon vous pouvez installer le paquet devel :

    $ wget https://weechat.org/files/src/weechat-devel.tar.bz2
    $ tar xvjf weechat-devel.tar.bz2
    $ cd weechat-devel

Pour compiler les sources, cmake est recommandé :

    $ mkdir build
    $ cd build
    $ cmake .. -DPREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug
    $ make
    $ make install

Si vous n’avez pas cmake, il est toujours possible d’utiliser les autotools :

    $ ./autogen.sh
    $ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev
    $ make
    $ make install

### 3.2. Obtenir un paquet binaire

Selon votre distribution Linux :

- Debian: https://weechat.org/download/debian

- Gentoo: https://weechat.org/download

- ArchLinux: PKGBUILD depuis http://aur.archlinux.org/

- autre: nous ne savons pas ! Eheh.

## 4. Lancer WeeChat

Il est conseillé de lancer WeeChat avec un répertoire différent de la version stable, avec l’option `--dir`.

La commande est :

    $ ~/weechat-git/bin/weechat

Si vous êtes encore éveillé, vous devriez voir une interface familière et pouvoir vous vanter d’utiliser la version la plus récente possible de WeeChat ;)

Maintenant si vous obtenez un comportement étrange ou un plantage, n’hésitez pas à nous en avertir sur `#weechat`, serveur `chat.freenode.net`.

S’il n’y a pas de plantage, dites-le nous aussi, nous avons besoin de votre retour et de vos impressions !