Provide information on enabling SSI files. Document how to enable

SSI using a handler name, and relegate the magic mime types to back-compat.
status.

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

diff --git a/docs/manual/mod/mod_include.html b/docs/manual/mod/mod_include.html
index 93c7fb0b2f15764fedca879bfc95439df64b4560..291684a062ca3a8164cc8d5cd24de322e31299dd 100644 (file)
--- a/docs/manual/mod/mod_include.html
+++ b/docs/manual/mod/mod_include.html
@@ -10,15 +10,38 @@
 
 This module is contained in the <code>mod_include.c</code> file, and
 is compiled in by default. It provides for server-parsed html
-documents, known as SPML documents.  Any document with mime type
-<code>text/x-server-parsed-html</code> or
-<code>text/x-server-parsed-html3</code> will be parsed by this module,
-with the resulting output given the mime type <code>text/html</code>.
-Several directives beyond the original NCSA SPML definition have been
+documents. Several directives beyond the original NCSA definition have been
 included in Apache 1.2 - these are flagged below with the phrase
 "Apache 1.2 and above".  Of particular significance are the new flow 
 control directives documented at the bottom.
 
+<H2>Enabling Server-Side Includes</H2>
+
+Any document with handler of "server-parsed" will be parsed by this
+module, if the <CODE>Includes</CODE> option is set. If documents
+containing server-side include directives are given the extension
+.shtml, the following directives will make Apache parse them and
+assign the resulting document the mime type of <CODE>text/html</CODE>:
+
+<PRE>
+AddType text/html .shtml
+AddHandler server-parsed .shtml
+</PRE>
+
+The following directive must be given for the directories containing
+the shtml files (typically in a <CODE>&lt;Directory&gt;</CODE> section,
+but this directive is also valid .htaccess files if <CODE>AllowOverride
+Options</CODE> is set):
+
+<PRE>
+Options +Includes
+</PRE>
+
+For backwards compatibility, documents with mime type
+<code>text/x-server-parsed-html</code> or
+<code>text/x-server-parsed-html3</code> will also be parsed
+(and the resulting output given the mime type <code>text/html</code>).
+
 <h2>Basic Elements</h2>
 
 The document is parsed as an HTML document, with special commands embedded