sync note with trunk

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

diff --git a/docs/manual/mod/mod_mime.xml b/docs/manual/mod/mod_mime.xml
index cf93dc2462060be5503d380a752658fcf95307c6..bb38b19b8bde6b8aa8169d2dd099f751d2b79774 100644 (file)
--- a/docs/manual/mod/mod_mime.xml
+++ b/docs/manual/mod/mod_mime.xml
@@ -608,17 +608,25 @@ type</description>
 
 
     <note><title>Note</title>
-    <p>When explicit directives such as 
-    <directive module="core" >SetHandler</directive> or 
-    <directive module="mod_mime">AddHandler</directive> do not apply 
+    <p>If no handler is explicitly set for a request, the specified content
+    type will also be used as the handler name. </p>
+
+    <p>When explicit directives such as
+    <directive module="core" >SetHandler</directive> or
+    <directive module="mod_mime">AddHandler</directive> do not apply
     to the current request, the internal handler name normally set by those
-    directives is set to match the content type specified by this directive.  
-    This is a historical behavior that some third-party modules 
-    (such as mod_php) may use "magic" content types used only to signal the 
-    module to take responsibility for the matching request.  Configurations
-    that rely on such "magic" types should be avoided by the use of 
-    <directive module="core" >SetHandler</directive> or 
-    <directive module="mod_mime">AddHandler</directive>. </p>
+    directives is instead set to the content type specified by this directive.
+    </p>
+    <p>
+    This is a historical behavior that may be used by some third-party modules
+    (such as mod_php) for taking responsibility for the matching request.
+    </p>
+
+    <p>Configurations that rely on such "synthetic" types should be avoided.
+    Additionally, configurations that restrict access to
+    <directive module="core" >SetHandler</directive> or
+    <directive module="mod_mime">AddHandler</directive> should
+    restrict access to this directive as well.</p>
     </note>
 
 </usage>