From d8d288776a72be49badbbea111edba0223d597c0 Mon Sep 17 00:00:00 2001
From: Tatsuo Ishii <ishii@sraoss.co.jp>
Date: Mon, 21 Aug 2023 16:05:40 +0900
Subject: [PATCH] Doc: enhance follow primary command manual.

Mention that it is necessary to run pcp_attach_node if
pcp_recovery_node is not used.
---
 doc.ja/src/sgml/failover.sgml |  3 +++
 doc/src/sgml/failover.sgml    | 16 +++++++++++++---
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/doc.ja/src/sgml/failover.sgml b/doc.ja/src/sgml/failover.sgml
index 5a7022ae8..4e25902a8 100644
--- a/doc.ja/src/sgml/failover.sgml
+++ b/doc.ja/src/sgml/failover.sgml
@@ -659,6 +659,9 @@ if (we need to executed follow primary command)
        たとえば、そのノードはハードウェア障害で停止しているかも知れませんし、管理者が保守のために停止しているのかも知れません。
        ノードが停止している場合は、そのノードをスキップしてください。
        ノードが動いている場合は、まずそのノードを停止してからリカバリしてください。
+       <xref linkend="PCP-RECOVERY-NODE">コマンドを呼ばずに、直接<command>pg_basebackup</command>などを呼び出してリカバリすることも可能ですが、その場合は、リカバリ後に<xref linkend="PCP-ATTACH-NODE">を呼び出して、スタンバイサーバが利用可能になったことを<productname>Pgpool-II</productname>に通知してください。
+	そうでないとそのスタンバイサーバはダウン状態のままになってしまいます。
+       (<xref linkend="PCP-RECOVERY-NODE">コマンドは内部で<xref linkend="PCP-ATTACH-NODE">を呼び出しているので、リカバリ後にスクリプトの中で<xref linkend="PCP-ATTACH-NODE">を呼び出す必要はありません。)
        <varname>follow_primary_command</varname>の完全な例は、<xref linkend="example-cluster">にあります。
      </para>
      <para>
diff --git a/doc/src/sgml/failover.sgml b/doc/src/sgml/failover.sgml
index 747a088b4..c92588125 100644
--- a/doc/src/sgml/failover.sgml
+++ b/doc/src/sgml/failover.sgml
@@ -498,9 +498,19 @@ if (we need to executed follow primary command)
       reason to be stopped: for example, it's broken by hardware
       problems or administrator is maintaining the node.  If the
       node is stopped, skip the node. If the node is running, stop
-      the node first and recovery it.  A
-      complete <varname>follow_primary_command</varname> example
-      can be found in <xref linkend="example-cluster">.
+      the node first and recovery it.
+      Although it is possible to recover by directly
+      executing <command>pg_basebackup</command> or other commands
+      instead of <xref linkend="PCP-RECOVERY-NODE">, you need to
+      execute <xref linkend="PCP-ATTACH-NODE"> to
+      notice <productname>Pgpool-II</productname> that the standby
+      server is ready to use. Otherwise the standby server remains in
+      down status. (Since <xref linkend="PCP-RECOVERY-NODE">
+      internally executes <xref linkend="PCP-ATTACH-NODE">, you don't
+      need to execute <xref linkend="PCP-ATTACH-NODE"> after
+      recovering.
+      A complete <varname>follow_primary_command</varname> example can
+      be found in <xref linkend="example-cluster">.
      </para>
      <para>
       This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-- 
2.39.5