doc: add XDG directories support in docs (issue #1285)

7 files changed, 171 insertions, 105 deletions

diff --git a/doc/ja/includes/cmdline_options.ja.adoc b/doc/ja/includes/cmdline_options.ja.adoc
index bcd506296..e01d3337b 100644
--- a/doc/ja/includes/cmdline_options.ja.adoc
+++ b/doc/ja/includes/cmdline_options.ja.adoc
@@ -15,10 +15,11 @@
     (works only with the command *weechat-headless*, not compatible with option
     "--daemon").
 
+// TRANSLATION MISSING
 *-d*, *--dir* _<path>_::
-    WeeChat のホームディレクトリを path に設定 (設定ファイル、ログ、
-    ユーザプラグイン、スクリプトに利用される)、初期値は "~/.weechat"。
-    (注意: パスが存在しない場合は WeeChat がディレクトリを作成します)
+    Force a single directory for all WeeChat files (directory is created if not found).
+    Four directories can be given, separated by colons (in this order: config,
+    data, cache, runtime).
     このオプションを指定しなかった場合、環境変数 WEECHAT_HOME を使います
     (空でない限り)。
 
diff --git a/doc/ja/includes/man.ja.adoc b/doc/ja/includes/man.ja.adoc
index 0ce223e0b..6ff9d7486 100644
--- a/doc/ja/includes/man.ja.adoc
+++ b/doc/ja/includes/man.ja.adoc
@@ -17,79 +17,79 @@ IPv6 アドレスの後にポートを指定するには IPv6
 // end::plugin_options[]
 
 // tag::files[]
-$HOME/.weechat/weechat.conf::
+$HOME/.config/weechat/weechat.conf::
     WeeChat の主要設定ファイル
 
-$HOME/.weechat/plugins.conf::
+$HOME/.config/weechat/plugins.conf::
     プラグイン設定ファイル
 
-$HOME/.weechat/sec.conf::
+$HOME/.config/weechat/sec.conf::
     保護されたデータを含む設定ファイル
 
-$HOME/.weechat/alias.conf::
+$HOME/.config/weechat/alias.conf::
     _alias_ プラグイン用の設定ファイル
 
-$HOME/.weechat/buflist.conf::
+$HOME/.config/weechat/buflist.conf::
     _buflist_ プラグイン用の設定ファイル
 
-$HOME/.weechat/charset.conf::
+$HOME/.config/weechat/charset.conf::
     _charset_ プラグイン用の設定ファイル
 
-$HOME/.weechat/exec.conf::
+$HOME/.config/weechat/exec.conf::
     _exec_ プラグイン用の設定ファイル
 
-$HOME/.weechat/fifo.conf::
+$HOME/.config/weechat/fifo.conf::
     _fifo_ プラグイン用の設定ファイル
 
-$HOME/.weechat/fset.conf::
+$HOME/.config/weechat/fset.conf::
     _fset_ プラグイン用の設定ファイル
 
-$HOME/.weechat/guile.conf::
+$HOME/.config/weechat/guile.conf::
     _guile_ プラグイン用の設定ファイル
 
-$HOME/.weechat/irc.conf::
+$HOME/.config/weechat/irc.conf::
     _irc_ プラグイン用の設定ファイル
 
-$HOME/.weechat/javascript.conf::
+$HOME/.config/weechat/javascript.conf::
     _javascript_ プラグイン用の設定ファイル
 
-$HOME/.weechat/logger.conf::
+$HOME/.config/weechat/logger.conf::
     _logger_ プラグイン用の設定ファイル
 
-$HOME/.weechat/lua.conf::
+$HOME/.config/weechat/lua.conf::
     _lua_ プラグイン用の設定ファイル
 
-$HOME/.weechat/perl.conf::
+$HOME/.config/weechat/perl.conf::
     _perl_ プラグイン用の設定ファイル
 
-$HOME/.weechat/php.conf::
+$HOME/.config/weechat/php.conf::
     _php_ プラグイン用の設定ファイル
 
-$HOME/.weechat/python.conf::
+$HOME/.config/weechat/python.conf::
     _python_ プラグイン用の設定ファイル
 
-$HOME/.weechat/relay.conf::
+$HOME/.config/weechat/relay.conf::
     _relay_ プラグイン用の設定ファイル
 
-$HOME/.weechat/ruby.conf::
+$HOME/.config/weechat/ruby.conf::
     _ruby_ プラグイン用の設定ファイル
 
-$HOME/.weechat/script.conf::
+$HOME/.config/weechat/script.conf::
     _script_ プラグイン用の設定ファイル
 
-$HOME/.weechat/spell.conf::
+$HOME/.config/weechat/spell.conf::
     _spell_ プラグイン用の設定ファイル
 
-$HOME/.weechat/tcl.conf::
+$HOME/.config/weechat/tcl.conf::
     _tcl_ プラグイン用の設定ファイル
 
-$HOME/.weechat/trigger.conf::
+$HOME/.config/weechat/trigger.conf::
     _trigger_ プラグイン用の設定ファイル
 
-$HOME/.weechat/xfer.conf::
+$HOME/.config/weechat/xfer.conf::
     _xfer_ プラグイン用の設定ファイル
 
-$HOME/.weechat/weechat.log::
+$HOME/.local/share/weechat/weechat.log::
     WeeChat ログファイル
 // end::files[]
 
diff --git a/doc/ja/weechat_faq.ja.adoc b/doc/ja/weechat_faq.ja.adoc
index b9447fe84..876ab87df 100644
--- a/doc/ja/weechat_faq.ja.adoc
+++ b/doc/ja/weechat_faq.ja.adoc
@@ -1056,9 +1056,13 @@ weeget.py と script.pl を使ってください。
 それでもだめなら、手作業で (シェルから) スクリプトリストファイルを削除してください:
 
 ----
-$ rm ~/.weechat/script/plugins.xml.gz
+$ rm ~/.cache/weechat/script/plugins.xml.gz
 ----
 
+// TRANSLATION MISSING
+[NOTE]
+With WeeChat ≤ 3.1, the path should be: _~/.weechat/script/plugins.xml.gz_.
+
 その後、WeeChat からスクリプトリストを更新してください:
 
 ----
@@ -1078,7 +1082,7 @@ $ rm ~/.weechat/script/plugins.xml.gz
 * シェルからスクリプトリストファイルをダウンロードします (必要なら curl をインストールしてください):
 
 ----
-$ cd ~/.weechat/script
+$ cd ~/.cache/weechat/script
 $ curl -O https://weechat.org/files/plugins.xml.gz
 ----
 
@@ -1194,8 +1198,9 @@ link:weechat_user.ja.html#secured_data[ユーザーズガイド / 暗号化デ�
 [[sharing_config_files]]
 === WeeChat の設定を共有したいのですが、公開しても良いファイルと秘密にしておくべきファイルを教えてください。
 
-_~/.weechat/*.conf_ ファイルは公開しても問題ありませんが、
-パスフレーズで暗号化されたパスワードが含まれる _sec.conf_ ファイルは秘密にしてください。
+// TRANSLATION MISSING
+You can share configuration files _*.conf_ except the file _sec.conf_ which
+contains your passwords ciphered with your passphrase.
 
 // TRANSLATION MISSING
 Some other files may contain sensitive info like passwords (if they are not
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index 26aaabae6..fecc08ad7 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -187,7 +187,7 @@ $ gcc -shared -fPIC -o toto.so toto.o
 
 _toto.so_ ファイルをシステムのプラグインディレクトリ (例えば
 _/usr/local/lib/weechat/plugins_) またはユーザのプラグインディレクトリ (例えば
-_/home/xxx/.weechat/plugins_) にコピーしてください。
+_/home/user/.local/share/weechat/plugins_) にコピーしてください。
 
 WeeChat の中で:
 
@@ -1036,7 +1036,7 @@ C 言語での使用例:
 [source,C]
 ----
 char *str = weechat_string_expand_home ("~/file.txt");
-/* result: "/home/xxx/file.txt" */
+/* result: "/home/user/file.txt" */
 /* ... */
 free (str);
 ----
@@ -1046,11 +1046,13 @@ free (str);
 
 ==== string_eval_path_home
 
-_WeeChat バージョン 0.3.3 以上で利用可。_
+// TRANSLATION MISSING
+_WeeChat ≥ 1.3, updated in 3.2._
 
 3 段階でパスを評価します:
 
-. 先頭の `%h` を WeeChat ホームディレクトリで置換し、
+// TRANSLATION MISSING
+. replace leading `%h` by a WeeChat directory (data by default),
 . 先頭の `+~+` をユーザのホームディレクトリで置換し
   (<<_string_expand_home,string_expand_home>> を実行し)、
 . 変数を評価します
@@ -1068,13 +1070,20 @@ char *weechat_string_eval_path_home (const char *path,
 
 引数:
 
+// TRANSLATION MISSING
 * _path_: パス
 * _pointers_: 関数に渡されるハッシュテーブル
   <<_string_eval_expression,string_eval_expression>>
 * _extra_vars_: 関数に渡されるハッシュテーブル
   <<_string_eval_expression,string_eval_expression>>
-* _options_: 関数に渡されるハッシュテーブル
-  <<_string_eval_expression,string_eval_expression>>
+* _options_: hashtable for call to function
+  <<_string_eval_expression,string_eval_expression>>, with one extra key
+  supported:
+** _directory_: WeeChat directory to use when replacing `%h`, one of:
+*** _config_
+*** _data_ (default)
+*** _cache_
+*** _runtime_
 
 戻り値:
 
@@ -1084,8 +1093,8 @@ C 言語での使用例:
 
 [source,C]
 ----
-char *str = weechat_string_eval_path_home ("%h/test", NULL, NULL, NULL);
-/* result: "/home/xxx/.weechat/test" */
+char *str = weechat_string_eval_path_home ("${weechat_config_dir}/test.conf", NULL, NULL, NULL);
+/* result: "/home/user/.config/weechat/test.conf" */
 /* ... */
 free (str);
 ----
@@ -1098,8 +1107,8 @@ free (str);
 path = weechat.string_eval_path_home(path, pointers, extra_vars, options)
 
 # 例
-path = weechat.string_eval_path_home("%h/test", {}, {}, {})
-# path == "/home/xxx/.weechat/test"
+path = weechat.string_eval_path_home("${weechat_config_dir}/test.conf", {}, {}, {})
+# path == "/home/user/.config/weechat/test.conf"
 ----
 
 ==== string_remove_quotes
@@ -2560,6 +2569,19 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
   `+${name}+` |
   `+value+`
 
+// TRANSLATION MISSING
+| `+${weechat_xxx_dir}+` |
+  A WeeChat directory: `+${weechat_config_dir}+`, `+${weechat_data_dir}+`,
+  `+${weechat_cache_dir}+` or `+${weechat_runtime_dir}+`. |
+  `+${weechat_config_dir}+` +
+  `+${weechat_data_dir}+` +
+  `+${weechat_cache_dir}+` +
+  `+${weechat_runtime_dir}+` |
+  `+/home/user/.config/weechat+` +
+  `+/home/user/.local/share/weechat+` +
+  `+/home/user/.cache/weechat+` +
+  `+/run/user/1000/weechat+`
+
 | `+${eval:xxx}+` +
   _(WeeChat バージョン 1.3 以上で利用可)_ |
   評価する文字列 |
@@ -2687,9 +2709,9 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
   Result of a modifier, see function
   <<_hook_modifier_exec,hook_modifier_exec>>. |
   `+${modifier:eval_path_home,,~}+` +
-  `+${modifier:eval_path_home,,%h/python}+` |
-  `+/home/xxx+` +
-  `+/home/xxx/.weechat/python+`
+  `+${modifier:eval_path_home,directory=config,%h/weechat.conf}+` |
+  `+/home/user+` +
+  `+/home/user/.config/weechat/weechat.conf+`
 
 | `+${info:name}+` +
   `+${info:name,arguments}+` +
@@ -3648,6 +3670,8 @@ rc = weechat_crypto_hash_pbkdf2 (data, strlen (data), "sha256", salt, strlen (sa
 
 ==== mkdir_home
 
+_WeeChat バージョン 3.2 で更新。_
+
 WeeChat ホームディレクトリの下にディレクトリを作成。
 
 プロトタイプ:
@@ -3659,7 +3683,13 @@ int weechat_mkdir_home (char *directory, int mode);
 
 引数:
 
-* _directory_: 作成するディレクトリの名前
+// TRANSLATION MISSING
+* _directory_: name of directory to create; it can start with one of these
+  strings to force a specific WeeChat directory (WeeChat ≥ 3.2):
+** `${weechat_config_dir}`
+** `${weechat_data_dir}` (default)
+** `${weechat_cache_dir}`
+** `${weechat_runtime_dir}`
 * _mode_: ディレクトリのモード
 
 戻り値:
@@ -3670,7 +3700,7 @@ C 言語での使用例:
 
 [source,C]
 ----
-if (!weechat_mkdir_home ("temp", 0755))
+if (!weechat_mkdir_home ("${weechat_cache_dir}/temp", 0755))
 {
     /* error */
 }
@@ -3684,7 +3714,7 @@ if (!weechat_mkdir_home ("temp", 0755))
 weechat.mkdir_home(directory, mode)
 
 # 例
-weechat.mkdir_home("temp", 0755)
+weechat.mkdir_home("${weechat_cache_dir}/temp", 0755)
 ----
 
 ==== mkdir
@@ -10959,8 +10989,8 @@ weechat.hook_signal_send("logger_backlog", weechat.WEECHAT_HOOK_SIGNAL_POINTER,
 シグナルを受け取ったらコールバックは以下のように働きます:
 
 . インストール済みスクリプトをリロードして削除。
-. 新しいスクリプトをディレクトリ _~/.weechat/xxx/_ に移動 (_xxx_ はプログラミング言語)
-. 新しいスクリプトへのリンクをディレクトリ _~/.weechat/xxx/autoload/_ に作成
+. 新しいスクリプトをディレクトリ _~/.local/share/weechat/xxx/_ に移動 (_xxx_ はプログラミング言語)
+. 新しいスクリプトへのリンクをディレクトリ _~/.local/share/weechat/xxx/autoload/_ に作成
   (古いスクリプトがすでに自動ロードされていた場合、もしくは新しいスクリプトに対してオプション
   _script.scripts.autoload_ が有効化されている場合のみ作成されます)
 . 新しいスクリプトを読み込む (古いスクリプトがロードされていた場合のみ)
@@ -10973,16 +11003,14 @@ C 言語での使用例:
 
 [source,C]
 ----
-weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING,
-                          "/home/xxx/.weechat/test.py");
+weechat_hook_signal_send ("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, "/path/to/test.py");
 ----
 
 スクリプト (Python) での使用例:
 
 [source,python]
 ----
-weechat.hook_signal_send("python_script_install", WEECHAT_HOOK_SIGNAL_STRING,
-                         "/home/xxx/.weechat/test.py")
+weechat.hook_signal_send("python_script_install", WEECHAT_HOOK_SIGNAL_STRING, "/path/to/test.py")
 ----
 
 [[signals_xxx_script_remove]]
@@ -11776,7 +11804,7 @@ WeeChat とプラグインが定義する修飾子のリスト:
 // TRANSLATION MISSING
 | [[hook_modifier_eval_path_home]] eval_path_home +
   _(WeeChat バージョン 2.7 以上で利用可)_ |
-  - |
+  Optional: `directory=xxx` where `xxx` can be: `config`, `data`, `cache`, `runtime` |
   Any string. |
   Evaluated path, result of the function
   <<_string_eval_path_home,string_eval_path_home>>.
@@ -15436,10 +15464,10 @@ if (version)
 if (date)
     free (date);
 
-char *weechat_dir = weechat_info_get ("weechat_dir", NULL);
-weechat_printf (NULL, "WeeChat home is: %s", weechat_dir);
-if (weechat_dir)
-    free (weechat_dir);
+char *weechat_config_dir = weechat_info_get ("weechat_config_dir", NULL);
+weechat_printf (NULL, "WeeChat config directory is: %s", weechat_config_dir);
+if (weechat_config_dir)
+    free (weechat_config_dir);
 ----
 
 スクリプト (Python) での使用例:
@@ -15452,7 +15480,7 @@ value = weechat.info_get(info_name, arguments)
 # 例
 weechat.prnt("", "Current WeeChat version is: %s (compiled on %s)"
     % (weechat.info_get("version", ""), weechat.info_get("date", ""))
-weechat.prnt("", "WeeChat home is: %s" % weechat.info_get("weechat_dir", ""))
+weechat.prnt("", "WeeChat config directory is: %s" % weechat.info_get("weechat_config_dir", ""))
 ----
 
 ==== info_get_hashtable
diff --git a/doc/ja/weechat_relay_protocol.ja.adoc b/doc/ja/weechat_relay_protocol.ja.adoc
index f026c97d2..36197ae2c 100644
--- a/doc/ja/weechat_relay_protocol.ja.adoc
+++ b/doc/ja/weechat_relay_protocol.ja.adoc
@@ -606,15 +606,15 @@ inf: ('version_number', '34144256')
 * Request WeeChat directory:
 
 ----
-(info_weechat_dir) info weechat_dir
+(info_weechat_config_dir) info weechat_config_dir
 ----
 
 Response:
 
 [source,python]
 ----
-id: 'info_weechat_dir'
-inf: ('weechat_dir', '/home/xxx/.weechat')
+id: 'info_weechat_config_dir'
+inf: ('weechat_config_dir', '/home/user/.config/weechat')
 ----
 
 [[command_infolist]]
diff --git a/doc/ja/weechat_scripting.ja.adoc b/doc/ja/weechat_scripting.ja.adoc
index 54603ae66..616fe96f5 100644
--- a/doc/ja/weechat_scripting.ja.adoc
+++ b/doc/ja/weechat_scripting.ja.adoc
@@ -355,7 +355,7 @@ _language/autoload_ ディレクトリ内にリンクを作ってください。
 例えば Python の場合:
 
 ----
-$ cd ~/.weechat/python/autoload
+$ cd ~/.local/share/weechat/python/autoload
 $ ln -s ../script.py
 ----
 
@@ -1399,10 +1399,11 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
 [[infos_other]]
 ==== その他の情報
 
+// TRANSLATION MISSING
 [source,python]
 ----
-# WeeChat ホームディレクトリ、例えば: "/home/xxxx/.weechat"
-weechat.prnt("", "WeeChat home dir: %s" % weechat.info_get("weechat_dir", ""))
+# WeeChat config directory, for example: "/home/user/.config/weechat"
+weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_dir", ""))
 
 # キーボードの不使用時間
 weechat.prnt("", "Inactivity since %s seconds" % weechat.info_get("inactivity", ""))
diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc
index 3d6bde8e2..f755f84db 100644
--- a/doc/ja/weechat_user.ja.adoc
+++ b/doc/ja/weechat_user.ja.adoc
@@ -484,10 +484,10 @@ _/var/lib/systemd/coredump_ and you must use the command `coredumpctl` to read i
 For more information, see this wiki page: https://wiki.archlinux.org/index.php/Core_dump
 
 例えば、_weechat_ が _/usr/bin/_ にインストールされ、_core_ ファイルが
-_/home/xxx/_ にある場合、以下のコマンドで gdb を起動してください:
+_/home/user/_ にある場合、以下のコマンドで gdb を起動してください:
 
 ----
-gdb /usr/bin/weechat /home/xxx/core
+gdb /usr/bin/weechat /home/user/core
 ----
 
 gdb の中で `bt full`
@@ -573,8 +573,8 @@ to upgrade the kernel or to move your WeeChat to another machine:
 ----
 
 This saves the current state in `*.upgrade` files. You can then either reboot
-or move the whole directory `~/.weechat` to another machine, and restart
-WeeChat later with this command:
+or move the whole WeeChat directories (config, data, cache) to another machine,
+and restart WeeChat later with this command:
 
 ----
 $ weechat --upgrade
@@ -607,7 +607,7 @@ WeeChat has an automatic upgrade of configuration files (`*.conf`):
 Example of warning when an option has been removed:
 
 ----
-=!= 警告: /home/xxx/.weechat/sec.conf, 行 15: セクション "crypt" の無効なオプション: passphrase_file = ""
+=!= 警告: /home/user/.config/weechat/sec.conf, 行 15: セクション "crypt" の無効なオプション: passphrase_file = ""
 ----
 
 That means the option `sec.crypt.passphrase_file` has been removed, and you
@@ -627,7 +627,7 @@ $ weechat
 ----
 
 WeeChat の初回起動時にデフォルトのオプション設定を含む設定ファイルが
-_~/.weechat_ ディレクトリの中に作成されます
+_~/.config/weechat_ ディレクトリの中に作成されます
 (<<files_and_directories,ファイルとディレクトリ>>を参照してください)。
 
 ==== コマンドラインオプション
@@ -658,10 +658,28 @@ include::includes/cmdline_options.ja.adoc[tag=debug]
 [[files_and_directories]]
 === ファイルとディレクトリ
 
-デフォルト状態の WeeChat は `~/.weechat`
-ディレクトリ内に設定ファイルおよびその他のデータを書き込みます。 +
 // TRANSLATION MISSING
-These files are created with default values the first time you run WeeChat.
+[[xdg_directories]]
+==== XDG directories
+
+WeeChat uses XDG directories by default
+(according to the https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification]). +
+A single home directory for all files can be forced by CMake option `WEECHAT_HOME`,
+the environment variable `WEECHAT_HOME` or the command-line option `-d` / `--dir`.
+
+When a single WeeChat home directory is not forced, XDG directories are used
+and set like this:
+
+[width="100%",cols="1,2m,5",options="header"]
+|===
+| Directory | Default value            | Fallback value
+| config    | $XDG_CONFIG_HOME/weechat | `$HOME/.config/weechat` if `$XDG_CONFIG_HOME` is not defined or empty.
+| data      | $XDG_DATA_HOME/weechat   | `$HOME/.local/share/weechat` if `$XDG_DATA_HOME` is not defined or empty.
+| cache     | $XDG_CACHE_HOME/weechat  | `$HOME/.cache/weechat` if `$XDG_CACHE_HOME` is not defined or empty.
+| runtime   | $XDG_RUNTIME_DIR/weechat | Same as _cache_ directory if `$XDG_RUNTIME_DIR` is not defined or empty.
+|===
+
+The configuration files are created with default values the first time you run WeeChat.
 
 // TRANSLATION MISSING
 [[weechat_directories]]
@@ -672,29 +690,38 @@ The WeeChat directories are:
 
 [width="100%",cols="1m,3",options="header"]
 |===
-| パス/ファイル     | 説明
-| ~/.weechat/       | WeeChat ホームディレクトリ (変更するには <<running_weechat,WeeChat の起動>>を参照してください)
-|    logs/          | ログファイル (バッファごとに 1 つのファイル)
-|    python/        | Python スクリプト
-|       autoload/   | 起動時に自動ロードされる Python スクリプト ^(1)^
-|    perl/          | Perl スクリプト
-|       autoload/   | 起動時に自動ロードされる Perl スクリプト ^(1)^
-|    ruby/          | Ruby スクリプト
-|       autoload/   | 起動時に自動ロードされる Ruby スクリプト ^(1)^
-|    lua/           | Lua スクリプト
-|       autoload/   | 起動時に自動ロードされる Lua スクリプト ^(1)^
-|    tcl/           | Tcl スクリプト
-|       autoload/   | 起動時に自動ロードされる Tcl スクリプト ^(1)^
-|    guile/         | Guile スクリプト
-|       autoload/   | 起動時に自動ロードされる Guile スクリプト ^(1)^
-|    javascript/    | JavaScript スクリプト
-|       autoload/   | 起動時に自動ロードされる JavaScript スクリプト ^(1)^
-|    php/           | PHP スクリプト
-|       autoload/   | 起動時に自動ロードされる PHP スクリプト ^(1)^
+// TRANSLATION MISSING
+| Path ^(1)^              | 説明
+// TRANSLATION MISSING
+| ~/.config/weechat/      | WeeChat configuration files: `*.conf`, certificates, etc.
+// TRANSLATION MISSING
+| ~/.local/share/weechat/ | WeeChat data files: logs, scripts, scripts data, xfer files, etc.
+|    logs/                | ログファイル (バッファごとに 1 つのファイル)
+|    python/              | Python スクリプト
+|       autoload/         | 起動時に自動ロードされる Python スクリプト ^(2)^
+|    perl/                | Perl スクリプト
+|       autoload/         | 起動時に自動ロードされる Perl スクリプト ^(2)^
+|    ruby/                | Ruby スクリプト
+|       autoload/         | 起動時に自動ロードされる Ruby スクリプト ^(2)^
+|    lua/                 | Lua スクリプト
+|       autoload/         | 起動時に自動ロードされる Lua スクリプト ^(2)^
+|    tcl/                 | Tcl スクリプト
+|       autoload/         | 起動時に自動ロードされる Tcl スクリプト ^(2)^
+|    guile/               | Guile スクリプト
+|       autoload/         | 起動時に自動ロードされる Guile スクリプト ^(2)^
+|    javascript/          | JavaScript スクリプト
+|       autoload/         | 起動時に自動ロードされる JavaScript スクリプト ^(2)^
+|    php/                 | PHP スクリプト
+|       autoload/         | 起動時に自動ロードされる PHP スクリプト ^(2)^
+// TRANSLATION MISSING
+| ~/.cache/weechat/       | WeeChat cache files: scripts cache.
+// TRANSLATION MISSING
+| /run/user/1000/weechat/ | WeeChat runtime files: FIFO pipe, Relay UNIX sockets.
 |===
 
 [NOTE]
-^(1)^ このディレクトリには親ディレクトリ内にあるスクリプトへのシンボリックリンクのみが含まれることが多いです。
+^(1)^ XDG directories may be different according to your environment variables `XDG_*`. +
+^(2)^ このディレクトリには親ディレクトリ内にあるスクリプトへのシンボリックリンクのみが含まれることが多いです。
 
 // TRANSLATION MISSING
 [[weechat_files]]
@@ -2782,7 +2809,9 @@ include::includes/autogen_user_options.ja.adoc[tag=exec_options]
 外部から WeeChat を操作するには、FIFO パイプにコマンドやテキストを書き込んでください ("fifo.file.enabled"
 オプションが有効化されている必要がありますが、デフォルトで有効化されているはずです)。
 
-FIFO パイプは _~/.weechat/_ の中にあり、デフォルトで _weechat_fifo_ という名前を付けられています。
+// TRANSLATION MISSING
+The FIFO pipe is located in WeeChat runtime directory and is called
+_weechat_fifo_ by default.
 
 FIFO パイプに書き込むコマンド/テキストの文法は以下の例の一つです:
 
@@ -2796,26 +2825,26 @@ FIFO パイプに書き込むコマンド/テキストの文法は以下の例�
 * IRC サーバ freenode で使うニックネームを "newnick" に変更する:
 
 ----
-$ echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
+$ echo 'irc.server.freenode */nick newnick' >/run/user/1000/weechat/weechat_fifo
 ----
 
 * IRC チャンネル #weechat に対してテキストを送信:
 
 ----
-$ echo 'irc.freenode.#weechat *hello!' >~/.weechat/weechat_fifo
+$ echo 'irc.freenode.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo
 ----
 
 * 現在のバッファに対してテキストを送信:
 
 ----
-$ echo '*hello!' >~/.weechat/weechat_fifo
+$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo
 ----
 
 * Python スクリプトのアンロードとロードを行う 2 つのコマンドを送信
   (複数のコマンドは "\n" で分割してください):
 
 ----
-$ printf '%b' '*/python unload\n*/python autoload\n' >~/.weechat/weechat_fifo
+$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo
 ----
 
 [[fifo_commands]]
@@ -3454,7 +3483,7 @@ logger.file.mask
 以下のファイルが作成されます:
 
 ....
-~/.weechat
+~/.local/share/weechat
 └── logs
     ├── 2010
     │   ├── 11
@@ -3483,7 +3512,7 @@ IRC サーバ名を使ったディレクトリに、チャンネル名を使っ�
 以下のファイルが作成されます:
 
 ....
-~/.weechat
+~/.local/share/weechat
 └── logs
     └── irc
         ├── freenode
@@ -3693,12 +3722,14 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
 UNIX ドメインソケット上の任意のプロトコルをリッスンできます。例:
 
 ----
-/relay add unix.weechat %h/relay_socket
+/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
 ----
 
-こうすることで、クライアントは weechat プロトコルを使って _~/.weechat/relay_socket_
+こうすることで、クライアントは weechat プロトコルを使って _/run/user/1000/weechat/relay_socket_
 に接続できます。これは、他のポートをオープンが禁止されている状況下で、リレークライアントの
-SSH 転送を許可する際に特に便利です。OpenSSH を使った例:
+SSH 転送を許可する際に特に便利です。
+
+OpenSSH を使った例:
 
 ----
 $ ssh -L 9000:.weechat/relay_socket user@hostname