6 files changed, 41 insertions, 20 deletions
diff --git a/doc/de/weechat_user.de.asciidoc b/doc/de/weechat_user.de.asciidoc
index 9b2d02b4e..3da225703 100644
--- a/doc/de/weechat_user.de.asciidoc
+++ b/doc/de/weechat_user.de.asciidoc
@@ -1321,9 +1321,13 @@ key[alt-x] die Mausunterstützung für 10 Sekunden deaktiviert werden:
 /key bind meta-x /mouse toggle 10
 ----
 
-Ist die Mausunterstützung aktiviert kann man mittels gedrückter key[shift]-Taste (Umschalttaste)
-Text im Terminal markieren oder einfügen, als ob die Mausunterstützung deaktiviert sei (bei
-einigen Terminals muss die key[alt]-Taste anstelle der key[shift]-Taste gedrückt werden).
+// TRANSLATION MISSING
+[IMPORTANT]
+When mouse is enabled in WeeChat, all mouse events are caught by WeeChat, so
+actions such as copy/paste or clicks on URLs are not sent to the terminal. +
+Using key[shift] key causes the events to be sent directly to the terminal,
+as if the mouse was disabled (on some terminals like iTerm, you have to use
+key[alt] instead of key[shift]).
 
 [NOTE]
 Sollten Probleme bei der Mausunterstützung auftreten, dann sollte Bitte die 'WeeChat FAQ' gelesen werden.
diff --git a/doc/en/weechat_user.en.asciidoc b/doc/en/weechat_user.en.asciidoc
index 2c25c8048..8cd7a92fb 100644
--- a/doc/en/weechat_user.en.asciidoc
+++ b/doc/en/weechat_user.en.asciidoc
@@ -1295,9 +1295,12 @@ key key[alt-x] to disable mouse for 10 seconds:
 /key bind meta-x /mouse toggle 10
 ----
 
-When mouse is enabled in WeeChat, you can use key[shift] modifier to select or
-click in terminal, as if the mouse was disabled (on some terminals like iTerm,
-you have to use key[alt] instead of key[shift]).
+[IMPORTANT]
+When mouse is enabled in WeeChat, all mouse events are caught by WeeChat, so
+actions such as copy/paste or clicks on URLs are not sent to the terminal. +
+Using key[shift] key causes the events to be sent directly to the terminal,
+as if the mouse was disabled (on some terminals like iTerm, you have to use
+key[alt] instead of key[shift]).
 
 [NOTE]
 For any problem with mouse, please look at 'WeeChat FAQ'.
diff --git a/doc/fr/weechat_user.fr.asciidoc b/doc/fr/weechat_user.fr.asciidoc
index be91f80f9..7fb99869b 100644
--- a/doc/fr/weechat_user.fr.asciidoc
+++ b/doc/fr/weechat_user.fr.asciidoc
@@ -1329,10 +1329,13 @@ secondes :
 /key bind meta-x /mouse toggle 10
 ----
 
-Lorsque la souris est activée dans WeeChat, vous pouvez utiliser la touche
-key[shift] pour sélectionner ou cliquer dans le terminal, comme si la souris était
-désactivée (sous certains terminaux comme iTerm, vous devez utiliser key[alt] au
-lieu de key[shift]).
+[IMPORTANT]
+Lorsque la souris est activée dans WeeChat, tous les évènements souris sont
+capturés par WeeChat, donc les actions comme le copier/coller et les clics sur
+les URLs ne sont pas envoyées au terminal. +
+Utiliser la touche key[shift] permet d'envoyer directement les évènements au
+terminal, comme si la souris était désactivée (sous certains terminaux comme
+iTerm, vous devez utiliser key[alt] au lieu de key[shift]).
 
 [NOTE]
 Pour tout problème avec la souris, merci de consulter la 'FAQ WeeChat'.
diff --git a/doc/it/weechat_user.it.asciidoc b/doc/it/weechat_user.it.asciidoc
index 45a30edc0..da233209f 100644
--- a/doc/it/weechat_user.it.asciidoc
+++ b/doc/it/weechat_user.it.asciidoc
@@ -1361,10 +1361,13 @@ tasto. Ad esempio il tasto key[alt-x] per disabilitare il mouse per 10 secondi:
 /key bind meta-x /mouse toggle 10
 ----
 
-Quando il mouse è abilitato in WeeChat, è possibile usare il modificatore
-key[shift] per selezionare o cliccare nel terminale, come se il mouse fosse
-disabilitato (in alcuni terminali come iTerm, bisogna usare key[alt] invece di
-key[shift]).
+// TRANSLATION MISSING
+[IMPORTANT]
+When mouse is enabled in WeeChat, all mouse events are caught by WeeChat, so
+actions such as copy/paste or clicks on URLs are not sent to the terminal. +
+Using key[shift] key causes the events to be sent directly to the terminal,
+as if the mouse was disabled (on some terminals like iTerm, you have to use
+key[alt] instead of key[shift]).
 
 [NOTE]
 Per qualunque problema con il mouse, consultare 'FAQ di WeeChat'.
diff --git a/doc/ja/weechat_user.ja.asciidoc b/doc/ja/weechat_user.ja.asciidoc
index 275766655..e629b732f 100644
--- a/doc/ja/weechat_user.ja.asciidoc
+++ b/doc/ja/weechat_user.ja.asciidoc
@@ -1298,9 +1298,13 @@ key[alt-x] キーにマウスを 10 秒間無効化する機能を割り当て�
 /key bind meta-x /mouse toggle 10
 ----
 
-WeeChat でマウスが有効化されている場合、key[shift]
-修飾キーで選択やクリックができます。これでマウスが無効化されている場合と同じ作業が行えます
-(iTerm 等の端末では key[shift] の代わりに key[alt] を使ってください)。
+// TRANSLATION MISSING
+[IMPORTANT]
+When mouse is enabled in WeeChat, all mouse events are caught by WeeChat, so
+actions such as copy/paste or clicks on URLs are not sent to the terminal. +
+Using key[shift] key causes the events to be sent directly to the terminal,
+as if the mouse was disabled (on some terminals like iTerm, you have to use
+key[alt] instead of key[shift]).
 
 [NOTE]
 マウスに関するトラブルがあれば 'WeeChat FAQ' を参照してください。
diff --git a/doc/pl/weechat_user.pl.asciidoc b/doc/pl/weechat_user.pl.asciidoc
index ff88570a9..9d280efb8 100644
--- a/doc/pl/weechat_user.pl.asciidoc
+++ b/doc/pl/weechat_user.pl.asciidoc
@@ -1308,9 +1308,13 @@ przykład skrót key[alt-x] wyłączający obsługę myszy na 10 sekund:
 /key bind meta-x /mouse toggle 10
 ----
 
-Kiedy obsługa myszy jest włączona w WeeChat, można użyć modyfikatora key[shift] do
-zaznaczenia lub kliknięcia w terminalu, tak jakby obsługa myszy była wyłączona
-(w niektórych terminalach jak iTerm należy użyć key[alt] zamiast key[shift]).
+// TRANSLATION MISSING
+[IMPORTANT]
+When mouse is enabled in WeeChat, all mouse events are caught by WeeChat, so
+actions such as copy/paste or clicks on URLs are not sent to the terminal. +
+Using key[shift] key causes the events to be sent directly to the terminal,
+as if the mouse was disabled (on some terminals like iTerm, you have to use
+key[alt] instead of key[shift]).
 
 [NOTE]
 W razie jakichkolwiek problemów z obsługą myszy, zajrzyj do 'WeeChat FAQ'.