relay: add support of multiple servers on same port for irc protocol (the client must send the server in the "PASS" command)

2 files changed, 82 insertions, 65 deletions

diff --git a/doc/de/autogen/user/relay_commands.txt b/doc/de/autogen/user/relay_commands.txt
index 62fd51502..82433e6d1 100644
--- a/doc/de/autogen/user/relay_commands.txt
+++ b/doc/de/autogen/user/relay_commands.txt
@@ -7,37 +7,39 @@
         raw
         sslcertkey
 
-         list: Auflistung der Relay-Clients (nur aktive Relays)
-     listfull: detaillierte Auflistung der Relay-Clients (alle Relays)
-    listrelay: Auflistung der Relays (Name und Port)
-          add: fügt ein Relay, für ein Protokoll + Name, hinzu
-          del: entfernt Relay für ein Protokoll + Name
-         ipv4: erzwingt die Nutzung von IPv4
-         ipv6: erzwingt die Nutzung von IPv6
-          ssl: aktiviert SSL
-protocol.name: Protokoll und Name des Relay:
-                 - Protokoll "irc": und der Name des Servers welcher geteilt werden soll
-                 - Protokoll "weechat" (Name wird nicht unterstützt)
-         port: Port den das Relay nutzen soll
-          raw: öffnet Buffer mit RAW-Relay Daten
-   sslcertkey: setzt SSL Zertifikat/Schlüssel mittels Eintrag in Option relay.network.ssl_cert_key
+         list: list relay clients (only active relays)
+     listfull: list relay clients (verbose, all relays)
+    listrelay: list relays (name and port)
+          add: add relay for a protocol + name
+          del: remove relay for a protocol + name
+         ipv4: force use of IPv4
+         ipv6: force use of IPv6
+          ssl: enable SSL
+protocol.name: protocol and name to relay:
+                 - protocol "irc": name is the server to share (optional, if not given, the server name must be sent by client in command "PASS", with format: "PASS server:password")
+                 - protocol "weechat" (name is not used)
+         port: port used for relay
+          raw: open buffer with raw Relay data
+   sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
 
-Ohne Angabe von Argumenten werden alle Relay-Clients in einem neuen Buffer dargestellt.
+Without argument, this command opens buffer with list of relay clients.
 
-Beispiele:
-  IRC Proxy für Server "freenode":
+Examples:
+  irc proxy, for server "freenode":
     /relay add irc.freenode 8000
-  IRC Proxy, für Server "freenode", mit SSL:
+  irc proxy, for server "freenode", with SSL:
     /relay add ssl.irc.freenode 8001
-  WeeChat Protokoll:
+  irc proxy, for all servers (client will choose), with SSL:
+    /relay add ssl.irc 8002
+  weechat protocol:
     /relay add weechat 9000
-  WeeChat Protokoll, mit SSL:
+  weechat protocol with SSL:
     /relay add ssl.weechat 9001
-  WeeChat Protokoll, mit SSL, nur IPv4 nutzen:
+  weechat protocol with SSL, using only IPv4:
     /relay add ipv4.ssl.weechat 9001
-  WeeChat Protokoll, mit SSL, nur IPv6 nutzen:
+  weechat protocol with SSL, using only IPv6:
     /relay add ipv6.ssl.weechat 9001
-  WeeChat Protokoll, mit SSL, mit IPv4 + IPv6:
+  weechat protocol with SSL, using IPv4 + IPv6:
     /relay add ipv4.ipv6.ssl.weechat 9001
 ........................................
 
diff --git a/doc/de/weechat_user.de.txt b/doc/de/weechat_user.de.txt
index 521a66468..30ea82e47 100644
--- a/doc/de/weechat_user.de.txt
+++ b/doc/de/weechat_user.de.txt
@@ -2329,49 +2329,22 @@ Befehle
 
 include::autogen/user/relay_commands.txt[]
 
-[[relay_irc_proxy]]
-IRC proxy
-^^^^^^^^^
-
-Die Relay-Erweiterung verhält sich wie ein IRC Proxy: Es kann ein Port als IRC Server
-definiert und ein Passwort für Clients genutzt werden.
-
-Beispiel:
-
-----------------------------------------
-/set relay.network.password "mein Passwort"
-/relay add irc.freenode 8000
-----------------------------------------
-
-Nun kann mittels eines IRC Clients (WeeChat, XChat, irssi, ...) am Port 8000 und dem
-Server-Passwort "mein Passwort" eine Verbindung hergestellt werden.
-
-Die Anzahl an erlaubten Clients kann limitiert werden:
-
-----------------------------------------
-/set relay.network.max_clients 1
-----------------------------------------
-
-[[relay_weechat_protocol]]
-WeeChat Protokoll
-^^^^^^^^^^^^^^^^^
-
-Die Relay-Erweiterung kann Daten, mittels dem WeeChat Protokoll, an eine
-externe Oberfläche senden.
+// TRANSLATION MISSING
+[[relay_password]]
+Password
+^^^^^^^^
 
-Zum Beispiel:
+It is highly recommended to set a password for relay, with command:
 
 ----------------------------------------
 /set relay.network.password "meinPasswort"
-/relay add weechat 9000
 ----------------------------------------
 
-Nun kann man über den Port 9000 mittels einer Oberfläche (wie QWeeChat)
-und dem Passwort "meinPasswort" eine Verbindung zu WeeChat herstellen.
+This password is used for 'irc' and 'weechat' protocols.
 
 [[relay_ssl]]
-Relay-Verbindung mittels SSL
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+SSL
+^^^
 
 Man kann SSL mittels eines selbst erstellten Zertifikates und eines privaten
 Schlüssels nutzen. Um SSL für die Verbindung zu aktivieren stellt man dem
@@ -2396,16 +2369,58 @@ Schlüssel mittels folgendem Befehl nachträglich geladen werden:
 /relay sslcertkey
 ----------------------------------------
 
-um dann die Relay-Verbindung, mit SSL Verschlüsselung, anzulegen:
+// TRANSLATION MISSING
+[[relay_irc_proxy]]
+IRC proxy
+^^^^^^^^^
+
+The Relay plugin can act as an IRC proxy: it will simulate an IRC server, and
+you can connect to WeeChat with any other IRC client (including WeeChat itself).
+
+You can define one port by IRC server, or one generic port for all servers.
+
+When using one port for all servers, the client must send the internal name of
+server in the IRC "PASS" command, with this format:
+
+----------------------------------------
+PASS server:meinPasswort
+----------------------------------------
+
+Example: IRC proxy with SSL for any server (client will choose):
+
+----------------------------------------
+/relay add ssl.irc 8000
+----------------------------------------
+
+Example: IRC proxy without SSL only for server "freenode":
+
+----------------------------------------
+/relay add irc.freenode 8000
+----------------------------------------
+
+Now you can connect on port 8000 with any IRC client using server password
+"meinPasswort" (or "freenode:meinPasswort" if no server was specified in the
+relay).
+
+[[relay_weechat_protocol]]
+WeeChat Protokoll
+^^^^^^^^^^^^^^^^^
+
+Die Relay-Erweiterung kann Daten, mittels dem WeeChat Protokoll, an eine
+externe Oberfläche senden.
+
+Zum Beispiel:
 
 ----------------------------------------
-/relay add ssl.irc.freenode 8001
-/relay add ssl.weechat 9001
+/relay add weechat 9000
 ----------------------------------------
 
+Nun kann man über den Port 9000 mittels einer Oberfläche und dem Passwort
+"meinPasswort" eine Verbindung zu WeeChat herstellen.
+
 // TRANSLATION MISSING
 [[relay_websocket]]
-Websocket
+WebSocket
 ^^^^^^^^^
 
 WebSocket protocol (http://tools.ietf.org/html/rfc6455[RFC 6455]) is supported
@@ -2420,11 +2435,11 @@ A WebSocket can be opened in a HTML5 with a single line of JavaScript:
 
 [source,js]
 ----------------------------------------
-websocket = new WebSocket("ws://server.com:5000/weechat");
+websocket = new WebSocket("ws://server.com:9000/weechat");
 ----------------------------------------
 
-The port (5000 in example) is the port defined in Relay plugin.
-The URI must always ends with "/weechat" (for both IRC and WeeChat protocols).
+The port (9000 in example) is the port defined in Relay plugin.
+The URI must always end with "/weechat" (for 'irc' and 'weechat' protocols).
 
 [[rmodifier_plugin]]
 Rmodifier Erweiterung