]> granicus.if.org Git - apache/commitdiff
Update transformations.
authorGraham Leggett <minfrin@apache.org>
Sun, 19 Sep 2010 13:04:44 +0000 (13:04 +0000)
committerGraham Leggett <minfrin@apache.org>
Sun, 19 Sep 2010 13:04:44 +0000 (13:04 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@998652 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/mod/mod_include.html.en
docs/manual/mod/mod_mime.xml.ja

index 00244bdc1c44173f05daf92a1342ff82cb3deb2a..a63dd8cfc1db3a65ab3d62b4b0c203d049a37d44 100644 (file)
       <dt><code>var</code></dt>
       <dd>The value is the name of the variable to print.</dd>
 
+      <dt><code>decoding</code></dt>
+      <dd><p>Specifies whether Apache should strip an encoding from
+      the variable before processing the variable further. The default
+      is <code>none</code>, where no decoding will be done. If set to
+      <code>url</code>, then URL decoding (also known as %-encoding;
+      this is appropriate for use within URLs in links, etc.) will be
+      performed. If set to <code>base64</code>, base64 will be decoded,
+      and if set to <code>entity</code>, HTML entity encoding will be
+      stripped. Decoding is done prior to any further encoding on the
+      variable. Multiple encodings can be stripped by specifying more
+      than one comma separated encoding. The decoding setting will
+      remain in effect until the next decoding attribute is encountered,
+      or the element ends.</p>
+
+      <p>The <code>decoding</code> attribute must <em>precede</em> the
+      corresponding <code>var</code> attribute to be effective.</p>
+      </dd>
+        
       <dt><code>encoding</code></dt>
       <dd><p>Specifies how Apache should encode special characters
       contained in the variable before outputting them. If set
       to <code>none</code>, no encoding will be done. If set to
       <code>url</code>, then URL encoding (also known as %-encoding;
       this is appropriate for use within URLs in links, etc.) will be
-      performed. At the start of an <code>echo</code> element,
+      performed. If set to <code>base64</code>, base64 encoding will
+      be performed. At the start of an <code>echo</code> element,
       the default is set to <code>entity</code>, resulting in entity
       encoding (which is appropriate in the context of a block-level
       HTML element, <em>e.g.</em> a paragraph of text). This can be
       is encountered or the element ends, whichever comes first.</p>
 
       <p>The <code>encoding</code> attribute must <em>precede</em> the
-      corresponding <code>var</code> attribute to be effective, and 
-      only special characters as defined in the ISO-8859-1 character
-      encoding will be encoded. This encoding process may not have the
-      desired result if a different character encoding is in use.</p>
+      corresponding <code>var</code> attribute to be effective.</p>
 
       <div class="warning">
         In order to avoid cross-site scripting issues, you should
 
       <dt><code>value</code></dt>
       <dd>The value to give a variable.</dd>
+
+      <dt><code>decoding</code></dt>
+      <dd><p>Specifies whether Apache should strip an encoding from
+      the variable before processing the variable further. The default
+      is <code>none</code>, where no decoding will be done. If set to
+      <code>url</code>, <code>base64</code> or <code>entity</code>,
+      URL decoding, base64 decoding or HTML entity decoding will be
+      performed respectively. More than one decoding can be specified
+      by separating with commas. The decoding setting will remain in
+      effect until the next decoding attribute is encountered, or the
+      element ends. The <code>decoding</code> attribute must
+      <em>precede</em> the corresponding <code>var</code> attribute to
+      be effective.</p>
+      </dd>
+      
+      <dt><code>encoding</code></dt>
+      <dd><p>Specifies how Apache should encode special characters
+      contained in the variable before setting them. The default is
+      <code>none</code>, where no encoding will be done. If set to
+      <code>url</code>, <code>base64</code> or <code>entity</code>,
+      URL encoding, base64 encoding or HTML entity encoding will be
+      performed respectively. More than one encoding can be specified
+      by separating with commas. The encoding setting will remain in
+      effect until the next encoding attribute is encountered, or the
+      element ends. The <code>encoding</code> attribute must
+      <em>precede</em> the corresponding <code>var</code> attribute
+      to be effective. Encodings are applied after all decodings have
+      been stripped.</p>
+      </dd>
       </dl>
 
       <div class="example"><h3>Example</h3><p><code>
index 000467d581dc341a88b4d1707ff846550d3e1e2d..c4322f7f5b887522e8ce7dc4bca98e1539e15e72 100644 (file)
@@ -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: 659902:990109 (outdated) -->
+<!-- English Revision: 659902:998553 (outdated) -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more