doc: add mouse support in user guide

1 files changed, 94 insertions, 17 deletions

diff --git a/doc/it/weechat_user.it.txt b/doc/it/weechat_user.it.txt
index d3a5eb3fc..3c0890bd3 100644
--- a/doc/it/weechat_user.it.txt
+++ b/doc/it/weechat_user.it.txt
@@ -600,6 +600,83 @@ These keys are used in context "mouse", namely when a mouse event occurs.
 | ◽◾◽     | -            | anywhere | Start cursor mode at this point | /cursor go ${_x},${_y}
 |========================================
 
+// TRANSLATION MISSING
+[[mouse]]
+Mouse support
+~~~~~~~~~~~~~
+
+WeeChat supports mouse clicks and gestures. It is working with local terminal,
+and remotely via ssh connection with or without under screen/tmux.
+
+[[mouse_enable]]
+Enable mouse
+^^^^^^^^^^^^
+
+To enable mouse at startup:
+
+----------------------------------------
+/set weechat.look.mouse on
+----------------------------------------
+
+To enable mouse now, press @k(A-)@k(m) or do following command:
+
+----------------------------------------
+/mouse enable
+----------------------------------------
+
+It is possible to temporarily disable mouse, and bind that on a key. For example
+key @k(A-)@k(x) to disable mouse for 10 seconds:
+
+----------------------------------------
+/key bind meta-x /mouse toggle 10
+----------------------------------------
+
+When mouse is enabled in WeeChat, you can use "shift" modifier to select or
+click in terminal, as if the mouse was disabled (on some terminals like iTerm,
+you have to use "alt" instead of "shift").
+
+[NOTE]
+For any problem with mouse, please look at 'WeeChat FAQ'.
+
+[[mouse_bind_events]]
+Bind mouse events to commands
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Many default mouse events are already defined by WeeChat (see
+<<key_bindings_mouse_context,keys for "mouse" context>>).
+
+You can change or add bindings with the command `/key` using context "mouse"
+(for syntax, see <<command_weechat_key,command /key>>).
+
+List of events supported:
+
+[width="80%",cols="3m,4",options="header"]
+|========================================
+| Event                            | Description
+| button1                          | click on left button
+| button2                          | click on right button
+| button3                          | click on middle button (often click on wheel)
+| button4 ... button9              | click on extra buttons
+| wheelup                          | wheel (up)
+| wheeldown                        | wheel (down)
+| buttonX-gesture-up ^(1)^         | gesture with distance between 3 and 19
+| buttonX-gesture-up-long ^(1)^    | gesture with distance >= 20
+| buttonX-gesture-down ^(1)^       | gesture with distance between 3 and 19
+| buttonX-gesture-down-long ^(1)^  | gesture with distance >= 20
+| buttonX-gesture-left ^(1)^       | gesture with distance between 3 and 39
+| buttonX-gesture-left-long ^(1)^  | gesture with distance >= 40
+| buttonX-gesture-right ^(1)^      | gesture with distance between 3 and 39
+| buttonX-gesture-right-long ^(1)^ | gesture with distance >= 40
+|========================================
+
+[NOTE]
+^(1)^ "X" is number of button used in gesture (1 to 9).
+
+[TIP]
+When binding a key in context "mouse", it's possible to match many events using
+`*` at beginning or end of name, for example `button1-gesture-*` will match any
+gesture made using left button.
+
 [[command_line]]
 Riga di comando
 ~~~~~~~~~~~~~~~
@@ -694,18 +771,6 @@ e "a tutti" in rosso chiaro sottolineato:
 ^Cc12^Cbciao ^Cb^Cc04^Cua tutti^Cu^Cc !
 ----------------------------------------
 
-[[weechat_options]]
-Opzioni di WeeChat (weechat.conf)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-include::autogen/user/weechat_options.txt[]
-
-[[weechat_commands]]
-Comandi di WeeChat
-~~~~~~~~~~~~~~~~~~
-
-include::autogen/user/weechat_commands.txt[]
-
 [[colors]]
 Colori
 ~~~~~~
@@ -830,9 +895,9 @@ Attributi
 Esistono alcuni attributi per i colori. Uno o più attributi vanno aggiunti prima
 del nome o del numero del colore:
 
-* "*": testo in grassetto
-* "!": video inverso
-* "_": testo sottolineato
+* `*`: testo in grassetto
+* `!`: video inverso
+* `_`: testo sottolineato
 
 Ad esempio se si vuole il proprio nick bianco e sottolineato:
 
@@ -857,6 +922,18 @@ Esempio di grassetto con il colore di primo piano del terminale:
 /set weechat.color.status_time *99999
 ----------------------------------------
 
+[[weechat_options]]
+Opzioni di WeeChat (weechat.conf)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+include::autogen/user/weechat_options.txt[]
+
+[[weechat_commands]]
+Comandi di WeeChat
+~~~~~~~~~~~~~~~~~~
+
+include::autogen/user/weechat_commands.txt[]
+
 
 [[plugins]]
 Plugin
@@ -1765,7 +1842,7 @@ Il plugin Rmodifier consente di cambiare le stringhe del modificatore
 utilizzando le espressioni regolari. Si usa tipicamente per nascondere la
 password quando viene digitata, o quando WeeChat la salva nella cronologia dei
 comandi. Ad esempio, è possibile sostituire ogni carattere in questa password
-con "*".
+con `*`.
 
 [[rmodifier_options]]
 Opzioni (rmodifier.conf)
@@ -1797,7 +1874,7 @@ Per ogni gruppo catturato, sono consentite le seguenti azioni:
 
 * mantenere il gruppo così com'è (usando un numero per gruppo)
 * sostituire tutti i caratteri nel gruppo per nascondere il contenuto (numero
-  del gruppo + "*")
+  del gruppo + `*`)
 * rimuovere il gruppo (se il gruppo non viene utilizzato nella stringa)
 
 Esempio di rmodifier predefinito per il comando `/oper`: