doc: update chapter on relay unix domain sockets; add translations (user's guide)

6 files changed, 116 insertions, 5 deletions

diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc
index 6d76ae9da..439df866d 100644
--- a/doc/de/weechat_user.de.adoc
+++ b/doc/de/weechat_user.de.adoc
@@ -3270,6 +3270,28 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
 Der Port (im Beispiel: 9000) ist der Port der in der Relay Erweiterung angegeben wurde.
 Die URI muss immer auf "/weechat" enden (_irc_ und _weechat_ Protokoll).
 
+// TRANSLATION MISSING
+[[relay_unix_socket]]
+==== UNIX domain sockets
+
+Using the protocol option "unix" with the `/relay add` command, you can listen
+using any protocol on a UNIX domain socket at a given path. For example:
+
+----
+/relay add unix.weechat %h/relay_socket
+----
+
+This allows clients to connect using the weechat protocol to
+_~/.weechat/relay_socket_. This is particularly useful to allow SSH forwarding
+for relay clients, when other ports cannot be opened. Using OpenSSH:
+
+----
+$ ssh -L 9000:.weechat/relay_socket user@hostname
+----
+
+This redirects local relay clients connecting on port 9000 to the WeeChat
+instance running on "hostname".
+
 [[relay_commands]]
 ==== Befehle
 
diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc
index 1c77b23e3..671cd0627 100644
--- a/doc/en/weechat_user.en.adoc
+++ b/doc/en/weechat_user.en.adoc
@@ -3197,23 +3197,23 @@ The URI must always end with "/weechat" (for _irc_ and _weechat_ protocols).
 [[relay_unix_socket]]
 ==== UNIX domain sockets
 
-Using the protocol option "unix" with the "/relay add" command, you can listen
+Using the protocol option "unix" with the `/relay add` command, you can listen
 using any protocol on a UNIX domain socket at a given path. For example:
 
 ----
 /relay add unix.weechat %h/relay_socket
 ----
 
-This will allow clients to connect using the WeeChat protocol to
+This allows clients to connect using the weechat protocol to
 _~/.weechat/relay_socket_. This is particularly useful to allow SSH forwarding
 for relay clients, when other ports cannot be opened. Using OpenSSH:
 
 ----
-$ ssh -L9000:/home/xxx/.weechat/relay_socket foo_host
+$ ssh -L 9000:.weechat/relay_socket user@hostname
 ----
 
-This will then allow for local relay clients to connect on port 9000 to a
-WeeChat instance running on "foo_host".
+This redirects local relay clients connecting on port 9000 to the WeeChat
+instance running on "hostname".
 
 [[relay_commands]]
 ==== Commands
diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc
index f0651b5f2..083ed2792 100644
--- a/doc/fr/weechat_user.fr.adoc
+++ b/doc/fr/weechat_user.fr.adoc
@@ -3303,6 +3303,29 @@ Le port (9000 dans l'exemple) est le port défini dans l'extension Relay.
 L'URI doit toujours se terminer par "/weechat" (pour les protocoles _irc_ et
 _weechat_).
 
+[[relay_unix_socket]]
+==== UNIX domain sockets
+
+En utilisant l'option de protocole "unix" avec la commande `/relay add`,
+vous pouvez écouter avec n'importe quel protocole sur un socket UNIX et un
+chemin donné. Par exemple :
+
+----
+/relay add unix.weechat %h/relay_socket
+----
+
+Cela autorise les clients à se connecter en utilisant le protocole weechat à
+_~/.weechat/relay_socket_. Cela est utile pour autoriser le "SSH forwarding"
+pour les clients relay, quand d'autres ports ne peuvent pas être ouverts.
+Avec OpenSSH :
+
+----
+$ ssh -L 9000:.weechat/relay_socket user@hostname
+----
+
+Cela redirige les clients relay locaux qui se connectent au port 9000 vers
+l'instance de WeeChat qui tourne sur "hostname".
+
 [[relay_commands]]
 ==== Commandes
 
diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc
index c9f7562e1..a02511480 100644
--- a/doc/it/weechat_user.it.adoc
+++ b/doc/it/weechat_user.it.adoc
@@ -3408,6 +3408,28 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
 The port (9000 in example) is the port defined in Relay plugin.
 The URI must always end with "/weechat" (for _irc_ and _weechat_ protocols).
 
+// TRANSLATION MISSING
+[[relay_unix_socket]]
+==== UNIX domain sockets
+
+Using the protocol option "unix" with the `/relay add` command, you can listen
+using any protocol on a UNIX domain socket at a given path. For example:
+
+----
+/relay add unix.weechat %h/relay_socket
+----
+
+This allows clients to connect using the weechat protocol to
+_~/.weechat/relay_socket_. This is particularly useful to allow SSH forwarding
+for relay clients, when other ports cannot be opened. Using OpenSSH:
+
+----
+$ ssh -L 9000:.weechat/relay_socket user@hostname
+----
+
+This redirects local relay clients connecting on port 9000 to the WeeChat
+instance running on "hostname".
+
 [[relay_commands]]
 ==== Comandi
 
diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc
index 781e7526b..41c4e95a9 100644
--- a/doc/ja/weechat_user.ja.adoc
+++ b/doc/ja/weechat_user.ja.adoc
@@ -3191,6 +3191,28 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
 ポート番号 (例では 9000 番) は Relay プラグインで定義したものです。URI
 の最後には必ず "/weechat" をつけます (_irc_ と _weechat_ プロトコルの場合)。
 
+// TRANSLATION MISSING
+[[relay_unix_socket]]
+==== UNIX domain sockets
+
+Using the protocol option "unix" with the `/relay add` command, you can listen
+using any protocol on a UNIX domain socket at a given path. For example:
+
+----
+/relay add unix.weechat %h/relay_socket
+----
+
+This allows clients to connect using the weechat protocol to
+_~/.weechat/relay_socket_. This is particularly useful to allow SSH forwarding
+for relay clients, when other ports cannot be opened. Using OpenSSH:
+
+----
+$ ssh -L 9000:.weechat/relay_socket user@hostname
+----
+
+This redirects local relay clients connecting on port 9000 to the WeeChat
+instance running on "hostname".
+
 [[relay_commands]]
 ==== コマンド
 
diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc
index b5263ef23..20e53c6be 100644
--- a/doc/pl/weechat_user.pl.adoc
+++ b/doc/pl/weechat_user.pl.adoc
@@ -3228,6 +3228,28 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
 Port (9000 w przykładzie) to port zdefiniowany we wtyczce relay.
 Adres URL musi się zawsze kończyć "/weechat" (dla protokołów _irc_ i _weechat_).
 
+// TRANSLATION MISSING
+[[relay_unix_socket]]
+==== UNIX domain sockets
+
+Using the protocol option "unix" with the `/relay add` command, you can listen
+using any protocol on a UNIX domain socket at a given path. For example:
+
+----
+/relay add unix.weechat %h/relay_socket
+----
+
+This allows clients to connect using the weechat protocol to
+_~/.weechat/relay_socket_. This is particularly useful to allow SSH forwarding
+for relay clients, when other ports cannot be opened. Using OpenSSH:
+
+----
+$ ssh -L 9000:.weechat/relay_socket user@hostname
+----
+
+This redirects local relay clients connecting on port 9000 to the WeeChat
+instance running on "hostname".
+
 [[relay_commands]]
 ==== Komendy