svn commit: r1437837 - in /httpd/httpd/branches/2.4.x/docs/manual: ./ mod/ mod/mod_include.html.en mod/mod_include.xml.ja

[rb...@apache.org]

Author: rbowen
Date: Thu Jan 24 02:07:41 2013
New Revision: 1437837

URL: http://svn.apache.org/viewvc?rev=1437837&view=rev
Log:
rebuild

Modified:
    httpd/httpd/branches/2.4.x/docs/manual/   (props changed)
    httpd/httpd/branches/2.4.x/docs/manual/mod/   (props changed)
    httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.html.en
    httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.ja

Propchange: httpd/httpd/branches/2.4.x/docs/manual/
------------------------------------------------------------------------------
  Merged /httpd/httpd/trunk/docs/manual:r1437833

Propchange: httpd/httpd/branches/2.4.x/docs/manual/mod/
------------------------------------------------------------------------------
  Merged /httpd/httpd/trunk/docs/manual/mod:r1437808,1437821,1437826,1437833

Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.html.en?rev=1437837&r1=1437836&r2=1437837&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.html.en (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.html.en Thu Jan 24 02:07:41 2013
@@ -271,6 +271,10 @@ AddOutputFilter INCLUDES .shtml
         In order to avoid cross-site scripting issues, you should
         <em>always</em> encode user supplied data.
       </div>
+
+      <div class="example"><h3>Example</h3><p><code>
+        &lt;!--#echo encoding="entity" var="QUERY_STRING" --&gt;
+      </code></p></div>
       </dd>
       </dl>
      
@@ -352,7 +356,18 @@ 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.
+
+    <div class="example"><p><code>
+        This file is &lt;!--#fsize file="mod_include.html" --&gt; bytes.
+    </code></p></div>
+
+    The value of <code>file</code> cannot start with a slash
+    (<code>/</code>), nor can it contain <code>../</code> so as to 
+    refer to a file above the current directory or outside of the
+    document root. 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
@@ -360,6 +375,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>
+
+    <div class="example"><p><code>
+        This file is &lt;!--#fsize virtual="/docs/mod/mod_include.html" --&gt; bytes.
+    </code></p></div>
+
+      <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>
      
 
     <h3><a name="element.flastmod" id="element.flastmod">The flastmod Element</a></h3>
@@ -449,12 +472,14 @@ AddOutputFilter INCLUDES .shtml
      
 
     <h3><a name="element.printenv" id="element.printenv">The printenv Element</a></h3>
-      <p>This prints out a listing of all existing variables and
+      <p>This prints out a plain text listing of all existing variables and
       their values. Special characters are entity encoded (see the <code><a href="#element.echo">echo</a></code> element for details)
       before being output. There are no attributes.</p>
 
       <div class="example"><h3>Example</h3><p><code>
-        &lt;!--#printenv --&gt;
+        &lt;pre&gt;
+          &lt;!--#printenv --&gt;
+        &lt;/pre&gt;
       </code></p></div>
      
 

Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.ja
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.ja?rev=1437837&r1=1437836&r2=1437837&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.ja [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_include.xml.ja [utf-8] Thu Jan 24 02:07:41 2013
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 656287:1433793 (outdated) -->
+<!-- English Revision: 656287:1437834 (outdated) -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more