From: pcs <pcs@unknown>
Date: Fri, 18 Apr 1997 22:13:50 +0000 (+0000)
Subject: Provide information on enabling SSI files. Document how to enable
X-Git-Tag: APACHE_1_2b9~39
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a6862a49c8aec27bbc89271db526af21c000166a;p=apache

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 93c7fb0b2f..291684a062 100644
--- 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