documentation/8610: Nested server-side include documentation needs clarification.

[Fred B <fr...@hotmail.com>]

>Number:         8610
>Category:       documentation
>Synopsis:       Nested server-side include documentation needs clarification.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    apache
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   apache
>Arrival-Date:   Wed Oct 24 13:40:00 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     fredb86@hotmail.com
>Release:        1.3.22
>Organization:
apache
>Environment:
Apache 1.3.22. FreeBSD 4.4, but probably all platforms. 
>Description:

When doing server-side includes using the "file" or "virtual" directive, e.g.

<!--#include virtual="stupidname.txt"" -->

Any file extension may be used. In the above example, I used ".txt"

HOWEVER, if you want to do *nested* includes, the file
name MUST have the ".shtml" extension, e.g.

<!--#include virtual="stupidname.shtml"" -->

Inside of stupidname.shtml, you might have another include which
also must end in ".shtml", e.g.

<!--#include virtual="insidestupid.shtml"" -->


This clarification is important because some web servers,
like MS IIS, let you use other extensions, such as ".stm"
for nested SSI's. Also, the fact that you can use any
file extension for regular SSI's, but must use ".shtml"
for nested SSI's, needs to be spelled out in the docs.

>How-To-Repeat:

>Fix:

>Release-Note:
>Audit-Trail:
>Unformatted:
 [In order for any reply to be added to the PR database, you need]
 [to include <ap...@Apache.Org> in the Cc line and make sure the]
 [subject line starts with the report component and number, with ]
 [or without any 'Re:' prefixes (such as "general/1098:" or      ]
 ["Re: general/1098:").  If the subject doesn't match this       ]
 [pattern, your message will be misfiled and ignored.  The       ]
 ["apbugs" address is not added to the Cc line of messages from  ]
 [the database automatically because of the potential for mail   ]
 [loops.  If you do not include this Cc, your reply may be ig-   ]
 [nored unless you are responding to an explicit request from a  ]
 [developer.  Reply only with text; DO NOT SEND ATTACHMENTS!     ]