From e0067db2e901d0dbf4e816a7e0fd4a26906c2659 Mon Sep 17 00:00:00 2001
From: Tatsuo Ishii <ishii@sraoss.co.jp>
Date: Sun, 2 Jun 2019 11:40:40 +0900
Subject: [PATCH] Doc: add description to pg_md5 man page how to show
 pool_passwd ready string.

Sometimes it is necessary to just show md5 hash string suitable for
pool_passwd, without adding an entry to pool_passwd.
---
 doc.ja/src/sgml/ref/pg_md5.sgml | 10 +++++++++-
 doc/src/sgml/ref/pg_md5.sgml    | 11 ++++++++++-
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/doc.ja/src/sgml/ref/pg_md5.sgml b/doc.ja/src/sgml/ref/pg_md5.sgml
index ceebe39b8..d61f3139a 100644
--- a/doc.ja/src/sgml/ref/pg_md5.sgml
+++ b/doc.ja/src/sgml/ref/pg_md5.sgml
@@ -146,12 +146,20 @@ acbd18db4cc2f85cedef654fccc4a4d8
       また、<command>pg_md5</command> は、<xref linkend="guc-pool-passwd"> に
       ユーザー名と<literal>md5</literal> 暗号化されたパスワードのエントリを生成するためにも使用できます。
       <programlisting>
-$pg_md5 -m -f /path/to/pgpool.conf -u username -p
+$ pg_md5 -m -f /path/to/pgpool.conf -u username -p
 password: [your password]
 
 $ cat /path/to/pool_passwd 
 username:md55a231fcdb710d73268c4f44283487ba2
       </programlisting>
+
+      <xref linkend="guc-pool-passwd"> にエントリを登録せず、md5ハッシュされた文字列だけを表示させるには、引数としてパスワードとユーザ名を連結した文字列を渡します。
+	例として、パスワードに"password"、ユーザ名に"user"を渡す例を示します。
+      <programlisting>
+$ pg_md5 passworduser
+4d45974e13472b5a0be3533de4666414
+      </programlisting>
+      実際に<xref linkend="guc-pool-passwd">に登録するエントリは、先頭に"md5"を挿入してください。つまり、"md54d45974e13472b5a0be3533de4666414"となることに注意してください。
     </para>
  </refsect1>
 </refentry>
diff --git a/doc/src/sgml/ref/pg_md5.sgml b/doc/src/sgml/ref/pg_md5.sgml
index 5b1050275..edf4486ed 100644
--- a/doc/src/sgml/ref/pg_md5.sgml
+++ b/doc/src/sgml/ref/pg_md5.sgml
@@ -112,12 +112,21 @@ acbd18db4cc2f85cedef654fccc4a4d8
       <literal>md5</literal> encrypted password to 
       <xref linkend="guc-pool-passwd"> authentication file.
       <programlisting>
-$pg_md5 -m -f /path/to/pgpool.conf -u username -p
+$ pg_md5 -m -f /path/to/pgpool.conf -u username -p
 password: [your password]
 
 $ cat /path/to/pool_passwd 
 username:md55a231fcdb710d73268c4f44283487ba2
       </programlisting>
+      To just display the md5 hashed string, not adding an entry to <xref linkend="guc-pool-passwd">, pass a string concatenating password and user name.
+	For example, if password is "password" and user name is "user", the output would be:
+      <programlisting>
+$ pg_md5 passworduser
+4d45974e13472b5a0be3533de4666414
+      </programlisting>
+      Please note that the actual entry to be inserted into
+      <xref linkend="guc-pool-passwd"> should have "md5" on top of the
+      result string. That is: "md54d45974e13472b5a0be3533de4666414".
     </para>
  </refsect1>
 </refentry>
-- 
2.39.5