aboutsummaryrefslogtreecommitdiff
path: root/doc/src/sgml/archive-modules.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src/sgml/archive-modules.sgml')
-rw-r--r--doc/src/sgml/archive-modules.sgml12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/src/sgml/archive-modules.sgml b/doc/src/sgml/archive-modules.sgml
index 7064307d9e6..cf7438a7593 100644
--- a/doc/src/sgml/archive-modules.sgml
+++ b/doc/src/sgml/archive-modules.sgml
@@ -114,6 +114,18 @@ WARNING: archive_mode enabled, yet archiving is not configured
In the latter case, the server will periodically call this function, and
archiving will proceed only when it returns <literal>true</literal>.
</para>
+
+ <note>
+ <para>
+ When returning <literal>false</literal>, it may be useful to append some
+ additional information to the generic warning message. To do that, provide
+ a message to the <function>arch_module_check_errdetail</function> macro
+ before returning <literal>false</literal>. Like
+ <function>errdetail()</function>, this macro accepts a format string
+ followed by an optional list of arguments. The resulting string will be
+ emitted as the <literal>DETAIL</literal> line of the warning message.
+ </para>
+ </note>
</sect2>
<sect2 id="archive-module-archive">