relay: don't remove relay from config when the binding fails (closes #225), add options "stop" and "restart" in command /relay

1 files changed, 34 insertions, 26 deletions

diff --git a/doc/ja/autogen/user/relay_commands.asciidoc b/doc/ja/autogen/user/relay_commands.asciidoc
index 6c03dab56..c7f6c2887 100644
--- a/doc/ja/autogen/user/relay_commands.asciidoc
+++ b/doc/ja/autogen/user/relay_commands.asciidoc
@@ -3,44 +3,52 @@
 
 ----
 /relay  list|listfull|listrelay
-        add [ipv4.][ipv6.][ssl.]<protocol.name> <port>
-        del [ipv4.][ipv6.][ssl.]<protocol.name>
+        add <name> <port>
+        del|stop|restart <name>
         raw
         sslcertkey
 
-         list: リレーするクライアントをリストアップ (アクティブなもののみ)
-     listfull: リレーするクライアントをリストアップ (詳細、全てのリレー)
-    listrelay: リレーをリストアップ (名前とポート番号)
-          add: プロトコル + 名前のリレーを追加
-          del: プロトコル + 名前のリレーを削除
-         ipv4: IPv4 を強制的に利用
-         ipv6: IPv6 を強制的に利用
-          ssl: SSL を有効化
-protocol.name: リレーするプロトコルと名前:
-                 - protocol "irc": name は共有するサーバ名 (任意指定、指定しない場合、サーバ名は "PASS" コマンドでクライアントが送信するものと同じでなければいけません、"PASS" コマンドのフォーマットは "PASS server:password")
-                 - protocol "weechat" (name は使われません)
-         port: リレーに使うポート番号
-          raw: 生 Relay データバッファを開く
-   sslcertkey: オプション relay.network.ssl_cert_key のパスを使って SSL 証明書/鍵を設定
+         list: list relay clients (only active relays)
+     listfull: list relay clients (verbose, all relays)
+    listrelay: list relays (name and port)
+          add: add a relay (listen on a port)
+          del: remove a relay (clients remain connected)
+         stop: close the server socket (clients remain connected)
+      restart: close the server socket and listen again on port (clients remain connected)
+         name: relay name (see format below)
+         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
 
-引数無しの場合、リレークライアントのリストを含むバッファを開く
+Relay name is: [ipv4.][ipv6.][ssl.]<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)
 
-例:
-  サーバ "freenode" に対する irc プロキシを設定:
+The "irc" protocol allows any IRC client (including WeeChat itself) to connect on the port.
+The "weechat" protocol allows a remote interface to connect on the port, see the list here: http://weechat.org/download/
+
+Without argument, this command opens buffer with list of relay clients.
+
+Examples:
+  irc proxy, for server "freenode":
     /relay add irc.freenode 8000
-  サーバ "freenode" に対する SSL を有効化した irc プロキシを設定:
+  irc proxy, for server "freenode", with SSL:
     /relay add ssl.irc.freenode 8001
-  SSL を有効化してすべてのサーバに対する irc プロキシを設定 (クライアントがサーバを選ぶ):
+  irc proxy, for all servers (client will choose), with SSL:
     /relay add ssl.irc 8002
-  weechat プロトコル:
+  weechat protocol:
     /relay add weechat 9000
-  SSL を有効化した weechat プロトコル:
+  weechat protocol with SSL:
     /relay add ssl.weechat 9001
-  SSL を有効にした weechat プロトコル、IPv4 だけを利用:
+  weechat protocol with SSL, using only IPv4:
     /relay add ipv4.ssl.weechat 9001
-  SSL を有効にした weechat プロトコル、IPv6 だけを利用:
+  weechat protocol with SSL, using only IPv6:
     /relay add ipv6.ssl.weechat 9001
-  SSL を有効にした weechat プロトコル、IPv4 と IPv6 を利用:
+  weechat protocol with SSL, using IPv4 + IPv6:
     /relay add ipv4.ipv6.ssl.weechat 9001
 ----