= Guide du testeur WeeChat
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
:toc: left
:toc-title: Table des matières
:sectnums:
:docinfo1:


[[purpose]]
== 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).


[[prepare_system]]
== 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
----


[[download]]
== 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.

[[get_sources]]
=== 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 .. -DCMAKE_INSTALL_PREFIX=$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
----

[[install_binary_package]]
=== 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.


[[run]]
== 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 !
