include_if_exists facility for config file.

This works the same as include, except that an error is not thrown
if the file is missing. Instead the fact that it's missing is
logged.

Greg Smith, reviewed by Euler Taveira de Oliveira.

1 files changed, 12 insertions, 0 deletions

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index d1e628fefca..0cc329691dd 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -91,6 +91,18 @@ include 'filename'
 
    <para>
     <indexterm>
+     <primary><literal>include_if_exists</></primary>
+     <secondary>in configuration file</secondary>
+    </indexterm>
+    Use the same approach as the <literal>include</> directive, continuing
+    normally if the file does not exist.  A regular <literal>include</>
+    will stop with an error if the referenced file is missing, while
+    <literal>include_if_exists</> does not.  A warning about the missing
+    file will be logged.
+   </para>
+
+   <para>
+    <indexterm>
      <primary>SIGHUP</primary>
     </indexterm>
     The configuration file is reread whenever the main server process receives a