[pgpool-hackers: 3625] DOC:wd_priority description is too promising

[Kenichiro Tanaka]

Hello pgpool hackers.

I fell we should change and add some description about  "wd_priority"
explanation of pgpool-II document .

https://www.pgpool.net/docs/latest/en/html/runtime-watchdog-config.html

-----------------------------------------------------------------------
wd_priority (integer)
This parameter can be used to elevate the local watchdog node priority
in the elections to select master watchdog node. The node with the higher
wd_priority value will get selected as master watchdog node when cluster
will be electing its new master node at the time of cluster startup or in
the event of old master watchdog node failure
-----------------------------------------------------------------------
Documentation says "cluster will be electing its new master node at the
time of cluster *startup* or in the event of old master watchdog node failure".
This description allows the user to expect higher wd_priority node always
to become new master node.But actually it is not elected if it starts late
(This is natural behavior for cluster).

So I think we should add or change some description about it.

For example,

diff --git a/doc/src/sgml/watchdog.sgml b/doc/src/sgml/watchdog.sgml
index 09549af..30db22d 100644
--- a/doc/src/sgml/watchdog.sgml
+++ b/doc/src/sgml/watchdog.sgml
@@ -486,7 +486,11 @@
       to select master watchdog node.
       The node with the higher <varname>wd_priority</varname> value
will get selected
       as master watchdog node when cluster will be electing its new master node
-      at the time of cluster startup or in the event of old master
watchdog node failure
+      in the event of old master watchdog node failure.
+      <varname>wd_priority</varname> is also valid at the time of
cluster startup.
+      When some watchdog nodes start up at same time,a node with the
higher <varname>wd_priority</varname>
+      value is selected as a master node.
+      So we should start watchdog nodes order by
<varname>wd_priority</varname> priority.
    </para>
   <para>
      <varname>wd_priority</varname> is not available in versions prior to

Regards Kenichiro Tanaka