httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rbo...@apache.org
Subject svn commit: r1437822 - /httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml
Date Thu, 24 Jan 2013 01:16:44 GMT
Author: rbowen
Date: Thu Jan 24 01:16:44 2013
New Revision: 1437822

URL: http://svn.apache.org/viewvc?rev=1437822&view=rev
Log:
Adds examples for fsize and clarifies the difference between file and virtual

Modified:
    httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml

Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml?rev=1437822&r1=1437821&r2=1437822&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml Thu Jan 24 01:16:44 2013
@@ -333,7 +333,17 @@ AddOutputFilter INCLUDES .shtml
       <dl>
       <dt><code>file</code></dt>
       <dd>The value is a path relative to the directory
-      containing the current document being parsed.</dd>
+      containing the current document being parsed.
+
+    <example>
+        This file is &lt;!--#fsize file="mod_include.html" --&gt; bytes.
+    </example>
+
+    The value of <code>file</code> cannot start with a slash, nor can it
+    refer to a file above the current directory. Attempting to so will
+    result in the error message: <code>The given path was above the root
+    path</code>.
+      </dd>
 
       <dt><code>virtual</code></dt>
       <dd>The value is a (%-encoded) URL-path. If it does not begin with
@@ -341,6 +351,14 @@ AddOutputFilter INCLUDES .shtml
       Note, that this does <em>not</em> print the size of any CGI output,
       but the size of the CGI script itself.</dd>
       </dl>
+
+    <example>
+        This file is &lt;!--#fsize virtual="/docs/mod/mod_include.html" --&gt; bytes.
+    </example>
+
+      <p>Note that in many cases these two are exactly the same thing.
+      However, the <code>file</code> attribute doesn't respect URL-space
+      aliases.</p>
     </section> <!-- /fsize -->
 
     <section id="element.flastmod"><title>The flastmod Element</title>



Mime
View raw message