doc/user: add chapter on cursor mode (issue #1282)

doc/de/weechat_user.de.adoc

@@ -1456,6 +1456,22 @@ Optionen:
 
 include::{autogendir}/autogen_user_options.de.adoc[tag=buflist_options]
 
+// TRANSLATION MISSING
+[[cursor_mode]]
+=== Cursor mode
+
+The cursor mode allows you to move freely the cursor anywhere on screen, in chat
+area and bars, and lets you perform actions at the given position. +
+You can enter in cursor mode either with the command `/cursor` or with a mouse
+middle click (mouse must have been enabled with key kbd:[Alt+m] or command
+`/mouse enable`).
+
+Typical use is to quote messages (chat area) or interact with nicks (nicklist bar).
+
+See command <<command_weechat_cursor,/cursor>> and
+<<key_bindings_cursor_context,key bindings in cursor context>> for the list
+of actions you can perform in this mode.
+
 [[key_bindings]]
 == Tastenbelegungen
 
@@ -1678,7 +1694,9 @@ in einem Buffer nach einem Text zu suchen).
 [[key_bindings_cursor_context]]
 === Cursor-Kontext
 
-Diese Tasten werden im Kontext "cursor" verwendet (Cursor kann frei auf dem Bildschirm bewegt werden)
+// TRANSLATION MISSING
+Diese Tasten werden im Kontext "cursor" verwendet (Cursor kann frei auf dem Bildschirm bewegt werden),
+see <<cursor_mode,Cursor mode>>.
 
 [width="100%",cols="^.^3,^.^2,.^7,.^7",options="header"]
 |===

doc/en/weechat_user.en.adoc

@@ -1440,6 +1440,21 @@ Options:
 
 include::{autogendir}/autogen_user_options.en.adoc[tag=buflist_options]
 
+[[cursor_mode]]
+=== Cursor mode
+
+The cursor mode allows you to move freely the cursor anywhere on screen, in chat
+area and bars, and lets you perform actions at the given position. +
+You can enter in cursor mode either with the command `/cursor` or with a mouse
+middle click (mouse must have been enabled with key kbd:[Alt+m] or command
+`/mouse enable`).
+
+Typical use is to quote messages (chat area) or interact with nicks (nicklist bar).
+
+See command <<command_weechat_cursor,/cursor>> and
+<<key_bindings_cursor_context,key bindings in cursor context>> for the list
+of actions you can perform in this mode.
+
 [[key_bindings]]
 == Key bindings
 
@@ -1662,7 +1677,8 @@ text in buffer).
 [[key_bindings_cursor_context]]
 === Cursor context
 
-These keys are used in context "cursor" (free movement of cursor on screen).
+These keys are used in context "cursor" (free movement of cursor on screen),
+see <<cursor_mode,Cursor mode>>.
 
 [width="100%",cols="^.^3,^.^2,.^7,.^7",options="header"]
 |===

doc/fr/weechat_user.fr.adoc

@@ -1473,6 +1473,23 @@ Options :
 
 include::{autogendir}/autogen_user_options.fr.adoc[tag=buflist_options]
 
+[[cursor_mode]]
+=== Mode curseur
+
+Le mode curseur vous permet de déplacer librement le curseur partout sur l'écran,
+dans la zone de discussion et les barres, et vous permet d'effectuer des actions
+à la position donnée. +
+Vous pouvez entrer dans le mode curseur avec la commande `/cursor` ou avec un
+clic du milieu sur la souris (la souris doit avoir été activée avec la touche
+kbd:[Alt+m] ou la commande `/mouse enable`).
+
+L'utilisation typique est de citer des messages (zone de discussion) ou d'interagir
+avec des pseudos (barre avec la liste de pseudos).
+
+Voir la commande <<command_weechat_cursor,/cursor>> et
+<<key_bindings_cursor_context,les touches du contexte curseur>> pour la liste
+des actions que vous pouvez effectuer dans ce mode.
+
 [[key_bindings]]
 == Raccourcis clavier
 
@@ -1698,7 +1715,7 @@ pressé pour chercher du texte dans le tampon).
 === Contexte curseur
 
 Ces touches sont utilisées dans le contexte "cursor" (mouvement libre du curseur
-à l'écran).
+à l'écran), voir le <<cursor_mode,Mode curseur>>.
 
 [width="100%",cols="^.^3,^.^2,.^7,.^7",options="header"]
 |===

doc/it/weechat_user.it.adoc

@@ -1563,6 +1563,22 @@ Options:
 
 include::{autogendir}/autogen_user_options.it.adoc[tag=buflist_options]
 
+// TRANSLATION MISSING
+[[cursor_mode]]
+=== Cursor mode
+
+The cursor mode allows you to move freely the cursor anywhere on screen, in chat
+area and bars, and lets you perform actions at the given position. +
+You can enter in cursor mode either with the command `/cursor` or with a mouse
+middle click (mouse must have been enabled with key kbd:[Alt+m] or command
+`/mouse enable`).
+
+Typical use is to quote messages (chat area) or interact with nicks (nicklist bar).
+
+See command <<command_weechat_cursor,/cursor>> and
+<<key_bindings_cursor_context,key bindings in cursor context>> for the list
+of actions you can perform in this mode.
+
 // TRANSLATION MISSING
 [[key_bindings]]
 == Key bindings
@@ -1833,8 +1849,9 @@ kbd:[Ctrl+r] per cercare del testo nel buffer).
 [[key_bindings_cursor_context]]
 === Cursor context
 
+// TRANSLATION MISSING
 Questi tasti sono usati nel contesto "cursor" (movimento libero del cursore
-sullo schermo.
+sullo schermo, see <<cursor_mode,Cursor mode>>.
 
 [width="100%",cols="^.^3,^.^2,.^7,.^7",options="header"]
 |===

doc/ja/weechat_user.ja.adoc

@@ -1521,6 +1521,22 @@ _buflist.conf_ ファイル内のセクション:
 
 include::{autogendir}/autogen_user_options.ja.adoc[tag=buflist_options]
 
+// TRANSLATION MISSING
+[[cursor_mode]]
+=== Cursor mode
+
+The cursor mode allows you to move freely the cursor anywhere on screen, in chat
+area and bars, and lets you perform actions at the given position. +
+You can enter in cursor mode either with the command `/cursor` or with a mouse
+middle click (mouse must have been enabled with key kbd:[Alt+m] or command
+`/mouse enable`).
+
+Typical use is to quote messages (chat area) or interact with nicks (nicklist bar).
+
+See command <<command_weechat_cursor,/cursor>> and
+<<key_bindings_cursor_context,key bindings in cursor context>> for the list
+of actions you can perform in this mode.
+
 // TRANSLATION MISSING
 [[key_bindings]]
 == Key bindings
@@ -1778,7 +1794,9 @@ kbd:[Ctrl+r] が押された状態) でのみ有効です。
 [[key_bindings_cursor_context]]
 === Cursor context
 
-以下のキーは「カーソル」モード (画面上でカーソルを自由に動かせる状態) でのみ有効です。
+// TRANSLATION MISSING
+以下のキーは「カーソル」モード (画面上でカーソルを自由に動かせる状態) でのみ有効です,
+see <<cursor_mode,Cursor mode>>.
 
 [width="100%",cols="^.^3,^.^2,.^7,.^7",options="header"]
 |===

doc/pl/weechat_user.pl.adoc

@@ -1449,6 +1449,22 @@ Opcje:
 
 include::{autogendir}/autogen_user_options.pl.adoc[tag=buflist_options]
 
+// TRANSLATION MISSING
+[[cursor_mode]]
+=== Cursor mode
+
+The cursor mode allows you to move freely the cursor anywhere on screen, in chat
+area and bars, and lets you perform actions at the given position. +
+You can enter in cursor mode either with the command `/cursor` or with a mouse
+middle click (mouse must have been enabled with key kbd:[Alt+m] or command
+`/mouse enable`).
+
+Typical use is to quote messages (chat area) or interact with nicks (nicklist bar).
+
+See command <<command_weechat_cursor,/cursor>> and
+<<key_bindings_cursor_context,key bindings in cursor context>> for the list
+of actions you can perform in this mode.
+
 [[key_bindings]]
 == Skróty klawiszowe
 
@@ -1671,8 +1687,9 @@ zostanie wciśnięta w buforze tekstowym).
 [[key_bindings_cursor_context]]
 === Kursor
 
+// TRANSLATION MISSING
 Te skróty są używane w kontekście kursora (dowolne przemieszczanie kursora na
-ekranie).
+ekranie), see <<cursor_mode,Cursor mode>>.
 
 [width="100%",cols="^.^3,^.^2,.^7,.^7",options="header"]
 |===

doc/sr/weechat_user.sr.adoc

@@ -1354,6 +1354,22 @@ include::{autogendir}/autogen_user_commands.sr.adoc[tag=buflist_commands]
 
 include::{autogendir}/autogen_user_options.sr.adoc[tag=buflist_options]
 
+// TRANSLATION MISSING
+[[cursor_mode]]
+=== Cursor mode
+
+The cursor mode allows you to move freely the cursor anywhere on screen, in chat
+area and bars, and lets you perform actions at the given position. +
+You can enter in cursor mode either with the command `/cursor` or with a mouse
+middle click (mouse must have been enabled with key kbd:[Alt+m] or command
+`/mouse enable`).
+
+Typical use is to quote messages (chat area) or interact with nicks (nicklist bar).
+
+See command <<command_weechat_cursor,/cursor>> and
+<<key_bindings_cursor_context,key bindings in cursor context>> for the list
+of actions you can perform in this mode.
+
 [[key_bindings]]
 == Тастерске пречице
 
@@ -1576,7 +1592,9 @@ WeeChat нуди доста подразумеваних тастерских п
 [[key_bindings_cursor_context]]
 === Контекст курсора
 
-Ови тастери се користе у „cursor” контексту (слободно померање курсора по екрану).
+// TRANSLATION MISSING
+Ови тастери се користе у „cursor” контексту (слободно померање курсора по екрану),
+see <<cursor_mode,Cursor mode>>.
 
 [width="100%", cols="^.^3,^.^2,.^7,.^7", options="header"]
 |===