summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSebastien Helleu <flashcode@flashtux.org>2009-03-01 09:26:04 +0100
committerSebastien Helleu <flashcode@flashtux.org>2009-03-01 09:26:04 +0100
commit1a69bbcb1eff2e322fa3b1477db289fb9267f1eb (patch)
tree66f838425c739198c8b6cf1b848feae860c5ea5d
parentb0c058fc20095a9c133ef518be0c79ed6b833599 (diff)
downloadweechat-1a69bbcb1eff2e322fa3b1477db289fb9267f1eb.zip
Update FAQ (new format for website and some updates/additions)
-rw-r--r--FAQ474
-rw-r--r--FAQ.fr553
2 files changed, 520 insertions, 507 deletions
diff --git a/FAQ b/FAQ
index e9bda5d23..649fb6e55 100644
--- a/FAQ
+++ b/FAQ
@@ -1,257 +1,263 @@
-WeeChat FAQ, 2009-01-31
+WeeChat FAQ, 2009-03-01
=======================
-Intended audience:
-Users of WeeChat >= 0.2.7.
-
-Before reading the following:
-The following Q/A list is *not* exhaustive.
-It is also possible that you won't find any Q/A that matches your problem.
-Please read them anyway, they may provide you help in fixing your problem
-anyway.
-And even if your problem is listed below, it is possible that the answers don't
-help you anymore to solve it. Then, please contact us, we will try to help you
-finding a solution.
-
-1 - Compiling
-2 - Using WeeChat
-3 - Development
-
-1.1
-================================================================================
-Q: I heard about many GUI for WeeChat. How can I compile/use them?
-
-A: Today only Curses GUI is available.
- Other GUI will be available as remote client (currently udner
- development).
-
-
-1.2
-================================================================================
-Q: I can't compile WeeChat after cloning git repository.
-
-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.
- 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
-================================================================================
-Q: Why using WeeChat ? X-Chat and Irssi are so good...
-
-A: Because WeeChat is very light and has new features.
- Some new features:
- * multi-protocols support via plugins (IRC, Jabber)
- * many deported GUI in addition to Curses (coming soon)
- * available in many languages
- * extensible with plugins (C, Perl, Python, Ruby, Lua, Tcl)
- * buffers with free content
- * display filtering by tags and regular expressions
- * horizontal and vertical window split
- * customizable and extensible bars
- * nicklist available in all GUI
- * infobar highlight
- * incremental text search in buffers, jump to highlights
- * FIFO pipe for remote control
- * aspell support
- * double charset (encoding/decoding)
- * developed from scratch (not based on any other client)
- * multi-platform
- * 100% GPL and free
-
- More info on this page: http://weechat.flashtux.org/features.php
-
-
-2.2
-================================================================================
-Q: I've launched WeeChat, but I'm lost, what can I do?
-
-A: For help you can type /help. For help about a command, type /help command.
- Keys and commands are listed in documentation.
- If you're new to WeeChat, it's recommended to read quickstart guide
- (see doc page on website).
-
-
-2.3
-================================================================================
-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, xfer control, ..
-
-
-2.4
-================================================================================
-Q: I don't see some chars with accents, what can I do?
-
-A: For versions < 0.2.3, please upgrade to last stable version.
- For versions >= 0.2.3 :
- - check that weechat-curses is linked to libncursesw (warning: needed
- on most distributions but not all) :
- ldd /path/to/weechat-curses
- - check that "Charset" plugin is loaded with /plugin command
- (if it is not, then you probably need "weechat-plugins" package)
- - check charset line (on server buffer), you should see ISO-XXXXXX or
- 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:
- 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.
-
-
-2.5
-================================================================================
-Q: Bars like title and status are not filled, background color stops after
- text, why?
-
-A: This may be caused by bad value of TERM variable (look at echo $TERM).
- Depending on where you launch WeeChat, you should have:
- - if WeeChat runs locally or on a remote machine without screen, it
- depends on terminal used: "xterm", "rxvt", ..
- - if WeeChat runs under screen, you should have "screen".
- If needed, fix your TERM variable (export TERM="xxx").
-
-
-2.6
-================================================================================
-Q: When I'm using weechat under screen, I have weird chars, when I switch
- window for example, how to fix that?
-
-A: This may be caused by bad value of TERM variable (look at echo $TERM).
- For example, "xterm-color" displays such weird chars, use "xterm" which
- is ok (like many other values).
- If needed, fix your TERM variable (export TERM="xxx").
-
-
-2.7
-================================================================================
-Q: How can I customize key bindings?
-
-A: Key bindings are customizable with /key command.
- Default key Meta-k (usually Alt-k) lets you grab key code and insert it
- in input zone.
-
-
-2.8
-================================================================================
-Q: How can I load Perl/Python/Ruby/Lua/Tcl scripts?
- Are scripts 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/<language>/).
- Note that scripts in ~/.weechat/<language>/autoload are automatically
- loaded when WeeChat is starting up.
- Scripts are not compatible with other IRC clients.
-
-
-2.9
-================================================================================
-Q: I want to change language used by WeeChat for messages, but without
- exiting WeeChat, is it possible?
-
-A: Yes, you have to use python script shell.py (available on WeeChat
- website) and issue these commands when script is loaded:
- /shell setenv LANG=en_US.UTF-8
- /upgrade
- (to have english messages with UTF-8 encoding for terminal, for ISO
- users, you can issue: /shell setenv LANG=en_US)
+1 - General
+2 - Compilation / install
+3 - Using WeeChat
+4 - Development
+
+
+------------------------------------------------------------------------------
+1.1: Why choosing WeeChat? X-Chat and Irssi are so good...
+
+Because WeeChat is very light and has new features.
+Some features (version >= 0.2.7):
+ * multi-protocols support via plugins (IRC, Jabber)
+ * many deported GUI in addition to Curses (coming soon)
+ * available in many languages
+ * extensible with plugins (C, Perl, Python, Ruby, Lua, Tcl)
+ * buffers with free content
+ * display filtering by tags and regular expressions
+ * horizontal and vertical window split
+ * customizable and extensible bars
+ * nicklist available in all GUI
+ * incremental text search in buffers, jump to highlights
+ * FIFO pipe for remote control
+ * aspell support
+ * double charset (encoding/decoding)
+ * developed from scratch (not based on any other client)
+ * multi-platform
+ * 100% GPL and free
+More info on this page: http://weechat.flashtux.org/features.php
+
+
+------------------------------------------------------------------------------
+2.1: I heard about many GUI for WeeChat. How can I compile/use them?
+
+Today only Curses GUI is available. Other GUI will be available as remote
+client (currently udner development).
-2.10
-================================================================================
-Q: With Curses GUI, how can I copy/paste text without pasting nicklist ?
+------------------------------------------------------------------------------
+2.2: I can't compile WeeChat after cloning git repository, why?
+
+Recommended way to compile WeeChat is with cmake.
+If you're compiling with autotools (and not cmake), check that you have latest
+version of autoconf and automake (WeeChat is developed with autoconf 2.61 and
+automake 1.10.1).
+Other way is to install "devel package", which needs less dependencies. This
+package is built almost every day using git repository. Note that this package
+may not correspond exactly to git base and that it's less convenient than git
+cloning for installing updates.
+
-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:
- with WeeChat <= 0.2.6: /set look_nicklist_position = top
- with WeeChat >= 0.2.7: /bar set nicklist position top
+------------------------------------------------------------------------------
+3.1: I've launched WeeChat, but I'm lost, what can I do?
+
+For help you can type /help. For help about a command, type /help command.
+Keys and commands are listed in documentation.
+It's recommended for new users to read quickstart guide (see doc page on
+website).
+
+
+------------------------------------------------------------------------------
+3.2: I heard about "buffers" and "windows", what's the difference?
+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, xfer control, ..
+
+
+------------------------------------------------------------------------------
+3.3: I don't see some chars with accents, what can I do?
+
+For versions < 0.2.3, please upgrade to last stable version.
+For versions >= 0.2.3:
+- check that weechat-curses is linked to libncursesw (warning: needed on most
+ distributions but not all):
+ ldd /path/to/weechat-curses
+- check that "Charset" plugin is loaded with /plugin command (if it is not,
+ then you probably need "weechat-plugins" package)
+- check charset line (on server buffer), you should see ISO-XXXXXX or 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:
+ 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.
+
+
+------------------------------------------------------------------------------
+3.4: Bars like title and status are not filled, background color stops after
+text, why?
+
+This may be caused by bad value of TERM variable (look at echo $TERM).
+Depending on where you launch WeeChat, you should have:
+- if WeeChat runs locally or on a remote machine without screen, it depends on
+ terminal used: "xterm", "rxvt", ..
+- if WeeChat runs under screen, you should have "screen".
+If needed, fix your TERM variable (export TERM="xxx").
+
+
+------------------------------------------------------------------------------
+3.5: When I'm using weechat under screen, I have weird chars, when I switch
+window for example, how to fix that?
+
+This may be caused by bad value of TERM variable (look at echo $TERM).
+For example, "xterm-color" displays such weird chars, use "xterm" which is ok
+(like many other values).
+If needed, fix your TERM variable (export TERM="xxx").
+
+
+------------------------------------------------------------------------------
+3.6: How can I customize key bindings?
+
+Key bindings are customizable with /key command.
+Default key Meta-k (usually Alt-k) lets you grab key code and insert it in
+command line.
+
+
+------------------------------------------------------------------------------
+3.7: I'm using OpenBSD and WeeChat does not load any plugin, what's wrong?
+
+Under OpenBSD, plugin filename ends with ".so.0.0" (".so" for Linux).
+You must setup that:
+- with WeeChat <= 0.2.6:
+ /set plugins_extension = ".so.0.0"
+ /plugin autoload
+- with WeeChat >= 0.2.7:
+ /set weechat.plugin.extension ".so.0.0"
+ /plugin autoload
+
+
+------------------------------------------------------------------------------
+3.8: How can I load Perl/Python/Ruby/Lua/Tcl scripts? Are scripts compatible
+with other IRC clients?
+
+You can use commands /perl, /python, /ruby, /lua and /tcl to load scripts
+(default path for scripts is ~/.weechat/<language>/).
+Scripts are not compatible with other IRC clients.
+Notes:
+- scripts in ~/.weechat/<language>/autoload are automatically loaded when
+ WeeChat is starting up.
+- plugin "tcl" is available with version 0.2.7 or newer.
+
+
+------------------------------------------------------------------------------
+3.9: I want to change language used by WeeChat for messages, but without
+exiting WeeChat, is it possible?
-2.11
-================================================================================
-Q: How to be warned when someone highlights me on a channel ?
+Yes, you have to use python script shell.py (available on WeeChat website) and
+issue these commands when script is loaded:
+ /shell setenv LANG=en_US.UTF-8
+ /upgrade
+To have english messages with UTF-8 encoding for terminal, for ISO users, you
+can issue:
+ /shell setenv LANG=en_US
-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 :
- 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
-================================================================================
-Q: How should I report bugs?
-
-A: There is 3 ways to report bugs:
- 1. you can join us on IRC: irc.freenode.net, channel #weechat
- 2. you can submit your bug at this URL:
- http://savannah.nongnu.org/bugs/?func=addbug&group=weechat
- 3. you can mail your problem, look at support page for developer's mails:
- http://weechat.flashtux.org/support.php
- (you can subscribe and send to "support" mailing list)
+------------------------------------------------------------------------------
+3.10: With Curses GUI, how can I copy/paste text without pasting nicklist?
-3.2
-================================================================================
-Q: How should I submit patches?
+You can use a terminal with rectangular selection (like rxvt-unicode,
+konsole, ...). Key is usually ctrl + alt + mouse selection.
+Other solution is to move nicklist to top or bottom, for example:
+- with WeeChat <= 0.2.6:
+ /set look_nicklist_position = top
+- with WeeChat >= 0.2.7:
+ /bar set nicklist position top
+
+
+------------------------------------------------------------------------------
+3.11: How to be warned when someone highlights me on a channel?
+
+You can use sound.pl script (available on scripts page), and then setup a
+system command (to play sound, display message, ..) with this command:
+- 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"
-A: There is 3 ways to submit patches:
- 1. you can join us on IRC: irc.freenode.net, channel #weechat
- 2. you can submit your patch at this URL:
- http://savannah.nongnu.org/patch/?func=addpatch&group=weechat
- 3. you can mail your patch, look at support page for developer's mails:
- http://weechat.flashtux.org/support.php
- (you can subscribe and send to "support" mailing list)
+------------------------------------------------------------------------------
+3.12: How can I filter join/part/quit messages on IRC channels?
-3.3
-================================================================================
-Q: How should I submit new feature request?
+According to WeeChat version:
+- with WeeChat <= 0.2.6:
+ /ignore * join #weechat freenode
+ /ignore * part #weechat freenode
+ /ignore * quit #weechat freenode
+ (channel and/or server may be "*")
+ (/help ignore for help)
+- with WeeChat >= 0.2.7:
+ - smart filter (keep join/part/quit from users who spoke recently):
+ /set irc.look.smart_filter on
+ /filter add irc_smart * irc_smart_filter *
+ (/help irc.look.smart_filter and /help filter for help)
+ - global filter (hide ALL join/part/quit):
+ /filter add jpk * irc_join,irc_part,irc_quit *
+ (/help filter for help)
-A: There is 2 ways to submit your feature request:
- 1. you can join us on IRC: irc.freenode.net, channel #weechat
- 2. you can mail your feature request, look at support page for developer's
- mails:
- http://weechat.flashtux.org/support.php
- (you can subscribe and send to "support" mailing list)
+------------------------------------------------------------------------------
+4.1: How should I report bugs?
-3.4
-================================================================================
-Q: What is the list of supported platforms for WeeChat?
- Will WeeChat be ported to other operating systems?
+There is 3 ways to report bugs:
+ 1. you can join us on IRC: irc.freenode.net, channel #weechat
+ 2. you can submit your bug at this URL:
+ http://savannah.nongnu.org/bugs/?func=addbug&group=weechat
+ 3. you can mail your problem, look at support page for developer's mails:
+ http://weechat.flashtux.org/support.php
+ (you can subscribe and send to "support" mailing list)
-A: Full list is on this page:
- http://weechat.flashtux.org/download.php?view=supported_os
- We do our best to run on as many platforms as possible. Help is welcome
- for some OS we don't have, to test WeeChat.
+------------------------------------------------------------------------------
+4.2: How should I submit patches?
+
+There is 3 ways to submit patches:
+ 1. you can join us on IRC: irc.freenode.net, channel #weechat
+ 2. you can submit your patch at this URL:
+ http://savannah.nongnu.org/patch/?func=addpatch&group=weechat
+ 3. you can mail your patch, look at support page for developer's mails:
+ http://weechat.flashtux.org/support.php
+ (you can subscribe and send to mailing list called "support")
-3.5
-================================================================================
-Q: I want to help WeeChat developers. What can I do?
-A: There's many tasks to do (code, documentation, ...)
- Please contact us with IRC or mail, look at support page:
- http://weechat.flashtux.org/support.php
+------------------------------------------------------------------------------
+4.3: How should I submit new feature request?
+There is 2 ways to submit your feature request:
+ 1. you can join us on IRC: irc.freenode.net, channel #weechat
+ 2. you can mail your feature request, look at support page for developer's
+ mails:
+ http://weechat.flashtux.org/support.php
+ (you can subscribe and send to mailing list called "support")
-3.6
-================================================================================
-Q: Can I give money or other things to WeeChat developers?
-A: You can give us money to help development.
- Details on http://weechat.flashtux.org/donate.php
+------------------------------------------------------------------------------
+4.4: What is the list of supported platforms for WeeChat? Will it be ported to
+other operating systems?
+
+Full list is on this page:
+ http://weechat.flashtux.org/download.php?view=supported_os
+We do our best to run on as many platforms as possible. Help is welcome for
+some OS we don't have, to test WeeChat.
+
+
+------------------------------------------------------------------------------
+4.5: I want to help WeeChat developers. What can I do?
+
+There's many tasks to do (testing, code, documentation, ...)
+Please contact us with IRC or mail, look at support page:
+ http://weechat.flashtux.org/support.php
+
+
+------------------------------------------------------------------------------
+4.6: Can I give money or other things to WeeChat developers?
+
+You can give us money to help development.
+Details on http://weechat.flashtux.org/donate.php
diff --git a/FAQ.fr b/FAQ.fr
index d80a92fc4..576d006c7 100644
--- a/FAQ.fr
+++ b/FAQ.fr
@@ -1,275 +1,282 @@
-WeeChat FAQ, 2009-01-31
+WeeChat FAQ, 2009-03-01
=======================
-Public concerné :
-Utilisateurs de WeeChat >= 0.2.7.
-
-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.
-
-1 - Compilation
-2 - Utilisation de WeeChat
-3 - Développement
-
-1.1
-================================================================================
-Q: J'ai entendu parler de plusieurs interfaces pour WeeChat.
- Comment puis-je les compiler/utiliser ?
-
-R: Aujourd'hui seule l'interface Curses est disponible.
- D'autres interfaces seront disponibles en mode distant (actuellement
- en développement).
-
-
-1.2
-================================================================================
-Q: Je ne peux pas compiler WeeChat après avoir cloné la base git.
-
-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 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 à 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 :
- * support multi-protocoles via extensions (IRC, Jabber)
- * plusieurs interfaces déportées en plus de Curses (à venir bientôt)
- * disponible en plusieurs langues
- * extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl)
- * tampons avec contenu libre
- * filtrage de l'affichage avec tags et expressions régulières
- * découpage de la fenêtre horizontalement et verticalement
- * barres personnalisables et extensibles
- * liste des pseudos disponible dans toutes les interfaces
- * highlight dans la barre d'infos
- * recherche incrémentale de texte dans les tampons, saut aux highlights
- * tube FIFO pour contrôle à distance
- * support aspell
- * double encodage (décodage/encodage)
- * développé à partir de zéro (non basé sur un quelconque client)
- * multi-platformes
- * 100% GPL et libre
-
- 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 ?
-
-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.
- Si vous démarrez avec WeeChat, il est recommandé de lire le guide de
- démarrage rapide (voir la page de doc sur le site).
-
-
-2.3
-================================================================================
-Q: J'ai entendu parler de "buffers" et "windows", quelle est la
- différence ?
-
-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
- tampon.
- 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.
- 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) :
- 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
- paquet "weechat-plugins")
- - 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 :
- 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
-================================================================================
-Q: Des barres telles que le titre et le statut ne sont pas remplies, la
- couleur de fond s'arrête après le texte, pourquoi ?
-
-R: Cela peut être du à la variable TERM qui n'a pas la bonne valeur
- (regardez echo $TERM).
- Selon la façon de lancer WeeChat, vous devriez avoir :
- - si WeeChat tourne en local ou sur une machiine distante sans screen :
- cela dépend du terminal utilisé : "xterm", "rxvt", ..
- - si WeeChat tourne sous screen, vous devriez avoir "screen".
- Si besoin, corrigez la variable TERM (export TERM="xxx").
-
-
-2.6
-================================================================================
-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).
- Si besoin, corrigez la variable TERM (export TERM="xxx").
-
-
-2.7
-================================================================================
-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
- d'une touche et de l'inclure dans la zone de saisie.
-
-
-2.8
-================================================================================
-Q: Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ?
- Les scripts sont-ils 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/<langage>/).
- Notez que les scripts dans ~/.weechat/<langage>/autoload sont
- automatiquement chargés par WeeChat lorsqu'il démarre.
- Les scripts ne sont pas compatibles avec d'autres clients IRC.
-
-
-2.9
-================================================================================
-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é :
- /shell setenv LANG=en_US.UTF-8
- /upgrade
- (pour avoir des messages anglais avec encodage UTF-8 pour le terminal,
- pour les utilisateurs en ISO, vous pouvez taper:
- /shell setenv LANG=en_US)
-
-
-2.10
-================================================================================
-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
- (comme rxvt-unicode, konsole, etc...).
- Une autre solution est de déplacer la liste des pseudos en haut ou en
- bas, par exemple :
- avec WeeChat <= 0.2.6: /set look_nicklist_position = top
- avec WeeChat >= 0.2.7: /bar set nicklist position top
-
-
-2.11
-================================================================================
-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 :
- 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 :
- 1. vous pouvez nous joindre sur IRC: irc.freenode.net, canal #weechat
- 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 :
- http://weechat.flashtux.org/support.php
- (vous pouvez souscrire et envoyer à la liste de diffusion
- "support")
-
-
-3.2
-================================================================================
-Q: Comment dois-je 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 :
- 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 :
- http://weechat.flashtux.org/support.php
- (vous pouvez souscrire et envoyer à la liste de diffusion
- "support")
-
-
-3.3
-================================================================================
-Q: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ?
-
-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 :
- http://weechat.flashtux.org/support.php
- (vous pouvez souscrire et envoyer à la liste de diffusion
- "support")
-
-
-3.4
-================================================================================
-Q: Quelle est la liste des plate-formes supportées par WeeChat ?
- WeeChat sera-t-il porté sur d'autres systèmes d'exploitation ?
-
-R: La liste complète est sur cette page :
- http://weechat.flashtux.org/download.php?view=supported_os
- Nous faisons le maximum pour supporter le plus de plate-formes possible.
- Toute aide est la bienvenue pour les systèmes que nous n'avons pas,
- pous y tester WeeChat.
-
-
-3.6
-================================================================================
-Q: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ?
-
-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
-
-
-3.7
-================================================================================
-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
+1 - Général
+2 - Compilation / installation
+3 - Utilisation de WeeChat
+4 - Développement
+
+
+------------------------------------------------------------------------------
+1.1: Pourquoi choisir WeeChat ? X-Chat et Irssi sont si bien...
+
+Parce que WeeChat est très léger et a de nouvelles fonctionnalités.
+Quelques fonctionnalités (version >= 0.2.7) :
+ * support multi-protocoles via extensions (IRC, Jabber)
+ * plusieurs interfaces déportées en plus de Curses (à venir bientôt)
+ * disponible en plusieurs langues
+ * extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl)
+ * tampons avec contenu libre
+ * filtrage de l'affichage avec tags et expressions régulières
+ * découpage de la fenêtre horizontalement et verticalement
+ * barres personnalisables et extensibles
+ * liste des pseudos disponible dans toutes les interfaces
+ * recherche incrémentale de texte dans les tampons, saut aux highlights
+ * tube FIFO pour contrôle à distance
+ * support aspell
+ * double encodage (décodage/encodage)
+ * développé à partir de zéro (non basé sur un quelconque client)
+ * multi-platformes
+ * 100% GPL et libre
+Plus d'infos sur cette page : http://weechat.flashtux.org/features.php
+
+
+------------------------------------------------------------------------------
+2.1: J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je
+les compiler/utiliser ?
+
+Aujourd'hui seule l'interface Curses est disponible.
+D'autres interfaces seront disponibles en mode distant (actuellement
+en développement).
+
+
+------------------------------------------------------------------------------
+2.2: Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ?
+
+La méthode recommandée pour compiler WeeChat est d'utiliser cmake.
+Si vous compilez avec les autotools (et non cmake), vérifiez que vous avez bien
+la dernière version d'autoconf et automake (WeeChat est développé avec autoconf
+2.61 et automake 1.10.1).
+Une autre façon de faire est de compiler le "paquet devel", qui nécessite moins
+de dépendences. Ce paquet est construit quasiment tous les jours à partir de la
+base git. Notez que ce paquet peut ne pas correspondre exactement à la base
+git et qu'il est moins pratique que de cloner la base git pour installer des
+mises à jour.
+
+
+------------------------------------------------------------------------------
+3.1: J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ?
+
+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.
+Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage
+rapide (voir la page de doc sur le site).
+
+
+------------------------------------------------------------------------------
+3.2: J'ai entendu parler de "buffers" et "windows", quelle est la différence ?
+
+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 tampon.
+Exemples de tampons : messages serveur, canal, contrôle xfer, etc...
+
+
+------------------------------------------------------------------------------
+3.3: Je ne vois pas bien certains accents dans WeeChat, que faire ?
+
+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) :
+ 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 paquet "weechat-plugins")
+- 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 :
+ 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.
+
+
+------------------------------------------------------------------------------
+3.4: Des barres telles que le titre et le statut ne sont pas remplies, la
+couleur de fond s'arrête après le texte, pourquoi ?
+
+Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez
+echo $TERM).
+Selon la façon de lancer WeeChat, vous devriez avoir :
+- si WeeChat tourne en local ou sur une machine distante sans screen :
+ cela dépend du terminal utilisé : "xterm", "rxvt", etc...
+- si WeeChat tourne sous screen, vous devriez avoir "screen".
+Si besoin, corrigez la variable TERM (export TERM="xxx").
+
+
+------------------------------------------------------------------------------
+3.5: Quand j'utilise weechat sous screen, j'ai des caractères bizarres,
+notamment en changeant de fenêtre, comment corriger ça ?
+
+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).
+Si besoin, corrigez la variable TERM (export TERM="xxx").
+
+
+------------------------------------------------------------------------------
+3.6: Comment puis-je configurer les raccourcis clavier ?
+
+Les raccourcis clavier sont modifiables avec la commande /key.
+La touche par défaut Meta-k (souvent Alt-k) permet de capturer le code d'une
+touche et de l'inclure dans la ligne de commande.
+
+
+------------------------------------------------------------------------------
+3.7: J'utilise OpenBSD et WeeChat ne charge aucune extension, pourquoi ?
+
+Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous
+Linux).
+Vous devez configurer ça :
+- avec WeeChat <= 0.2.6 :
+ /set plugins_extension = ".so.0.0"
+ /plugin autoload
+- avec WeeChat >= 0.2.7 :
+ /set weechat.plugin.extension ".so.0.0"
+ /plugin autoload
+
+
+------------------------------------------------------------------------------
+3.8: Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? Les scripts
+sont-ils compatibles avec d'autres clients IRC ?
+
+Les commandes /perl, /python, /ruby, /lua et /tcl permettent de charger les
+scripts Perl (le chemin par défaut est ~/.weechat/<langage>/).
+Les scripts ne sont pas compatibles avec d'autres clients IRC.
+Notes :
+- les scripts dans ~/.weechat/<langage>/autoload sont automatiquement chargés
+ par WeeChat lorsqu'il démarre.
+- l'extension "tcl" est disponible à partir de la version 0.2.7.
+
+
+------------------------------------------------------------------------------
+3.9: Je souhaite changer la langue des messages affichés par WeeChat, mais sans
+quitter WeeChat, est-ce possible ?
+
+Oui, il faut utiliser le script python shell.py (disponible sur le site de
+WeeChat) et taper ces commandes une fois le script chargé :
+ /shell setenv LANG=fr_FR.UTF-8
+ /upgrade
+Pour avoir des messages anglais avec encodage UTF-8 pour le terminal, pour les
+utilisateurs en ISO, vous pouvez taper :
+ /shell setenv LANG=fr_FR
+
+
+------------------------------------------------------------------------------
+3.10: Avec l'interface Curses, comment puis-je copier/coller du texte sans
+coller la liste des pseudos ?
+
+Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme
+rxvt-unicode, konsole, etc...). La touche est habituellement ctrl + alt +
+sélection à la souris.
+Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par
+exemple :
+- avec WeeChat <= 0.2.6 :
+ /set look_nicklist_position = top
+- avec WeeChat >= 0.2.7 :
+ /bar set nicklist position top
+
+
+------------------------------------------------------------------------------
+3.11: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ?
+
+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 :
+- 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.12: Comment puis-je filter les messages join/part/quit sur les canaux IRC ?
+
+Selon la version de WeeChat :
+- avec WeeChat <= 0.2.6 :
+ /ignore * join #weechat freenode
+ /ignore * part #weechat freenode
+ /ignore * quit #weechat freenode
+ (le canal et/ou le serveur peuvent être "*")
+ (/help ignore pour l'aide)
+- avec WeeChat >= 0.2.7 :
+ - filtre interlligent (pour garder les join/part/quit des utilisateurs qui
+ ont parlé récemment) :
+ /set irc.look.smart_filter on
+ /filter add irc_smart * irc_smart_filter *
+ (/help irc.look.smart_filter et /help filter pour l'aide)
+ - filtre global (pour cacher TOUS les join/part/quit) :
+ /filter add irc_jpk * irc_join,irc_part,irc_quit *
+ (/help filter pour l'aide)
+
+
+------------------------------------------------------------------------------
+4.1: Comment dois-je reporter les bugs ?
+
+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 :
+ 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 :
+ http://weechat.flashtux.org/support.php
+ (vous pouvez souscrire et envoyer à la liste de diffusion nommée
+ "support")
+
+
+------------------------------------------------------------------------------
+4.2: Comment dois-je soumettre les patches ?
+
+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 :
+ 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 :
+ http://weechat.flashtux.org/support.php
+ (vous pouvez souscrire et envoyer à la liste de diffusion nommée
+ "support")
+
+
+------------------------------------------------------------------------------
+4.3: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ?
+
+Il y a 2 manières :
+ 1. vous pouvez nous joindre sur IRC : irc.freenode.net, canal #weechat
+ 2. vous pouvez envoyer un 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 nommée
+ "support")
+
+
+------------------------------------------------------------------------------
+4.4: Quelle est la liste des plate-formes supportées par WeeChat ? Sera-t-il
+porté sur d'autres systèmes d'exploitation ?
+
+La liste complète est sur cette page :
+ http://weechat.flashtux.org/download.php?view=supported_os
+Nous faisons le maximum pour supporter le plus de plate-formes possible.
+Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pous y
+tester WeeChat.
+
+
+------------------------------------------------------------------------------
+4.5: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ?
+
+Il y a plusieurs choses à faire (test, code, documentation, etc...)
+Merci de prendre contact avec nous par IRC ou mail, consultez la page
+support :
+ http://weechat.flashtux.org/support.php
+
+
+------------------------------------------------------------------------------
+4.6: Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ?
+
+Vous pouvez donner de l'argent pour aider le développement.
+Plus de détails sur http://weechat.flashtux.org/donate.php