From: Joshua Slive Date: Mon, 23 Jul 2001 15:50:47 +0000 (+0000) Subject: Some doc updates realted to ssi. X-Git-Tag: 2.0.22~60 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=2761ae73425eb19468f73fe7bcd747db1076d6c8;p=apache Some doc updates realted to ssi. 1. Add info on how to activate ssi to upgrading.html. 2. Remove mention of the ssi magic mime-types, since they no longer work. 3. Place a warning on xbithack that it doesn't currently work, and reference the bug report. 4. Add a warning about mod_include parsing non-html content. 5. Misc little fixups. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@89655 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/howto/ssi.html.en b/docs/manual/howto/ssi.html.en index 861545fbe1..19de050bc5 100644 --- a/docs/manual/howto/ssi.html.en +++ b/docs/manual/howto/ssi.html.en @@ -83,7 +83,7 @@ Tutorial: Introduction to Server Side Includes Options
XBitHack
AddType
-AddHandler
+SetOutputFilter
BrowserMatchNoCase
diff --git a/docs/manual/mod/mod_include.html b/docs/manual/mod/mod_include.html index ee32bf010a..722120ea03 100644 --- a/docs/manual/mod/mod_include.html +++ b/docs/manual/mod/mod_include.html @@ -49,7 +49,7 @@ variables.

See also: Options -and AddHandler.

+and SetOutputFilter.

Enabling Server-Side Includes

@@ -68,6 +68,16 @@ AddType text/html .shtml
</FilesMatch> +

Be careful to properly scope the INCLUDES filter to process only +the correct files. The filter is not restricted to +processing only HTML files. So, for example, if the INCLUDES filter +is activated using a <Directory> section and that +directory includes GIF files, mod_include will process the GIF files. +This can have two adverse consequences: 1. there will be extra +overhead in serving these files, and 2. these files could become +corrupted if they happen to contain something that looks like an SSI +element.

+

The following directive must be given for the directories containing the shtml files (typically in a <Directory> section, but this directive is also valid .htaccess files if AllowOverride @@ -77,15 +87,8 @@ Options is set):

Options +Includes -

Alternatively the XBitHack -directive can be used to parse normal (text/html) files, -based on file permissions.

- -

For backwards compatibility, documents with mime type -text/x-server-parsed-html or -text/x-server-parsed-html3 will also be parsed -(and the resulting output given the mime type text/html) -as will documents with the handler server-parsed. +

For more information, see our Tutorial +on Server Side Includes.

Basic Elements

@@ -442,6 +445,12 @@ customized server error documents. REL="Help" >Module: mod_include

+

Warning: This directive is not yet working in +Apache 2.0. The issue is being tracked in PR7751.

+ + + The XBitHack directives controls the parsing of ordinary html documents. This directive only affects files associated with the MIME type text/html. XBitHack can take on the following values: diff --git a/docs/manual/upgrading.html b/docs/manual/upgrading.html index 9b315f5048..901927f595 100644 --- a/docs/manual/upgrading.html +++ b/docs/manual/upgrading.html @@ -24,9 +24,9 @@ Features document, or in the src/CHANGES file.