doc: Add more documentation about wal_retrieve_retry_interval

petere · petere · commit f1824e55137f · 2015-11-23T09:13:44.000-05:00
from Michael Paquier
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
@@ -3035,6 +3035,17 @@ include_dir 'conf.d'
         <filename>postgresql.conf</> file or on the server command line.
         The default value is 5 seconds. Units are milliseconds if not specified.
        </para>
+       <para>
+        This parameter is useful in configurations where a node in recovery
+        needs to control the amount of time to wait for new WAL data to be
+        available. For example, in archive recovery, it is possible to
+        make the recovery more responsive in the detection of a new WAL
+        log file by reducing the value of this parameter. On a system with
+        low WAL activity, increasing it reduces the amount of requests necessary
+        to access WAL archives, something useful for example in cloud
+        environments where the amount of times an infrastructure is accessed
+        is taken into account.
+       </para>
       </listitem>
      </varlistentry>
 
