diff --git a/FAQ b/FAQ index 0752c1a81..062c0740e 100644 --- a/FAQ +++ b/FAQ @@ -1,4 +1,4 @@ -WeeChat FAQ, 2008-01-02 +WeeChat FAQ, 2009-01-03 ======================= Intended audience: @@ -33,15 +33,17 @@ A: Curses GUI is built by default. 1.2 ================================================================================ -Q: I can't compile WeeChat CVS. +Q: I can't compile WeeChat after cloning git repository. -A: Check that you have latest version of autoconf and automake. +A: If you're compiling with autotools (and not cmake), check that you have + latest version of autoconf and automake. WeeChat has been developed with autoconf version 2.61 and automake version 1.10. - You should have at least these versions in order to compile WeeChat CVS. - If you can't or don't want to install these versions, you can download and - install "devel package", a package built almost every day, based on CVS. - Note that this package may not correspond exactly to CVS base. + You should have at least these versions in order to compile WeeChat. + If you can't or don't want to install these versions, you can download + and install "devel package", a package built almost every day using git + repository. + Note that this package may not correspond exactly to git base. 2.1 @@ -50,17 +52,17 @@ Q: Why using WeeChat ? X-Chat and Irssi are so good... A: Because WeeChat is very light and has new features. Some new features: - * many GUI (Curses, Gtk, wxWidgets, Qt) + * multi-protocols support via plugins (IRC and other soon) + * many deported GUI in addition to Curses (coming soon) * available in many languages * nicklist available in all GUI - * extensible with plugins (C, Perl, Python, Ruby, Lua) + * extensible with plugins (C, Perl, Python, Ruby, Lua, Tcl) * horizontal and vertical window split * infobar highlight * FIFO pipe for remote control - * developed from scratch (not based on any other IRC client) + * developed from scratch (not based on any other client) * multi-platform * 100% GPL and free - This is the "geekest" IRC client ;) More info on this page: http://weechat.flashtux.org/features.php @@ -80,7 +82,7 @@ Q: I heard about "buffers" and "windows", what's the difference? A: A window is used when you split screen vertically or horizontally. A buffer is a "view" for a window. Each window displays a buffer, and many windows may display same buffer. - Examples of buffers: server messages, channel, DCC list, .. + Examples of buffers: server messages, channel, xfer control, .. 2.4 @@ -98,7 +100,8 @@ A: For versions < 0.2.3, please upgrade to last stable version. UTF-8 for terminal charset. If you see ANSI_X3.4-1968 or other values, probably your locale is wrong. - setup global decode value, for example: - /setp charset.global.decode = ISO-8859-15 + with WeeChat <= 0.2.6: /setp charset.global.decode = ISO-8859-15 + with WeeChat >= 0.2.7: /set charset.default.decode "ISO-8859-15" - if you are using UTF-8 locale, check that your terminal is UTF-8 ready. Terminal recommended for UTF-8 is rxvt-unicode. @@ -114,54 +117,18 @@ A: Key bindings are customizable with /key command. 2.6 ================================================================================ -Q: How can I load Perl scripts? - Are Perl scripts compatible with other IRC clients ? +Q: How can I load Perl/Python/Ruby/Lua/Tcl scripts? + Are scripts compatible with other IRC clients ? -A: You can use /perl command to load scripts (default path is - ~/.weechat/perl). - Note that scripts in ~/.weechat/perl/autoload are automatically loaded - when WeeChat is starting up. - Perl scripts are not compatible with other IRC clients. +A: You can use commands /perl, /python, /ruby, /lua and /tcl to load + scripts (default path for scripts is ~/.weechat/). + Note that scripts in ~/.weechat//autoload are automatically + loaded when WeeChat is starting up. + Scripts are not compatible with other IRC clients. 2.7 ================================================================================ -Q: How can I load Python scripts? - Are Python scripts compatible with other IRC clients ? - -A: You can use /python command to load scripts (default path is - ~/.weechat/python). - Note that scripts in ~/.weechat/python/autoload are automatically loaded - when WeeChat is starting up. - Python scripts are not compatible with other IRC clients. - - -2.8 -================================================================================ -Q: How can I load Ruby scripts? - Are Ruby scripts compatible with other IRC clients ? - -A: You can use /ruby command to load scripts (default path is - ~/.weechat/ruby). - Note that scripts in ~/.weechat/ruby/autoload are automatically loaded - when WeeChat is starting up. - Ruby scripts are not compatible with other IRC clients. - - -2.9 -================================================================================ -Q: How can I load Lua scripts? - Are Lua scripts compatible with other IRC clients ? - -A: You can use /lua command to load scripts (default path is - ~/.weechat/lua). - Note that scripts in ~/.weechat/lua/autoload are automatically loaded - when WeeChat is starting up. - Lua scripts are not compatible with other IRC clients. - - -2.10 -================================================================================ Q: When I'm using weechat under screen, I have weird chars, when I switch window for example, how to fix that? @@ -170,7 +137,7 @@ A: This may be caused by bad value of TERM variable (look at echo $TERM). is ok (like many other values). -2.11 +2.8 ================================================================================ Q: I want to change language used by WeeChat for messages, but without exiting WeeChat, is it possible? @@ -183,24 +150,28 @@ A: Yes, you have to use python script shell.py (available on WeeChat users, you can issue: /shell setenv LANG=en_US) -2.12 +2.9 ================================================================================ Q: With Curses GUI, how can I copy/paste text without pasting nicklist ? A: You can use a terminal with rectangular selection (like rxvt-unicode, konsole, ...). Other solution is to move nicklist to top or bottom, for example: - /set look_nicklist_position = top + with WeeChat <= 0.2.6: /set look_nicklist_position = top + with WeeChat >= 0.2.7: /bar set nicklist position top -2.13 +2.10 ================================================================================ Q: How to be warned when someone highlights me on a channel ? A: You can use sound.pl script (available on scripts page), and then setup a system command (to play sound, display message, ..) with this command : - /setp perl.sound.cmd_highlight = "/usr/bin/command arguments..." + with WeeChat <= 0.2.6: + /setp perl.sound.cmd_highlight = "/path/command arguments" + with WeeChat >= 0.2.7: + /set plugins.var.perl.sound.cmd_highlight "/path/command arguments" 3.1 diff --git a/FAQ.fr b/FAQ.fr index 0fc6e6fc0..60dd919b7 100644 --- a/FAQ.fr +++ b/FAQ.fr @@ -1,115 +1,117 @@ -WeeChat FAQ, 2008-01-02 +WeeChat FAQ, 2009-01-03 ======================= -Public concerné : +Public concerné : Tous les utilisateurs de WeeChat. Avant de lire la suite ceci : -la liste suivante de questions/réponses n'est *pas* exhaustive. -Il est donc possible que vous ne trouviez pas de question/réponse correspondant -à votre problème. -Lisez les quand même SVP, elles peuvent vous aider à corriger votre problème. -Et même si votre problème est mentionné ci-dessous, il est possible que la -réponse ne vous aide pas à corriger le problème. Dans ce cas, contactez-nous, -nous essaierons de vous aider à trouver une solution. +la liste suivante de questions/réponses n'est *pas* exhaustive. +Il est donc possible que vous ne trouviez pas de question/réponse correspondant +à votre problème. +Lisez les quand même SVP, elles peuvent vous aider à corriger votre problème. +Et même si votre problème est mentionné ci-dessous, il est possible que la +réponse ne vous aide pas à corriger le problème. Dans ce cas, contactez-nous, +nous essaierons de vous aider à trouver une solution. 1 - Compilation 2 - Utilisation de WeeChat -3 - Développement +3 - Développement 1.1 ================================================================================ Q: J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ? -R: L'interface Curses est construite par défaut. - Pour construire l'interface Gtk, wxWidgets ou Qt, vous devez spécifier des +R: L'interface Curses est construite par défaut. + Pour construire l'interface Gtk, wxWidgets ou Qt, vous devez spécifier des options pour le script ./configure : --enable-gtk pour activer l'interface Gtk --enable-wxwidgets pour activer l'interface wxWidgets --enable-qt pour activer l'interface Qt Tapez ./configure --help pour voir les options disponibles. ATTENTION : seule l'interface Curses est ok aujourd'hui. - Les autres interfaces sont en développement. + Les autres interfaces sont en développement. 1.2 ================================================================================ -Q: Je ne peux pas compiler le CVS WeeChat. +Q: Je ne peux pas compiler WeeChat après avoir cloné la base git. -R: Vérifiez que vous avez bien la dernière version d'autoconf et automake. - WeeChat a été développé avec autoconf version 2.61 et automake +R: Si vous compilez avec les autotools (et non cmake), vérifiez que vous avez + bien la dernière version d'autoconf et automake. + WeeChat a été développé avec autoconf version 2.61 et automake version 1.10. - Vous devez avoir au moins ces versions pour compiler le CVS WeeChat. + Vous devez avoir au moins ces versions pour compiler WeeChat. Si vous n'avez pas ou ne souhaitez pas installer ces versions, vous - pouvez télécharger et installer le paquet "devel", un paquet construit - quasiment tous les jours, basé sur le CVS. - Notez que ce paquet peut ne pas correspondre exactement à la base CVS. + pouvez télécharger et installer le paquet "devel", un paquet construit + quasiment tous les jours à partir de la base git. + Notez que ce paquet peut ne pas correspondre exactement à la base git. 2.1 ================================================================================ Q: Pourquoi utiliser WeeChat ? X-Chat et Irssi sont si bien... -R: Parce que WeeChat est très léger et a de nouvelles fonctionnalités. - Quelques nouvelles fonctionnalités : - * plusieurs interfaces (Curses, Gtk, wxWidgets, Qt) +R: Parce que WeeChat est très léger et a de nouvelles fonctionnalités. + Quelques nouvelles fonctionnalités : + * support multi-protocoles via extensions (IRC et d'autres bientôt) + * plusieurs interfaces déportées en plus de Curses (à venir bientôt) * disponible en plusieurs langues * liste des pseudos disponible dans toutes les interfaces - * extensible par des extensions (C, Perl, Python, Ruby, Lua) - * découpage de la fenêtre horizontalement et verticalement + * extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl) + * découpage de la fenêtre horizontalement et verticalement * highlight dans la barre d'infos - * tube FIFO pour contrôle à distance - * développé à partir de zéro (non basé sur un quelconque client IRC) + * tube FIFO pour contrôle à distance + * développé à partir de zéro (non basé sur un quelconque client) * multi-platformes * 100% GPL et libre - C'est le client IRC le plus "geek" ;) Plus d'infos sur cette page: http://weechat.flashtux.org/features.php 2.2 ================================================================================ -Q: J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ? +Q: J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ? R: Pour obtenir de l'aide tapez /help. Pour de l'aide sur une commande, tapez /help commande. - Les touches et commandes sont listées dans la documentation. + Les touches et commandes sont listées dans la documentation. 2.3 ================================================================================ Q: J'ai entendu parler de "buffers" et "windows", quelle est la - différence ? + différence ? -R: Une fenêtre ("window") est utilisée quand vous partagez l'écran +R: Une fenêtre ("window") est utilisée quand vous partagez l'écran verticalement ou horizontalement. - Un tampon ("buffer") est une "vue" pour une fenêtre. Chaque fenêtre - affiche un tampon, et plusieurs fenêtres peuvent afficher le même + Un tampon ("buffer") est une "vue" pour une fenêtre. Chaque fenêtre + affiche un tampon, et plusieurs fenêtres peuvent afficher le même tampon. - Exemples de tampons: messages serveur, canal, liste des DCC, etc... + Exemples de tampons: messages serveur, canal, contrôle xfer, etc... 2.4 ================================================================================ Q: Je ne vois pas bien certains accents dans WeeChat, que faire ? -R: Pour les versions < 0.2.3, merci d'installer la dernière version stable. +R: Pour les versions < 0.2.3, merci d'installer la dernière version stable. Pour les versions >= 0.2.3 : - - vérifiez que weechat-curses est lié avec libncursesw (attention: - nécessaire sur beaucoup de distributions, mais pas toutes) : + - vérifiez que weechat-curses est lié avec libncursesw (attention: + nécessaire sur beaucoup de distributions, mais pas toutes) : ldd /chemin/vers/weechat-curses - - vérifiez que l'extension "Charset" est chargée avec la commande - /plugin (s'il ne l'est pas, vous devez peut-être installer le + - vérifiez que l'extension "Charset" est chargée avec la commande + /plugin (s'il ne l'est pas, vous devez peut-être installer le paquet "weechat-plugins") - - vérifiez la ligne charset (sur le tampon serveur), vous devriez voir + - vérifiez la ligne charset (sur le tampon serveur), vous devriez voir ISO-XXXXXX ou UTF-8 pour le charset du terminal. Si vous voyez ANSI_X3.4-1968 ou d'autres valeurs, votre locale est probablement - erronée. - - affectez la valeur pour le décodage global, par exemple : - /setp charset.global.decode = ISO-8859-15 - - si vous utilisez la locale UTF-8, vérifiez que votre terminal est - compatible UTF-8. Un terminal conseillé pour l'UTF-8 est rxvt-unicode. + erronée. + - affectez la valeur pour le décodage global, par exemple : + avec WeeChat <= 0.2.6: /setp charset.global.decode = ISO-8859-15 + avec WeeChat >= 0.2.7: /set charset.default.decode "ISO-8859-15" + - si vous utilisez la locale UTF-8, vérifiez que votre terminal est + compatible UTF-8. Un terminal conseillé pour l'UTF-8 est rxvt-unicode. 2.5 @@ -117,75 +119,39 @@ R: Pour les versions < 0.2.3, merci d'installer la derni Q: Comment puis-je configurer les raccourcis clavier ? R: Les raccourcis clavier sont modifiables avec la commande /key. - La touche par défaut Meta-k (souvent Alt-k) permet de capturer le code + La touche par défaut Meta-k (souvent Alt-k) permet de capturer le code d'une touche et de l'inclure dans la zone de saisie. 2.6 ================================================================================ -Q: Comment puis-je charger des scripts Perl ? - Les scripts Perl sont-ils compatibles avec d'autres clients IRC ? +Q: Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? + Les scripts sont-ils compatibles avec d'autres clients IRC ? -R: La commande /perl permet de charger les scripts Perl (le chemin par défaut - est ~/.weechat/perl). - Notez que les scripts dans ~/.weechat/perl/autoload sont automatiquement - chargés par WeeChat lorsqu'il démarre. - Les scripts Perl ne sont pas compatibles avec d'autres clients IRC. +R: Les commandes /perl, /python, /ruby, /lua et /tcl permettent de charger + les scripts Perl (le chemin par défaut est ~/.weechat/). + Notez que les scripts dans ~/.weechat//autoload sont + automatiquement chargés par WeeChat lorsqu'il démarre. + Les scripts ne sont pas compatibles avec d'autres clients IRC. 2.7 ================================================================================ -Q: Comment puis-je charger les scripts Python ? - Les scripts Python sont-ils compatibles avec d'autres clients IRC ? +Q: Quand j'utilise weechat sous screen, j'ai des caractères bizarres + notamment en changeant de fenêtre, comment corriger ça ? -R: La commande /python permet de charger les scripts Python (le chemin par - défaut est ~/.weechat/python). - Notez que les scripts dans ~/.weechat/python/autoload sont automatiquement - chargés par WeeChat lorsqu'il démarre. - Les scripts Python ne sont pas compatibles avec d'autres clients IRC. +R: Cela peut être du à la variable TERM qui n'a pas la bonne valeur + (regardez echo $TERM). Par exemple "xterm-color" provoque ce genre de + problèmes, utilisez "xterm" qui est ok (comme plein d'autres valeurs). 2.8 ================================================================================ -Q: Comment puis-je charger des scripts Ruby ? - Les scripts Ruby sont-ils compatibles avec d'autres clients IRC ? - -R: La commande /ruby permet de charger les scripts Ruby (le chemin par - défaut est ~/.weechat/ruby). - Notez que les scripts dans ~/.weechat/ruby/autoload sont automatiquement - chargés par WeeChat lorsqu'il démarre. - Les scripts Ruby ne sont pas compatibles avec d'autres clients IRC. - - -2.9 -================================================================================ -Q: Comment puis-je charger des scripts Lua ? - Les scripts Lua sont-ils compatibles avec d'autres clients IRC ? - -R: La commande /lua permet de charger les scripts Lua (le chemin par - défaut est ~/.weechat/lua). - Notez que les scripts dans ~/.weechat/lua/autoload sont automatiquement - chargés par WeeChat lorsqu'il démarre. - Les scripts Lua ne sont pas compatibles avec d'autres clients IRC. - - -2.10 -================================================================================ -Q: Quand j'utilise weechat sous screen, j'ai des caractères bizarres - notamment en changeant de fenêtre, comment corriger ça ? - -R: Cela peut être du à la variable TERM qui n'a pas la bonne valeur - (regardez echo $TERM). Par exemple "xterm-color" provoque ce genre de - problèmes, utilisez "xterm" qui est ok (comme plein d'autres valeurs). - - -2.11 -================================================================================ -Q: Je souhaite changer la langue des messages affichés par WeeChat, mais +Q: Je souhaite changer la langue des messages affichés par WeeChat, mais sans quitter WeeChat, est-ce possible ? R: Oui, il faut utiliser le script python shell.py (disponible sur le site - de WeeChat) et taper ces commandes une fois le script chargé : + de WeeChat) et taper ces commandes une fois le script chargé : /shell setenv LANG=en_US.UTF-8 /upgrade (pour avoir des messages anglais avec encodage UTF-8 pour le terminal, @@ -193,40 +159,44 @@ R: Oui, il faut utiliser le script python shell.py (disponible sur le site /shell setenv LANG=en_US) -2.12 +2.9 ================================================================================ Q: Avec l'interface Curses, comment puis-je copier/coller du texte sans coller la liste des pseudos ? -R: Vous pouvez utiliser un terminal qui propose la sélection rectangulaire +R: Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme rxvt-unicode, konsole, etc...). - Une autre solution est de déplacer la liste des pseudos en haut ou en + Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par exemple : - /set look_nicklist_position = top + avec WeeChat <= 0.2.6: /set look_nicklist_position = top + avec WeeChat >= 0.2.7: /bar set nicklist position top -2.13 +2.10 ================================================================================ -Q: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ? +Q: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ? R: Vous pouvez utiliser le script sound.pl (disponible sur la page des - scripts), puis configurer une commande système (jouant un son, affichant - un message à l'écran, etc...) comme ceci : - /setp perl.sound.cmd_highlight = "/usr/bin/commande parametres..." + scripts), puis configurer une commande système (jouant un son, affichant + un message à l'écran, etc...) comme ceci : + avec WeeChat <= 0.2.6: + /setp perl.sound.cmd_highlight = "/chemin/commande parametres" + avec WeeChat >= 0.2.7: + /set plugins.var.perl.sound.cmd_highlight "/chemin/commande parametres" 3.1 ================================================================================ Q: Comment dois-je reporter les bugs ? -R: Il y a 3 manières de reporter les bugs : +R: Il y a 3 manières de reporter les bugs : 1. vous pouvez nous joindre sur IRC: irc.freenode.net, canal #weechat - 2. vous pouvez soumettre votre bug à cette adresse : + 2. vous pouvez soumettre votre bug à cette adresse : http://savannah.nongnu.org/bugs/?func=addbug&group=weechat - 3. vous pouvez envoyer votre problème par mail, consultez la page - support pour les mails des développeurs : + 3. vous pouvez envoyer votre problème par mail, consultez la page + support pour les mails des développeurs : http://weechat.flashtux.org/support.php - (vous pouvez souscrire et envoyer à la liste de diffusion + (vous pouvez souscrire et envoyer à la liste de diffusion "support") @@ -234,51 +204,51 @@ R: Il y a 3 mani ================================================================================ Q: Comment dois-je soumettre les patches ? -R: Il y a 3 manières de soumettre les patches : +R: Il y a 3 manières de soumettre les patches : 1. vous pouvez nous joindre sur IRC: irc.freenode.net, canal #weechat - 2. vous pouvez soumettre votre patch à cette adresse : + 2. vous pouvez soumettre votre patch à cette adresse : http://savannah.nongnu.org/patch/?func=addpatch&group=weechat 3. vous pouvez envoyer votre patch par mail, consultez la page - support pour les mails des développeurs : + support pour les mails des développeurs : http://weechat.flashtux.org/support.php - (vous pouvez souscrire et envoyer à la liste de diffusion + (vous pouvez souscrire et envoyer à la liste de diffusion "support") 3.3 ================================================================================ -Q: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ? +Q: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ? -R: Il y a 2 manières : +R: Il y a 2 manières : 1. vous pouvez nous joindre sur IRC: irc.freenode.net, channel #weechat 2. vous pouvez envoyer un mail, consultez la page support pour les - mails des développeurs : + mails des développeurs : http://weechat.flashtux.org/support.php - (vous pouvez souscrire et envoyer à la liste de diffusion + (vous pouvez souscrire et envoyer à la liste de diffusion "support") 3.4 ================================================================================ -Q: Quelle est la liste des plate-formes supportées par WeeChat ? +Q: Quelle est la liste des plate-formes supportées par WeeChat ? -R: La liste complète est sur cette page : +R: La liste complète est sur cette page : http://weechat.flashtux.org/download.php?lang=fr&view=supported_os 3.5 ================================================================================ -Q: WeeChat sera-t-il porté sur QNX ou d'autres systèmes d'exploitation ? +Q: WeeChat sera-t-il porté sur QNX ou d'autres systèmes d'exploitation ? R: Oui. Les futures versions seront disponibles pour ces OS. - Nous avons besoin d'aide pour ces systèmes, toute aide est la bienvenue :) + Nous avons besoin d'aide pour ces systèmes, toute aide est la bienvenue :) 3.6 ================================================================================ -Q: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ? +Q: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ? -R: Il y a plusieurs choses à faire (code, documentation, ...) +R: Il y a plusieurs choses à faire (code, documentation, ...) Merci de prendre contact avec nous par IRC ou mail, consultez la page support : http://weechat.flashtux.org/support.php @@ -286,7 +256,7 @@ R: Il y a plusieurs choses 3.7 ================================================================================ -Q: Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ? +Q: Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ? -R: Vous pouvez donner de l'argent pour aider le développement. - Plus de détails sur http://weechat.flashtux.org/donate.php +R: Vous pouvez donner de l'argent pour aider le développement. + Plus de détails sur http://weechat.flashtux.org/donate.php