doc: add mouse questions in FAQ

5 files changed, 235 insertions, 0 deletions

diff --git a/doc/de/weechat_faq.de.txt b/doc/de/weechat_faq.de.txt
index 3d50d58cc..6f030b6f5 100644
--- a/doc/de/weechat_faq.de.txt
+++ b/doc/de/weechat_faq.de.txt
@@ -446,6 +446,54 @@ Die Tasten "meta2-A" und "meta2-B" können nach dem jeweils genutzten Terminal v
 korrekten Tasten zu finden sollte man @k(A-)@k(k) und dann (Up- oder die Down-Taste) drücken.
 
 
+// TRANSLATION MISSING
+[[mouse]]
+Mouse
+-----
+
+
+// TRANSLATION MISSING
+[[mouse_not_working]]
+Mouse is not working at all, what can I do?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+First try to enable mouse:
+
+----------------------------------------
+/mouse enable
+----------------------------------------
+
+If mouse is still not working, check the TERM variable in your shell (look at
+output of `echo $TERM` in your terminal).
+According to terminfo used, mouse may not be supported.
+
+You can test mouse support in terminal:
+
+----------------------------------------
+$ printf '\033[?1002h'
+----------------------------------------
+
+And then click on first char of terminal (upper left). You should see " !!#!!".
+
+To disable mouse in terminal:
+
+----------------------------------------
+$ printf '\033[?1002l'
+----------------------------------------
+
+
+// TRANSLATION MISSING
+[[mouse_coords]]
+Mouse does nothing for X or Y greater than 94, why?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some terminals are sending only ISO chars for mouse coordinates, so it does not
+work for X/Y greater than 94.
+
+You should use a terminal that supports UTF-8 coordinates for mouse, like
+rxvt-unicode.
+
+
 [[irc]]
 IRC
 ---
diff --git a/doc/en/weechat_faq.en.txt b/doc/en/weechat_faq.en.txt
index 08b2892b2..dfaf38b8a 100644
--- a/doc/en/weechat_faq.en.txt
+++ b/doc/en/weechat_faq.en.txt
@@ -425,6 +425,51 @@ Keys "meta2-A" and "meta2-B" may be different in your terminal. To find key
 code press @k(A-)@k(k) then key (up or down).
 
 
+[[mouse]]
+Mouse
+-----
+
+
+[[mouse_not_working]]
+Mouse is not working at all, what can I do?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+First try to enable mouse:
+
+----------------------------------------
+/mouse enable
+----------------------------------------
+
+If mouse is still not working, check the TERM variable in your shell (look at
+output of `echo $TERM` in your terminal).
+According to terminfo used, mouse may not be supported.
+
+You can test mouse support in terminal:
+
+----------------------------------------
+$ printf '\033[?1002h'
+----------------------------------------
+
+And then click on first char of terminal (upper left). You should see " !!#!!".
+
+To disable mouse in terminal:
+
+----------------------------------------
+$ printf '\033[?1002l'
+----------------------------------------
+
+
+[[mouse_coords]]
+Mouse does nothing for X or Y greater than 94, why?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some terminals are sending only ISO chars for mouse coordinates, so it does not
+work for X/Y greater than 94.
+
+You should use a terminal that supports UTF-8 coordinates for mouse, like
+rxvt-unicode.
+
+
 [[irc]]
 IRC
 ---
diff --git a/doc/fr/weechat_faq.fr.txt b/doc/fr/weechat_faq.fr.txt
index 330637d4a..27f2933eb 100644
--- a/doc/fr/weechat_faq.fr.txt
+++ b/doc/fr/weechat_faq.fr.txt
@@ -442,6 +442,52 @@ Pour trouver le code de la touche appuyez sur @k(A-)@k(k) puis la touche (haut
 ou bas).
 
 
+[[mouse]]
+Souris
+------
+
+
+[[mouse_not_working]]
+La souris ne fonctionne pas du tout, que puis-je faire ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Premièrement essayez d'activer la souris :
+
+----------------------------------------
+/mouse enable
+----------------------------------------
+
+Si la souris ne fonctionne toujours pas, vérifiez la variable TERM dans votre
+shell (regardez la sortie de `echo $TERM` dans votre terminal).
+Selon le terminfo utilisé, la souris peut ne pas être supportée.
+
+Vous pouvez tester le support de la souris dans le terminal :
+
+----------------------------------------
+$ printf '\033[?1002h'
+----------------------------------------
+
+Et cliquez sur le premier caractère du terminal (en haut à gauche). Vous devriez
+voir " !!#!!".
+
+Pour désactiver la souris dans le terminal :
+
+----------------------------------------
+$ printf '\033[?1002l'
+----------------------------------------
+
+
+[[mouse_coords]]
+La souris ne fait rien pour un X ou Y supérieur à 94, pourquoi ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Certains terminaux envoient seulement des caractères ISO pour les coordonnées
+de la souris, donc cela ne fonctionne pas avec un X/Y supérieur à 94.
+
+Vous devriez utiliser un terminal qui supporte les coordonnées UTF-8 pour la
+souris, comme rxvt-unicode.
+
+
 [[irc]]
 IRC
 ---
diff --git a/doc/it/weechat_faq.it.txt b/doc/it/weechat_faq.it.txt
index 4ac0bfd33..fc7a12166 100644
--- a/doc/it/weechat_faq.it.txt
+++ b/doc/it/weechat_faq.it.txt
@@ -438,6 +438,54 @@ I tasti "meta2-A" e "meta2-B" possono essere differenti nel proprio terminale.
 Per trovare il codice tasto digitare @k(A-)@k(k) poi il tast (su o giù).
 
 
+// TRANSLATION MISSING
+[[mouse]]
+Mouse
+-----
+
+
+// TRANSLATION MISSING
+[[mouse_not_working]]
+Mouse is not working at all, what can I do?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+First try to enable mouse:
+
+----------------------------------------
+/mouse enable
+----------------------------------------
+
+If mouse is still not working, check the TERM variable in your shell (look at
+output of `echo $TERM` in your terminal).
+According to terminfo used, mouse may not be supported.
+
+You can test mouse support in terminal:
+
+----------------------------------------
+$ printf '\033[?1002h'
+----------------------------------------
+
+And then click on first char of terminal (upper left). You should see " !!#!!".
+
+To disable mouse in terminal:
+
+----------------------------------------
+$ printf '\033[?1002l'
+----------------------------------------
+
+
+// TRANSLATION MISSING
+[[mouse_coords]]
+Mouse does nothing for X or Y greater than 94, why?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some terminals are sending only ISO chars for mouse coordinates, so it does not
+work for X/Y greater than 94.
+
+You should use a terminal that supports UTF-8 coordinates for mouse, like
+rxvt-unicode.
+
+
 [[irc]]
 IRC
 ---
diff --git a/doc/pl/weechat_faq.pl.txt b/doc/pl/weechat_faq.pl.txt
index bf6deee08..368595552 100644
--- a/doc/pl/weechat_faq.pl.txt
+++ b/doc/pl/weechat_faq.pl.txt
@@ -434,6 +434,54 @@ Klawisze "meta2-A" i "meta2-B" mogą być inne dla twojego treminala. W celu
 znalezienia ich kodów wciśnij @k(A-)@k(k) następnie przycisk (góra lub dół).
 
 
+// TRANSLATION MISSING
+[[mouse]]
+Mouse
+-----
+
+
+// TRANSLATION MISSING
+[[mouse_not_working]]
+Mouse is not working at all, what can I do?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+First try to enable mouse:
+
+----------------------------------------
+/mouse enable
+----------------------------------------
+
+If mouse is still not working, check the TERM variable in your shell (look at
+output of `echo $TERM` in your terminal).
+According to terminfo used, mouse may not be supported.
+
+You can test mouse support in terminal:
+
+----------------------------------------
+$ printf '\033[?1002h'
+----------------------------------------
+
+And then click on first char of terminal (upper left). You should see " !!#!!".
+
+To disable mouse in terminal:
+
+----------------------------------------
+$ printf '\033[?1002l'
+----------------------------------------
+
+
+// TRANSLATION MISSING
+[[mouse_coords]]
+Mouse does nothing for X or Y greater than 94, why?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some terminals are sending only ISO chars for mouse coordinates, so it does not
+work for X/Y greater than 94.
+
+You should use a terminal that supports UTF-8 coordinates for mouse, like
+rxvt-unicode.
+
+
 [[irc]]
 IRC
 ---