core: add option weechat.look.confirm_upgrade (closes #463)

2 files changed, 31 insertions, 25 deletions

diff --git a/doc/ja/autogen/user/weechat_commands.asciidoc b/doc/ja/autogen/user/weechat_commands.asciidoc
index 1ceda7570..15cb4e350 100644
--- a/doc/ja/autogen/user/weechat_commands.asciidoc
+++ b/doc/ja/autogen/user/weechat_commands.asciidoc
@@ -841,31 +841,32 @@ option: オプションの名前
 [command]*`upgrade`* サーバとの接続を維持して WeeChat をアップグレード::
 
 ----
-/upgrade  [<path_to_binary>|-quit]
-
-path_to_binary: WeeChat バイナリへのパス (デフォルトは現在のバイナリ)
-        -dummy: 何もしない (補完された "-quit" オプションを不用意に使わないためのオプション)
-         -quit: *すべての*接続を閉じ、セッションを保存して WeeChat を終了。遅延復帰 (詳しくは後述) が可能になります。
-
-このコマンドは起動中の WeeChat セッションのアップグレードと再読み込みを行います。このコマンドを実行する前に、新しい WeeChat バイナリをコンパイルするか、パッケージマネージャでインストールしなければいけません。
-
-注意: SSL 接続はアップグレード中に破棄されます、これは今のところ GnuTLS では SSL セッションのリロードができないからです。アップグレードの後に自動的に再接続されます。
-
-アップグレードは 4 つの手順を踏みます:
-  1. コアとプラグイン (バッファ、履歴、...) のセッションをファイルに保存
-  2. 全てのプラグインをアンロード (設定ファイル (*.conf) はディスクに書き込まれます)
-  3. WeeChat 設定を保存 (weechat.conf)
-  4. 新しい WeeChat バイナリを実行してセッションをリロード。<
-
-オプション "-quit" を使うと、上の挙動が少し変わります:
-  1. *すべての*接続を閉じる (irc、xfer、relay、...)
-  2. すべてのセッションをファイルに保存 (*.upgrade)
-  3. すべてのプラグインをアンロード
-  4. WeeChat 設定を保存
-  5. WeeChat を終了
-この後、セッションを回復させるには weechat --upgrade を使ってください。
-重要: 完全に同一の設定で (*.conf ファイルで) セッションを回復させてください。
-"~/.weechat" ディレクトリの内容をコピーすれば異なるマシンで WeeChat のセッションを回復することも可能です。
+/upgrade  [-yes] [<path_to_binary>|-quit]
+
+          -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")
+         -quit: close *ALL* connections, save session and quit WeeChat, which makes possible a delayed restoration (see below)
+
+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.
+
+Note: SSL connections are lost during upgrade, because reload of SSL sessions is currently not possible with GnuTLS. There is automatic reconnection after upgrade.
+
+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.
+
+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]]
diff --git a/doc/ja/autogen/user/weechat_options.asciidoc b/doc/ja/autogen/user/weechat_options.asciidoc
index 4e741f15b..bf592c19d 100644
--- a/doc/ja/autogen/user/weechat_options.asciidoc
+++ b/doc/ja/autogen/user/weechat_options.asciidoc
@@ -542,6 +542,11 @@
 ** タイプ: ブール
 ** 値: on, off (デフォルト値: `off`)
 
+* [[option_weechat.look.confirm_upgrade]] *weechat.look.confirm_upgrade*
+** 説明: `if set, /upgrade command must be confirmed with extra argument "-yes" (see /help upgrade)`
+** タイプ: ブール
+** 値: on, off (デフォルト値: `off`)
+
 * [[option_weechat.look.day_change]] *weechat.look.day_change*
 ** 説明: `日付が変わった際に特殊メッセージを表示`
 ** タイプ: ブール