diff --git a/docs/manual/mod/mod_include.html.en b/docs/manual/mod/mod_include.html.en index 00244bdc1c..a63dd8cfc1 100644 --- a/docs/manual/mod/mod_include.html.en +++ b/docs/manual/mod/mod_include.html.en @@ -199,13 +199,32 @@
var
The value is the name of the variable to print.
+
decoding
+

Specifies whether Apache should strip an encoding from + the variable before processing the variable further. The default + is none, where no decoding will be done. If set to + url, then URL decoding (also known as %-encoding; + this is appropriate for use within URLs in links, etc.) will be + performed. If set to base64, base64 will be decoded, + and if set to entity, 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.

+ +

The decoding attribute must precede the + corresponding var attribute to be effective.

+
+
encoding

Specifies how Apache should encode special characters contained in the variable before outputting them. If set to none, no encoding will be done. If set to url, 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 echo element, + performed. If set to base64, base64 encoding will + be performed. At the start of an echo element, the default is set to entity, resulting in entity encoding (which is appropriate in the context of a block-level HTML element, e.g. a paragraph of text). This can be @@ -214,10 +233,7 @@ is encountered or the element ends, whichever comes first.

The encoding attribute must precede the - corresponding var 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.

+ corresponding var attribute to be effective.

In order to avoid cross-site scripting issues, you should @@ -398,6 +414,35 @@
value
The value to give a variable.
+ +
decoding
+

Specifies whether Apache should strip an encoding from + the variable before processing the variable further. The default + is none, where no decoding will be done. If set to + url, base64 or entity, + 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 decoding attribute must + precede the corresponding var attribute to + be effective.

+
+ +
encoding
+

Specifies how Apache should encode special characters + contained in the variable before setting them. The default is + none, where no encoding will be done. If set to + url, base64 or entity, + 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 encoding attribute must + precede the corresponding var attribute + to be effective. Encodings are applied after all decodings have + been stripped.

+

Example

diff --git a/docs/manual/mod/mod_mime.xml.ja b/docs/manual/mod/mod_mime.xml.ja index 000467d581..c4322f7f5b 100644 --- a/docs/manual/mod/mod_mime.xml.ja +++ b/docs/manual/mod/mod_mime.xml.ja @@ -1,7 +1,7 @@ - +