Return-Path: 
 <docs-return-4382-apmail-httpd-docs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-docs-archive@httpd.apache.org
Received: (qmail 76631 invoked by uid 500); 15 Nov 2002 20:32:52 -0000
Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:docs-help@httpd.apache.org>
list-unsubscribe: <mailto:docs-unsubscribe@httpd.apache.org>
list-post: <mailto:docs@httpd.apache.org>
Reply-To: docs@httpd.apache.org
Delivered-To: mailing list docs@httpd.apache.org
Received: (qmail 76620 invoked from network); 15 Nov 2002 20:32:51 -0000
From: =?ISO-8859-1?Q?Andr=E9?= Malo <nd@perlig.de>
Subject: [Review] mod_include.xml rework
MIME-Version: 1.0
Content-Type: text/plain; charset="ISO-8859-1"
Content-Transfer-Encoding: quoted-printable
Organization: TIMTOWTDI
Date: Fri, 15 Nov 2002 21:31:05 +0100
To: docs@httpd.apache.org
Message-ID: <n2m-g.wrj9tycp8bou$ndparker@news.perlig.de>
User-Agent: Yes!
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

I did some rework on the mod_include documentation. The main intention was=
=20
to get more clearness for the user. It's a 50 K diff, so I put it online at
<http://cvs.apache.org/~nd/mod_include.diff>. The html output can be found=
=20
at <http://cvs.apache.org/~nd/manual/mod/mod_include.html>.

The main changes are (a bit unsorted):

formal:
- moved path_info section below the "enabling" section
- dropped "Using Server Side Includes for ErrorDocuments" section and added
  a simple seealso instead. I don't see, that we need a separate section to
  set a link.
- created an own subsection for every SSI element and put an overview table
  on top of it, this resolves also the mozilla problem with nested <dl>s,
  that was still present (sometimes)

content:
- added a note about the behaviour of fsize/flastmod virtual
- removed apache 1.2 compatibility notes (this is a 2.x documentation)
- added a compat note in the module overview table
- added description for QUERY_STRING_UNESCAPED
- splitted flow control descriptions (=3D, !=3D vs. <, <=3D, >, >=3D; the former=20
  allow regexps, the latter don't)
- added a sentence and an example about regexp capturing
- mentioned the literal comparison (vs. numerical)

the rest is mostly markup and reformatting.

Waiting for some comments, extensions, flames etc... ;-)

nd
--=20
"Die Untergeschosse der Sempergalerie bleiben w=E4hrenddessen aus
 statistischen Gr=FCnden geflutet." -- Spiegel Online

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org