From: Jan Kaluža <jkaluza@apache.org>
Date: Wed, 16 Apr 2014 11:51:42 +0000 (+0000)
Subject: core.xml: document Warning directive
X-Git-Tag: 2.4.10~336
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=142b7f2864b4df56827c87e151243f93bf34f022;p=apache

core.xml: document Warning directive


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1587881 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 29a37cec3b..0cf24bf3d7 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1174,6 +1174,7 @@ version 2.3.9.</compatibility>
     </highlight>
 
 </usage>
+<seealso><directive module="core">Warning</directive></seealso>
 </directivesynopsis>
 
 <directivesynopsis>
@@ -4431,4 +4432,29 @@ hostname or IP address</description>
     different sections are combined when a request is received</seealso>
 </directivesynopsis>
 
+<directivesynopsis>
+<name>Warning</name>
+<description>Show custom warning message</description>
+<syntax>Warning <var>message</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<compatibility>2.5.0 and later</compatibility>
+
+<usage>
+    <p>If an warning can be detected within the configuration, this
+    directive can be used to generate a custom warning message.</p>
+
+    <highlight language="config">
+# Example
+# show warning if mod_include is not loaded
+&lt;IfModule !include_module&gt;
+  Warning "mod_include is required by mod_foo. mod_foo will not be loaded"
+&lt;/IfModule&gt;
+    </highlight>
+
+</usage>
+<seealso><directive module="core">Error</directive></seealso>
+</directivesynopsis>
+
 </modulesynopsis>