PR57778
authorEric Covener <covener@apache.org>
Wed, 22 Apr 2015 17:19:37 +0000 (17:19 +0000)
committerEric Covener <covener@apache.org>
Wed, 22 Apr 2015 17:19:37 +0000 (17:19 +0000)
document legacy AddType/ForceType magic types as Handler names
for the curious.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1675426 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/mod/core.xml
docs/manual/mod/mod_mime.xml

index da9be22cb27f98dfe8b0dab6bc7ae94e055faf7a..85b2f9a141e264d4a91e82305a2dd5c019a4377a 100644 (file)
@@ -1892,6 +1892,20 @@ ForceType image/gif
     static files, where the generator of the response typically specifies
     a Content-Type, this directive has no effect.</p>
 
+    <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
+    to the current request, the internal handler name normally set by those
+    diretives 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 user of
+    <directive module="core" >SetHandler</directive> or
+    <directive module="mod_mime">AddHandler</directive>. </p>
+    </note>
+
 </usage>
 </directivesynopsis>
 <directivesynopsis>
index 8d900072961432efa0732df4e496f5d52fbf8f57..374e1057fcb17e5b18350a7523038aa5529c3e33 100644 (file)
@@ -608,6 +608,21 @@ AddType application/rss+xml;qs=0.8 .xml
     static files, where the generator of the response typically specifies
     a Content-Type, this directive has no effect.</p>
 
+
+    <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 
+    to the current request, the internal handler name normally set by those
+    diretives 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 user of 
+    <directive module="core" >SetHandler</directive> or 
+    <directive module="mod_mime">AddHandler</directive>. </p>
+    </note>
+
 </usage>
 <seealso><directive module="core">ForceType</directive></seealso>
 <seealso><module>mod_negotiation</module></seealso>