core: add option "-save" in command /upgrade (closes #1630)

1 files changed, 23 insertions, 22 deletions

diff --git a/doc/ja/includes/autogen_user_commands.ja.adoc b/doc/ja/includes/autogen_user_commands.ja.adoc
index 0ace26e69..2b35bcd08 100644
--- a/doc/ja/includes/autogen_user_commands.ja.adoc
+++ b/doc/ja/includes/autogen_user_commands.ja.adoc
@@ -1953,35 +1953,36 @@ option: オプションの名前
 ----
 
 [[command_weechat_upgrade]]
-* `+upgrade+`: サーバとの接続を維持して WeeChat 実行バイナリを再読込
+* `+upgrade+`: save WeeChat session and reload the WeeChat binary without disconnecting from servers
 
 ----
-/upgrade  [-yes] [<path_to_binary>|-quit]
+/upgrade  [-yes] [<path_to_binary>|-save|-quit]
 
-          -yes: "weechat.look.confirm_upgrade" オプションが有効化されていた場合、このオプションは必須です。
-path_to_binary: WeeChat バイナリへのパス (デフォルトは現在のバイナリ)
-        -dummy: 何もしない (補完された "-quit" オプションを不用意に使わないためのオプション)
-         -quit: *すべての* 接続を閉じ、セッションを保存して WeeChat を終了。遅延復帰 (詳しくは後述) が可能になります。
+          -yes: required if option "weechat.look.confirm_upgrade" is enabled
+path_to_binary: path to WeeChat binary (default is current binary)
+        -dummy: do nothing (option used to prevent accidental completion with "-quit")
+         -save: only save the session (do not quit not reload WeeChat)
+         -quit: close *ALL* connections, save session and quit WeeChat, which makes possible a delayed restoration (see below)
 
-このコマンドは起動中の WeeChat セッションのアップグレードとリロードを行います。このコマンドを実行する前に、新しい WeeChat バイナリをコンパイルするか、パッケージマネージャでインストールしなければいけません。
+This command upgrades and reloads a running WeeChat session. The new WeeChat binary must have been compiled or installed with a package manager before running this command.
 
-注意: SSL 接続はアップグレード中に破棄されます、これは今のところ GnuTLS では SSL セッションのリロードができないからです。アップグレードの後に自動的に再接続されます。
+Note: SSL connections are lost during upgrade, because reload of SSL sessions is currently not possible with GnuTLS. There is automatic reconnection after upgrade.
 
-アップグレードは 4 つの手順を踏みます:
-  1. コアとプラグイン (バッファ、履歴、...) のセッションをファイルに保存
-  2. 全てのプラグインをアンロード (設定ファイル (*.conf) はディスクに書き込まれます)
-  3. WeeChat 設定を保存 (weechat.conf)
-  4. 新しい WeeChat バイナリを実行してセッションをリロード。
+Upgrade process has 4 steps:
+  1. save session into files for core and plugins (buffers, history, ..)
+  2. unload all plugins (configuration files (*.conf) are written on disk)
+  3. save WeeChat configuration (weechat.conf)
+  4. execute new WeeChat binary and reload session.
 
-オプション "-quit" を使うと、上の挙動が少し変わります:
-  1. *すべての* 接続を閉じる (irc、xfer、relay、...)
-  2. すべてのセッションをファイルに保存 (*.upgrade)
-  3. すべてのプラグインをアンロード
-  4. WeeChat 設定を保存
-  5. WeeChat を終了
-この後、セッションを回復させるには weechat --upgrade を使ってください。
-重要: 完全に同一の設定で (*.conf ファイルで) セッションを回復させてください。
-"~/.weechat" ディレクトリの内容をコピーすれば異なるマシンで WeeChat のセッションを回復することも可能です。
+With option "-quit", the process is slightly different:
+  1. close *ALL* connections (irc, xfer, relay, ...)
+  2. save session into files (*.upgrade)
+  3. unload all plugins
+  4. save WeeChat configuration
+  5. quit WeeChat
+Then later you can restore session with command: weechat --upgrade
+IMPORTANT: you must restore the session with exactly same configuration (files *.conf).
+It is possible to restore WeeChat session on another machine if you copy the content of directory "~/.weechat".
 ----
 
 [[command_weechat_uptime]]