Return-Path: Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 62227 invoked by uid 500); 7 Nov 2002 04:36:26 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 62200 invoked by uid 500); 7 Nov 2002 04:36:25 -0000 Delivered-To: apmail-httpd-2.0-cvs@apache.org Date: 7 Nov 2002 04:35:57 -0000 Message-ID: <20021107043557.67072.qmail@icarus.apache.org> From: nd@apache.org To: httpd-2.0-cvs@apache.org Subject: cvs commit: httpd-2.0/docs/manual/mod mod_charset_lite.html.en mod_charset_lite.xml quickreference.html.en X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N nd 2002/11/06 20:35:57 Modified: docs/manual/mod mod_charset_lite.html.en mod_charset_lite.xml quickreference.html.en Log: - -> - whitespace reformatting - little markup improvements - typo -> update transformation Revision Changes Path 1.13 +53 -48 httpd-2.0/docs/manual/mod/mod_charset_lite.html.en Index: mod_charset_lite.html.en =================================================================== RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_charset_lite.html.en,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- mod_charset_lite.html.en 7 Oct 2002 15:23:01 -0000 1.12 +++ mod_charset_lite.html.en 7 Nov 2002 04:35:56 -0000 1.13 @@ -11,7 +11,7 @@ mod_charset_lite.c

Summary

This is an experimental module and should be used with care. Experiment with your - mod_charset_lite configuration to ensure that it + mod_charset_lite configuration to ensure that it performs the desired function.

mod_charset_lite allows the administrator to @@ -22,7 +22,7 @@ perform. mod_charset_lite is applicable to EBCDIC and ASCII host environments. In an EBCDIC environment, Apache normally translates text content from the code page of the Apache - process locale to ISO-8859-1. mod_charset_lite + process locale to ISO-8859-1. mod_charset_lite can be used to specify that a different translation is to be performed. In an ASCII environment, Apache normally performs no translation, so mod_charset_lite is needed in @@ -34,41 +34,42 @@

Directives

Topics

  • Common Problems
top

Common Problems

+

Topics

top

Common Problems

-

Invalid character set names

- -

The character set name parameters of CharsetSourceEnc and - CharsetDefault - must be acceptable to the translation mechanism used by APR on the - system where mod_charset_lite is deployed. These - character set names are not standardized and are usually not the - same as the corresponding values used in http headers. Currently, - APR can only use iconv(3), so you can easily test your character - set names using the iconv(1) program, as follows:

-

- iconv -f charsetsourceenc-value -t charsetdefault-value -

+

Invalid character set names

+

The character set name parameters of CharsetSourceEnc and + CharsetDefault + must be acceptable to the translation mechanism used by APR on the + system where mod_charset_lite is deployed. These + character set names are not standardized and are usually not the + same as the corresponding values used in http headers. Currently, + APR can only use iconv(3), so you can easily test your character + set names using the iconv(1) program, as follows:

+ +

+ iconv -f charsetsourceenc-value -t charsetdefault-value +

+ -

Mismatch between character set of content and translation +

Mismatch between character set of content and translation rules

-

If the translation rules don't make sense for the content, - translation can fail in various ways, including:

+

If the translation rules don't make sense for the content, + translation can fail in various ways, including:

-
    +
    • The translation mechanism may return a bad return code, and the connection will be aborted.
    • The translation mechanism may silently place special characters (e.g., question marks) in the output buffer when it cannot translate the input buffer.
    • -
    - +
+
top

CharsetDefault Directive

Description: Charset to translate into
Syntax: - CharsetDefault charset
Context: + CharsetDefault charset
Context: server config, virtual host, directory, .htaccess
Override: FileInfo
Status: Experimental
Module: @@ -77,32 +78,33 @@ charset that content in the associated container should be translated to.

-

The value of the charset argument must be accepted +

The value of the charset argument must be accepted as a valid character set name by the character set support in APR. Generally, this means that it must be supported by iconv.

-

Example

- <Directory "/export/home/trawick/apacheinst/htdocs/convert">
- CharsetSourceEnc UTF-16BE
- CharsetDefault ISO-8859-1
- </Directory> -

+

Example

+ <Directory /export/home/trawick/apacheinst/htdocs/convert>
+ + CharsetSourceEnc UTF-16BE
+ CharsetDefault ISO-8859-1
+
+ </Directory> +

top

CharsetOptions Directive

Description: - Configures charset tranlation behavior
Syntax: - CharsetOptions option [option] ...
Default: - CharsetOptions DebugLevel=0 -NoImplicitAdd
Context: + Configures charset translation behavior
Syntax: + CharsetOptions option [option] ...
Default: + CharsetOptions DebugLevel=0 NoImplicitAdd
Context: server config, virtual host, directory, .htaccess
Override: FileInfo
Status: Experimental
Module: mod_charset_lite

The CharsetOptions directive configures certain - behaviors of mod_charset_lite. Option can + behaviors of mod_charset_lite. Option can be one of

-
DebugLevel=n
+
DebugLevel=n
The DebugLevel keyword allows you to specify the level of debug messages generated by @@ -114,19 +116,19 @@ DBGLVL_ constants near the beginning of mod_charset_lite.c.
-
ImplicitAdd | NoImplicitAdd
+
ImplicitAdd | NoImplicitAdd
The ImplicitAdd keyword specifies that mod_charset_lite should implicitly insert its filter when the configuration specifies that the character set of content should be translated. If the filter chain is - explicitly configured using the AddOutputFilter directive, - NoImplicitAdd should be specified so that - mod_charset_lite doesn't add its filter.
+ explicitly configured using the AddOutputFilter directive, NoImplicitAdd + should be specified so that mod_charset_lite + doesn't add its filter.
top

CharsetSourceEnc Directive

- - - + + +
Description: Source charset of files
Syntax: - CharsetSourceEnc charset
Context: + CharsetSourceEnc charset
Context: server config, virtual host, directory, .htaccess
Override: FileInfo
Status: Experimental
Module: @@ -134,17 +136,20 @@

The CharsetSourceEnc directive specifies the source charset of files in the associated container.

-

The value of the charset argument must be accepted +

The value of the charset argument must be accepted as a valid character set name by the character set support in APR. Generally, this means that it must be supported by iconv.

-

Example

- <Directory "/export/home/trawick/apacheinst/htdocs/convert">
- CharsetSourceEnc UTF-16BE
- CharsetDefault ISO-8859-1
- </Directory> -

+

Example

+ <Directory /export/home/trawick/apacheinst/htdocs/convert>
+ + CharsetSourceEnc UTF-16BE
+ CharsetDefault ISO-8859-1
+
+ </Directory> +

+

The character set names in this example work with the iconv translation support in Solaris 8.

1.6 +55 -49 httpd-2.0/docs/manual/mod/mod_charset_lite.xml Index: mod_charset_lite.xml =================================================================== RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_charset_lite.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- mod_charset_lite.xml 7 Sep 2002 11:55:55 -0000 1.5 +++ mod_charset_lite.xml 7 Nov 2002 04:35:56 -0000 1.6 @@ -12,7 +12,7 @@

This is an experimental module and should be used with care. Experiment with your - mod_charset_lite configuration to ensure that it + mod_charset_lite configuration to ensure that it performs the desired function.

mod_charset_lite allows the administrator to @@ -23,7 +23,7 @@ perform. mod_charset_lite is applicable to EBCDIC and ASCII host environments. In an EBCDIC environment, Apache normally translates text content from the code page of the Apache - process locale to ISO-8859-1. mod_charset_lite + process locale to ISO-8859-1. mod_charset_lite can be used to specify that a different translation is to be performed. In an ASCII environment, Apache normally performs no translation, so mod_charset_lite is needed in @@ -34,45 +34,46 @@ mod_charset.

-
Common Problems +
Common Problems -
Invalid character set names +
Invalid character set names -

The character set name parameters of CharsetSourceEnc and - CharsetDefault - must be acceptable to the translation mechanism used by APR on the - system where mod_charset_lite is deployed. These - character set names are not standardized and are usually not the - same as the corresponding values used in http headers. Currently, - APR can only use iconv(3), so you can easily test your character - set names using the iconv(1) program, as follows:

- - iconv -f charsetsourceenc-value -t charsetdefault-value - -
+

The character set name parameters of CharsetSourceEnc and + CharsetDefault + must be acceptable to the translation mechanism used by APR on the + system where mod_charset_lite is deployed. These + character set names are not standardized and are usually not the + same as the corresponding values used in http headers. Currently, + APR can only use iconv(3), so you can easily test your character + set names using the iconv(1) program, as follows:

+ + + iconv -f charsetsourceenc-value -t charsetdefault-value + +
-
Mismatch between character set of content and translation + <section><title>Mismatch between character set of content and translation rules -

If the translation rules don't make sense for the content, - translation can fail in various ways, including:

+

If the translation rules don't make sense for the content, + translation can fail in various ways, including:

-
    +
    • The translation mechanism may return a bad return code, and the connection will be aborted.
    • The translation mechanism may silently place special characters (e.g., question marks) in the output buffer when it cannot translate the input buffer.
    • -
    -
+ +
CharsetSourceEnc Source charset of files -CharsetSourceEnc charset +CharsetSourceEnc charset server config virtual hostdirectory .htaccess @@ -83,17 +84,20 @@

The CharsetSourceEnc directive specifies the source charset of files in the associated container.

-

The value of the charset argument must be accepted +

The value of the charset argument must be accepted as a valid character set name by the character set support in APR. Generally, this means that it must be supported by iconv.

-Example - <Directory "/export/home/trawick/apacheinst/htdocs/convert">
- CharsetSourceEnc UTF-16BE
- CharsetDefault ISO-8859-1
- </Directory> -
+ Example + <Directory /export/home/trawick/apacheinst/htdocs/convert>
+ + CharsetSourceEnc UTF-16BE
+ CharsetDefault ISO-8859-1
+
+ </Directory> +
+

The character set names in this example work with the iconv translation support in Solaris 8.

@@ -102,7 +106,7 @@ CharsetDefault Charset to translate into -CharsetDefault charset +CharsetDefault charset server config virtual hostdirectory .htaccess @@ -114,26 +118,27 @@ charset that content in the associated container should be translated to.

-

The value of the charset argument must be accepted +

The value of the charset argument must be accepted as a valid character set name by the character set support in APR. Generally, this means that it must be supported by iconv.

-Example - <Directory "/export/home/trawick/apacheinst/htdocs/convert">
- CharsetSourceEnc UTF-16BE
- CharsetDefault ISO-8859-1
- </Directory> -
+ Example + <Directory /export/home/trawick/apacheinst/htdocs/convert>
+ + CharsetSourceEnc UTF-16BE
+ CharsetDefault ISO-8859-1
+
+ </Directory> +
CharsetOptions -Configures charset tranlation behavior -CharsetOptions option [option] ... -CharsetOptions DebugLevel=0 -NoImplicitAdd +Configures charset translation behavior +CharsetOptions option [option] ... +CharsetOptions DebugLevel=0 NoImplicitAdd server config virtual hostdirectory .htaccess @@ -142,11 +147,11 @@

The CharsetOptions directive configures certain - behaviors of mod_charset_lite. Option can + behaviors of mod_charset_lite. Option can be one of

-
DebugLevel=n
+
DebugLevel=n
The DebugLevel keyword allows you to specify the level of debug messages generated by @@ -158,15 +163,16 @@ DBGLVL_ constants near the beginning of mod_charset_lite.c.
-
ImplicitAdd | NoImplicitAdd
+
ImplicitAdd | NoImplicitAdd
The ImplicitAdd keyword specifies that mod_charset_lite should implicitly insert its filter when the configuration specifies that the character set of content should be translated. If the filter chain is - explicitly configured using the AddOutputFilter directive, - NoImplicitAdd should be specified so that - mod_charset_lite doesn't add its filter.
+ explicitly configured using the AddOutputFilter directive, NoImplicitAdd + should be specified so that mod_charset_lite + doesn't add its filter.
1.30 +3 -4 httpd-2.0/docs/manual/mod/quickreference.html.en Index: quickreference.html.en =================================================================== RCS file: /home/cvs/httpd-2.0/docs/manual/mod/quickreference.html.en,v retrieving revision 1.29 retrieving revision 1.30 diff -u -r1.29 -r1.30 --- quickreference.html.en 7 Nov 2002 03:34:36 -0000 1.29 +++ quickreference.html.en 7 Nov 2002 04:35:56 -0000 1.30 @@ -186,10 +186,9 @@ cached by proxy servers
CGIMapExtension cgi-path .extensiondhC
Technique for locating the interpreter for CGI scripts
CharsetDefault charsetsvdhX
Charset to translate into
CharsetOptions option [option] ... DebugLevel=0 -NoImp +svdhX
Configures charset tranlation behavior
CharsetSourceEnc charsetsvdhX
Source charset of files
CharsetDefault charsetsvdhX
Charset to translate into
CharsetOptions option [option] ... DebugLevel=0 NoImpl +svdhX
Configures charset translation behavior
CharsetSourceEnc charsetsvdhX
Source charset of files
CheckSpelling on|off Off svdhE
Enables the spelling module
ChildPerUserID user_id