From a9b4f30b1eea6ddf321e2c3552492d6a1da8e761 Mon Sep 17 00:00:00 2001
From: Tatsuo Ishii <ishii@sraoss.co.jp>
Date: Wed, 19 Apr 2023 12:40:48 +0900
Subject: [PATCH] Doc: add caution to use -D option with pgpool.

---
 doc.ja/src/sgml/ref/pgpool.sgml | 6 ++++++
 doc/src/sgml/ref/pgpool.sgml    | 9 +++++++++
 2 files changed, 15 insertions(+)

diff --git a/doc.ja/src/sgml/ref/pgpool.sgml b/doc.ja/src/sgml/ref/pgpool.sgml
index 941f70ea6..b64df228a 100644
--- a/doc.ja/src/sgml/ref/pgpool.sgml
+++ b/doc.ja/src/sgml/ref/pgpool.sgml
@@ -255,6 +255,12 @@ Pgpool-II documentation
        -->
        <filename>pgpool_status</filename>ファイルを破棄し、以前の状態を復元しません。
       </para>
+      <caution>
+       <para>
+       このオプションは開発者向けテスト用の機能であり、それ以外の用途には使用しないでください。
+       <filename>pgpool_status</filename>ファイルを不用意に削除すると、<productname>Pgpool-II</productname>を再起動した時にsplit-brain状(primaryサーバが複数存在する状態)になることがあります。
+       </para>
+      </caution>
      </listitem>
     </varlistentry>
    </variablelist>
diff --git a/doc/src/sgml/ref/pgpool.sgml b/doc/src/sgml/ref/pgpool.sgml
index 16653032c..d65674e20 100644
--- a/doc/src/sgml/ref/pgpool.sgml
+++ b/doc/src/sgml/ref/pgpool.sgml
@@ -184,6 +184,15 @@ Pgpool-II documentation
        Discard <filename>pgpool_status</filename> file and do not
        restore previous status.
       </para>
+      <caution>
+       <para>
+       This option is testing purpose only for developers and you
+       should not use it for other purposes.
+       If <filename>pgpool_status</filename> is accidentally
+       removed, <productname>Pgpool-II</productname> may go into
+       split-brain (there are multiple primary servers exist).
+       </para>
+      </caution>
      </listitem>
     </varlistentry>
    </variablelist>
-- 
2.39.5