weechat/doc/fr/weechat_tester.fr.adoc
2016-05-15 08:52:19 +02:00

142 lines
3.9 KiB
Plaintext

= 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 !