<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 <!--#fsize file="mod_include.html" --> 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
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 <!--#fsize virtual="/docs/mod/mod_include.html" --> 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>