From b970947aeac17f00527a8e9cc45b0162a77c2f30 Mon Sep 17 00:00:00 2001
From: Bo Peng <pengbo@sraoss.co.jp>
Date: Sun, 8 Nov 2020 22:28:25 +0900
Subject: [PATCH] Doc: fix missing description of pgpool.conf samples.

---
 doc.ja/src/sgml/runtime.sgml | 91 +++++++++++++++++++-----------------
 doc/src/sgml/runtime.sgml    | 56 +++++++++++-----------
 2 files changed, 78 insertions(+), 69 deletions(-)

diff --git a/doc.ja/src/sgml/runtime.sgml b/doc.ja/src/sgml/runtime.sgml
index b5952856a..58c1afd36 100644
--- a/doc.ja/src/sgml/runtime.sgml
+++ b/doc.ja/src/sgml/runtime.sgml
@@ -207,9 +207,6 @@
        <entry><literal>pgpool.conf.sample-stream</literal></entry>
       </row>
       <row>
-       <!--
-       <entry>Replication mode</entry>
-       -->
        <entry>ネイティブレプリケーションモード</entry>
        <entry><literal>pgpool.conf.sample-replication</literal></entry>
       </row>
@@ -217,6 +214,14 @@
        <entry>ロジカルレプリケーションモード</entry>
        <entry><literal>pgpool.conf.sample-logical</literal></entry>
       </row>
+      <row>
+       <entry>slonyモード</entry>
+       <entry><literal>pgpool.conf.sample-slony</literal></entry>
+      </row>
+      <row>
+       <entry>スナップショットアイソレーションモード</entry>
+       <entry><literal>pgpool.conf.sample-snapshot</literal></entry>
+      </row>
       <row>
        <entry>Rawモード</entry>
        <entry><literal>pgpool.conf.sample-raw</literal> </entry>
@@ -314,46 +319,6 @@
     このモードでは負荷分散が可能です。
    </para>
 
-   <para>
-    <!--
-    The <firstterm>logical replication mode</firstterm> can be used
-    with <productname>PostgreSQL</> servers operating logical
-    replication. In this mode, <productname>PostgreSQL</> is
-    responsible for synchronizing tables. Load balancing is possible
-    in the mode. Since logical replication does not replicate all
-    tables, it's user's responsibility to replicate the table which
-    could be load balanced. <productname>Pgpool-II</> load balaces
-    all tables. This means that if a table is not
-    replicated, <productname>Pgpool-II</> may lookup outdated tables
-    in the subscriber side.
-    -->
-    <firstterm>ロジカルレプリケーションモード</firstterm>はロジカルレプリケーションを使用する<productname>PostgreSQL</>サーバと一緒に使うことができます。
-    このモードでは、<productname>PostgreSQL</>がテーブルを同期する責任を持ちます。
-    このモードでは負荷分散が可能です。
-    ロジカルレプリケーションは必ずしもすべてのテーブルをレプリケーションしないので、負荷分散させるテーブルがレプリケーションされるようにするのはユーザの責任です。
-    <productname>Pgpool-II</>はすべてのテーブルをロードバランスします。
-    このことは、テーブルがレプリケーションされていない場合には、<productname>Pgpool-II</>がサブスクライバー側の更新されていない古いテーブルを見てしまうかもしれないことを意味します。
-   </para>
-
-   <para>
-    <!--
-    The <firstterm>native replication mode</firstterm> mode (slony mode)
-    can be used with <productname>PostgreSQL</> servers
-    operating <productname>Slony</>. In this
-    mode, <productname>Slony</>/<productname>PostgreSQL</> is
-    responsible for synchronizing
-    databases. Since <productname>Slony-I</> is being obsoleted by
-    streaming replication, we do not recommend to use this mode
-    unless you have specific reason to
-    use <productname>Slony</>. Load balancing is possible in the
-    mode.
-    -->
-    <firstterm>メインレプリカモード</firstterm>(slonyモード)は<productname>Slony-I</>を使用する<productname>PostgreSQL</>サーバと一緒に使うことができます。
-    このモードでは、<productname>Slony</>/<productname>PostgreSQL</>がデータベースを同期する責任を持ちます。
-    <productname>Slony</>はストリーミングレプリケーションの登場により廃れつつあるため、<productname>Slony</>を使う特別な理由が無い限りこのモードの使用を推奨しません。
-    このモードでは負荷分散が可能です。
-   </para>
-
    <para>
     <!--
     In the <firstterm>native replication
@@ -402,6 +367,46 @@
     このモードでは負荷分散が可能です。
    </para>
 
+   <para>
+    <!--
+    The <firstterm>logical replication mode</firstterm> can be used
+    with <productname>PostgreSQL</> servers operating logical
+    replication. In this mode, <productname>PostgreSQL</> is
+    responsible for synchronizing tables. Load balancing is possible
+    in the mode. Since logical replication does not replicate all
+    tables, it's user's responsibility to replicate the table which
+    could be load balanced. <productname>Pgpool-II</> load balaces
+    all tables. This means that if a table is not
+    replicated, <productname>Pgpool-II</> may lookup outdated tables
+    in the subscriber side.
+    -->
+    <firstterm>ロジカルレプリケーションモード</firstterm>はロジカルレプリケーションを使用する<productname>PostgreSQL</>サーバと一緒に使うことができます。
+    このモードでは、<productname>PostgreSQL</>がテーブルを同期する責任を持ちます。
+    このモードでは負荷分散が可能です。
+    ロジカルレプリケーションは必ずしもすべてのテーブルをレプリケーションしないので、負荷分散させるテーブルがレプリケーションされるようにするのはユーザの責任です。
+    <productname>Pgpool-II</>はすべてのテーブルをロードバランスします。
+    このことは、テーブルがレプリケーションされていない場合には、<productname>Pgpool-II</>がサブスクライバー側の更新されていない古いテーブルを見てしまうかもしれないことを意味します。
+   </para>
+
+   <para>
+    <!--
+    The <firstterm>native replication mode</firstterm> mode (slony mode)
+    can be used with <productname>PostgreSQL</> servers
+    operating <productname>Slony</>. In this
+    mode, <productname>Slony</>/<productname>PostgreSQL</> is
+    responsible for synchronizing
+    databases. Since <productname>Slony-I</> is being obsoleted by
+    streaming replication, we do not recommend to use this mode
+    unless you have specific reason to
+    use <productname>Slony</>. Load balancing is possible in the
+    mode.
+    -->
+    <firstterm>メインレプリカモード</firstterm>(slonyモード)は<productname>Slony-I</>を使用する<productname>PostgreSQL</>サーバと一緒に使うことができます。
+    このモードでは、<productname>Slony</>/<productname>PostgreSQL</>がデータベースを同期する責任を持ちます。
+    <productname>Slony</>はストリーミングレプリケーションの登場により廃れつつあるため、<productname>Slony</>を使う特別な理由が無い限りこのモードの使用を推奨しません。
+    このモードでは負荷分散が可能です。
+   </para>
+
    <para>
     <firstterm>スナップショットアイソレーションモード</firstterm>は、ネィティブレプリケーションモードと似ていますが、更にノードをまたがる可視性の一貫性を保証します。
     ただし、制限事項がいくつかあり、今の所(<productname>Pgpool-II</productname> 4.2)では「実験的な実装」という位置づけです。
diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 4b4c4adc6..e462de994 100644
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -141,6 +141,10 @@
        <entry>Slony mode</entry>
        <entry><literal>pgpool.conf.sample-slony</literal></entry>
       </row>
+      <row>
+       <entry>Snapshot isolation mode</entry>
+       <entry><literal>pgpool.conf.sample-snapshot</literal></entry>
+      </row>
       <row>
        <entry>Raw mode</entry>
        <entry><literal>pgpool.conf.sample-raw</literal> </entry>
@@ -211,32 +215,6 @@
     mode.
    </para>
 
-   <para>
-    The <firstterm>logical replication mode</firstterm> can be used
-    with <productname>PostgreSQL</> servers operating logical
-    replication. In this mode, <productname>PostgreSQL</> is
-    responsible for synchronizing tables. Load balancing is possible
-    in the mode. Since logical replication does not replicate all
-    tables, it's user's responsibility to replicate the table which
-    could be load balanced. <productname>Pgpool-II</> load balances
-    all tables. This means that if a table is not
-    replicated, <productname>Pgpool-II</> may lookup outdated tables
-    in the subscriber side.
-   </para>
-
-   <para>
-    The <firstterm>native replication mode</firstterm> mode (slony mode)
-    can be used with <productname>PostgreSQL</> servers
-    operating <productname>Slony</>. In this
-    mode, <productname>Slony</>/<productname>PostgreSQL</> is
-    responsible for synchronizing
-    databases. Since <productname>Slony-I</> is being obsoleted by
-    streaming replication, we do not recommend to use this mode
-    unless you have specific reason to
-    use <productname>Slony</>. Load balancing is possible in the
-    mode.
-   </para>
-
    <para>
     In the <firstterm>native replication
      mode</firstterm>, <productname>Pgpool-II</> is responsible for
@@ -263,6 +241,32 @@
     Load balancing is possible in the mode.
    </para>
 
+   <para>
+    The <firstterm>logical replication mode</firstterm> can be used
+    with <productname>PostgreSQL</> servers operating logical
+    replication. In this mode, <productname>PostgreSQL</> is
+    responsible for synchronizing tables. Load balancing is possible
+    in the mode. Since logical replication does not replicate all
+    tables, it's user's responsibility to replicate the table which
+    could be load balanced. <productname>Pgpool-II</> load balances
+    all tables. This means that if a table is not
+    replicated, <productname>Pgpool-II</> may lookup outdated tables
+    in the subscriber side.
+   </para>
+
+   <para>
+    The <firstterm>main replica mode</firstterm> mode (slony mode)
+    can be used with <productname>PostgreSQL</> servers
+    operating <productname>Slony</>. In this
+    mode, <productname>Slony</>/<productname>PostgreSQL</> is
+    responsible for synchronizing
+    databases. Since <productname>Slony-I</> is being obsoleted by
+    streaming replication, we do not recommend to use this mode
+    unless you have specific reason to
+    use <productname>Slony</>. Load balancing is possible in the
+    mode.
+   </para>
+
    <para>
     The <firstterm>snapshot isolation mode</firstterm> is similar to
     the native replication mode and it adds the visibility consistency
-- 
2.39.5