From 08b9c71bd3de38676f0f2145080cc1ef71cf37d3 Mon Sep 17 00:00:00 2001
From: Bo Peng <pengbo@sraoss.co.jp>
Date: Mon, 27 Nov 2023 14:19:18 +0900
Subject: [PATCH] Doc: update Installation document to mention that from
 Pgpool-II 4.5 it is required to run "autoreconf -fi" first to generate
 configure file.

---
 doc.ja/src/sgml/installation.sgml | 89 +++++++++++++++++++++----------
 doc/src/sgml/installation.sgml    | 74 ++++++++++++++++---------
 2 files changed, 110 insertions(+), 53 deletions(-)

diff --git a/doc.ja/src/sgml/installation.sgml b/doc.ja/src/sgml/installation.sgml
index 5ddea7943..06cda3fc1 100644
--- a/doc.ja/src/sgml/installation.sgml
+++ b/doc.ja/src/sgml/installation.sgml
@@ -280,11 +280,34 @@
   <title>Pgpool-IIのインストール</title>
   <para>
    <!--
-   After extracting the source tarball, execute the <filename>configure</> script.
+   After extracting the source tarball, follow the steps below to build
+   the source code.
    -->
-   ソースのtarballを展開したら、<filename>configure</>スクリプトを実行します。
+   ソースのtarballを展開したら、以下の手順にしたがって、ソースコードをビルドして、<productname>Pgpool-II</productname>をインストールします。
+  </para>
+  <para>
+   <!--
+   Since <productname>Pgpool-II</productname> 4.5, files such as
+   <filename>configure</filename> generated by <command>autoconf/autoreconf</command>
+   have been removed from the repository, so first run
+   <command>autoreconf -fi</command> to generate <filename>configure</filename>.
+   -->
+   <productname>Pgpool-II</productname> 4.5から、<command>autoconf/autoreconf</command>によって生成されるconfigureなどのファイルはリポジトリから削除されたので、まず<command>autoreconf -fi</command>を実行し、<filename>configure</filename>を生成します。
+   <programlisting>
+dnf install libtool
+
+cd pgpool-II-&version;
+autoreconf -fi
+   </programlisting>
+  </para>
+
+  <para>
+   <!--
+   Next, execute the <filename>configure</> script.
+   -->
+   次に、<filename>configure</>スクリプトを実行します。
    <programlisting>
-    ./configure
+./configure
    </programlisting>
   </para>
 
@@ -419,9 +442,21 @@
   </variablelist>
 
   <para>
+   <!--
+   Compile the source file.
+   -->
+   ソースファイルのコンパイルを行います。
+   <programlisting>
+make
+   </programlisting>
+  </para>
+  <para>
+   <!--
+   Install <productname>Pgpool-II</productname>.
+   -->
+   <productname>Pgpool-II</productname>をインストールします。
    <programlisting>
-    make
-    make install
+make install
    </programlisting>
    <!--
    This will install <productname>Pgpool-II</>. (If you use <productname>Solaris</> or <productname>FreeBSD</>, replace make with gmake)
@@ -459,17 +494,17 @@
    -->
    これは全ての<productname>Pgpool-II</productname>のインストールで必要です。
    <programlisting>
-    $ cd pgpool-II-&version/src/sql/pgpool-recovery
-    $ make
-    $ make install
+$ cd pgpool-II-&version/src/sql/pgpool-recovery
+$ make
+$ make install
    </programlisting>
    <!--
    After this:
    -->
    この後に以下か、
    <programlisting>
-    $ psql template1
-    =# CREATE EXTENSION pgpool_recovery;
+$ psql template1
+=# CREATE EXTENSION pgpool_recovery;
    </programlisting>
 
    <!--
@@ -477,7 +512,7 @@
    -->
    または
    <programlisting>
-    $ psql -f pgpool-recovery.sql template1
+$ psql -f pgpool-recovery.sql template1
    </programlisting>
    を実行します。
 
@@ -496,7 +531,7 @@
    その場合、<filename>postgresql.conf</filename>に以下を追加してください。
 
    <programlisting>
-    pgpool.pg_ctl = '/usr/local/pgsql/bin/pg_ctl'
+pgpool.pg_ctl = '/usr/local/pgsql/bin/pg_ctl'
    </programlisting>
 
    <!--
@@ -504,7 +539,7 @@
    -->
    もしかするとその後に以下を実行する必要があるかもしれません。
    <programlisting>
-    $ pg_ctl reload -D /usr/local/pgsql/data
+$ pg_ctl reload -D /usr/local/pgsql/data
    </programlisting>
 
   </para>
@@ -547,9 +582,9 @@
 
   <para>
    <programlisting>
-    $ cd pgpool-II-&version/src/sql/pgpool-regclass
-    $ make
-    $ make install
+$ cd pgpool-II-&version/src/sql/pgpool-regclass
+$ make
+$ make install
    </programlisting>
    <!--
    After this:
@@ -557,8 +592,8 @@
    この後に以下か、
 
    <programlisting>
-    $ psql template1
-    =# CREATE EXTENSION pgpool_regclass;
+$ psql template1
+=# CREATE EXTENSION pgpool_regclass;
    </programlisting>
 
    <!--
@@ -567,7 +602,7 @@
    または
 
    <programlisting>
-    $ psql -f pgpool-regclass.sql template1
+$ psql -f pgpool-regclass.sql template1
    </programlisting>
 
    を実行します。
@@ -623,8 +658,8 @@
    このテーブルに対するロックは、<command>VACUUM</command>と競合するため、<command>INSERT</command>処理が長時間待たされ続ける可能性があります。
 
    <programlisting>
-    $ cd pgpool-II-&version/src/sql
-    $ psql -f insert_lock.sql template1
+$ cd pgpool-II-&version/src/sql
+$ psql -f insert_lock.sql template1
    </programlisting>
 
   </para>
@@ -667,7 +702,7 @@
     ユーザが読めるHTMLドキュメントを生成するには、docbookツールを使ってコンパイルする必要があります。
     RHEL類似のシステムでツールをインストールするには、以下を実行します。
     <programlisting>
-     yum install docbook-dtds docbook-style-dsssl docbook-style-xsl libxslt openjade
+dnf install --enablerepo=powertools docbook-dtds docbook-style-dsssl docbook-style-xsl libxslt openjade
     </programlisting>
    </para>
   </sect2>
@@ -683,11 +718,11 @@
     -->
     ツールセットがインストールされたら、以下のようにコンパイルします。
     <programlisting>
-     $ cd doc
-     $ make
-     $ cd ..
-     $ cd doc.ja
-     $ make
+$ cd doc
+$ make
+$ cd ..
+$ cd doc.ja
+$ make
     </programlisting>
     <!--
     You will see English HTML docs under doc/src/sgml/html, and online docs under sgml/man[1-8].
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 454f91965..4f9caa82e 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -245,9 +245,25 @@
  <sect1 id="install-pgpool">
   <title>Installing Pgpool-II</title>
   <para>
-   After extracting the source tarball, execute the <filename>configure</> script.
+   After extracting the source tarball, follow the steps below to build
+   the source code and install <productname>Pgpool-II</productname>.
+  </para>
+  <para>
+   Since <productname>Pgpool-II</productname> 4.5, files such as
+   <filename>configure</filename> generated by <command>autoconf/autoreconf</command>
+   have been removed from the repository, so first run
+   <command>autoreconf -fi</command> to generate <filename>configure</filename>.
    <programlisting>
-    ./configure
+dnf install libtool
+
+cd pgpool-II-&version;
+autoreconf -fi
+   </programlisting>
+  </para>
+  <para>
+   Next, execute the <filename>configure</> script.
+   <programlisting>
+./configure
    </programlisting>
   </para>
 
@@ -347,9 +363,15 @@
   </variablelist>
 
   <para>
+   Compile the source file.
+   <programlisting>
+make
+   </programlisting>
+  </para>
+  <para>
+   Install <productname>Pgpool-II</productname>.
    <programlisting>
-    make
-    make install
+make install
    </programlisting>
    This will install <productname>Pgpool-II</>. (If you use <productname>Solaris</> or <productname>FreeBSD</>, replace <command>make</> with <command>gmake</>)
   </para>
@@ -372,19 +394,19 @@
    This is required in all <productname>Pgpool-II</productname>
    installation.
    <programlisting>
-    $ cd pgpool-II-&version/src/sql/pgpool-recovery
-    $ make
-    $ make install
+$ cd pgpool-II-&version/src/sql/pgpool-recovery
+$ make
+$ make install
    </programlisting>
    After this:
    <programlisting>
-    $ psql template1
-    =# CREATE EXTENSION pgpool_recovery;
+$ psql template1
+=# CREATE EXTENSION pgpool_recovery;
    </programlisting>
 
    or
    <programlisting>
-    $ psql -f pgpool-recovery.sql template1
+$ psql -f pgpool-recovery.sql template1
    </programlisting>
 
   </para>
@@ -397,12 +419,12 @@
    add following to <filename>postgresql.conf</filename>.
 
    <programlisting>
-    pgpool.pg_ctl = '/usr/local/pgsql/bin/pg_ctl'
+pgpool.pg_ctl = '/usr/local/pgsql/bin/pg_ctl'
    </programlisting>
 
    Probably you want to execute following after this:
    <programlisting>
-    $ pg_ctl reload -D /usr/local/pgsql/data
+$ pg_ctl reload -D /usr/local/pgsql/data
    </programlisting>
 
   </para>
@@ -432,21 +454,21 @@
 
   <para>
    <programlisting>
-    $ cd pgpool-II-&version/src/sql/pgpool-regclass
-    $ make
-    $ make install
+$ cd pgpool-II-&version/src/sql/pgpool-regclass
+$ make
+$ make install
    </programlisting>
    After this:
 
    <programlisting>
-    $ psql template1
-    =# CREATE EXTENSION pgpool_regclass;
+$ psql template1
+=# CREATE EXTENSION pgpool_regclass;
    </programlisting>
 
    or 
 
    <programlisting>
-    $ psql -f pgpool-regclass.sql template1
+$ psql -f pgpool-regclass.sql template1
    </programlisting>
 
    Executing <command>CREATE EXTENSION</command>
@@ -483,8 +505,8 @@
    processing may be thereby kept waiting for a long time.
 
    <programlisting>
-    $ cd pgpool-II-&version/src/sql
-    $ psql -f insert_lock.sql template1
+$ cd pgpool-II-&version/src/sql
+$ psql -f insert_lock.sql template1
    </programlisting>
 
   </para>
@@ -512,7 +534,7 @@
     compile them using docbook tools. To install Docbook tools on
     RHEL or similar systems, use:
     <programlisting>
-     yum install docbook-dtds docbook-style-dsssl docbook-style-xsl libxslt openjade
+dnf install --enablerepo=powertools docbook-dtds docbook-style-dsssl docbook-style-xsl libxslt openjade
     </programlisting>
    </para>
   </sect2>
@@ -522,11 +544,11 @@
    <para>
     Once the tool sets are installed on the system, you can compile the docs:
     <programlisting>
-     $ cd doc
-     $ make
-     $ cd ..
-     $ cd doc.ja
-     $ make
+$ cd doc
+$ make
+$ cd ..
+$ cd doc.ja
+$ make
     </programlisting>
     You will see English HTML docs under doc/src/sgml/html, and online docs under sgml/man[1-8].
     Japanese docs can be found under doc.ja/src/sgml/html, and online docs under sgml/man[1-8].
-- 
2.39.5