doc: Add more documentation about wal_retrieve_retry_interval

from Michael Paquier

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 5a25b0308ed070a87ed267a2afaa2962ec9a1548..c8445c51997860a1a20ca675b0e2146318f8c227 100644 (file)
--- 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>