slive 00/11/28 18:45:21
Modified: htdocs/manual/mod mod_charset_lite.html
Log:
Bring mod_charset_lite up to the "modern" format.
Revision Changes Path
1.4 +63 -56 httpd-docs-2.0/htdocs/manual/mod/mod_charset_lite.html
Index: mod_charset_lite.html
===================================================================
RCS file: /home/cvs/httpd-docs-2.0/htdocs/manual/mod/mod_charset_lite.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -b -u -r1.3 -r1.4
--- mod_charset_lite.html 2000/09/26 19:38:35 1.3
+++ mod_charset_lite.html 2000/11/29 02:45:21 1.4
@@ -14,18 +14,24 @@
<!--#include virtual="header.html" -->
<H1 ALIGN="CENTER">Module mod_charset_lite</H1>
- <P>
- This module is contained in the <CODE>mod_charset_lite.c</CODE> file, with
- Apache 2.0 and later. It provides the ability to specify character set
- translation, or recoding, by directory or location or virtual server. It
- is not compiled into the server by default. <CODE>mod_charset_lite</CODE>
- requires that Apache is compiled with APACHE_XLATE defined.
- </P>
+<p>This module provides the ability to specify character set
+ translation or recoding.</p>
- <P>
- This module provides a small subset of configuration mechanisms
- implemented by Russian Apache and its associated <CODE>mod_charset</CODE>.
- </P>
+<P><A
+HREF="module-dict.html#Status"
+REL="Help"
+><STRONG>Status:</STRONG></A> Experimental
+<BR>
+<A
+HREF="module-dict.html#SourceFile"
+REL="Help"
+><STRONG>Source File:</STRONG></A> mod_charset_lite.c
+<BR>
+<A
+HREF="module-dict.html#ModuleIdentifier"
+REL="Help"
+><STRONG>Module Identifier:</STRONG></A> charset_lite_module
+</P>
<H2>Summary</H2>
<P>
@@ -48,6 +54,14 @@
is needed in order for any translation to take place.
</P>
+ <p>This module will only work if <code>APACHE_XLATE</code> is defined
+ at compile time.</p>
+
+ <P>
+ This module provides a small subset of configuration mechanisms
+ implemented by Russian Apache and its associated <CODE>mod_charset</CODE>.
+ </P>
+
<H2>Directives</H2>
<UL>
<LI><A HREF="#charsetsourceenc">CharsetSourceEnc</A>
@@ -56,6 +70,39 @@
</LI>
</UL>
+ <H2>Common Problems</H2>
+
+ <H3>Invalid character set names</H3>
+
+ <P>
+ 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:
+ </P>
+
+ <PRE>
+ iconv -f charsetsourceenc-value -t charsetdefault-value
+ </PRE>
+
+ <H3>Mismatch between character set of content and translation rules</H3>
+
+ <P>
+ If the translation rules don't make sense for the content, translation
+ can fail in various ways, including:
+ </P>
+
+ <SL>
+ <LI>
+ The translation mechanism may return a bad return code, and the connection
+ will be aborted.
+ <LI>
+ The translation mechanism may silently place special characters (e.g.,
question
+ marks) in the output buffer when it cannot translate the input buffer.
+ </SL>
+
<HR>
<H2><A NAME="charsetsourceenc">CharsetSourceEnc</A></H2>
@@ -90,10 +137,6 @@
REL="Help"
><STRONG>Module:</STRONG></A> mod_charset_lite
<BR>
- <A
- HREF="directive-dict.html#Compatibility"
- REL="Help"
- ><STRONG>Compatibility:</STRONG></A> Only available in Apache 2.0 or later
<P>
The <CODE>CharsetSourceEnc</CODE> directive specifies the source charset
@@ -119,6 +162,8 @@
translation support in Solaris 8.
<P>
+<hr>
+
<H2><A NAME="charsetdefault">CharsetDefault</A></H2>
<P>
<A
@@ -151,10 +196,6 @@
REL="Help"
><STRONG>Module:</STRONG></A> mod_charset_lite
<BR>
- <A
- HREF="directive-dict.html#Compatibility"
- REL="Help"
- ><STRONG>Compatibility:</STRONG></A> Only available in Apache 2.0 or later
<P>
The <CODE>CharsetDefault</CODE> directive specifies the charset that
@@ -178,6 +219,8 @@
<P>
+<hr>
+
<H2><A NAME="charsetoptions">CharsetOptions</A></H2>
<P>
<A
@@ -210,10 +253,6 @@
REL="Help"
><STRONG>Module:</STRONG></A> mod_charset_lite
<BR>
- <A
- HREF="directive-dict.html#Compatibility"
- REL="Help"
- ><STRONG>Compatibility:</STRONG></A> Only available in Apache 2.0 or later
<P>
The <CODE>CharsetOptions</CODE> directive configures certain behaviors
@@ -239,38 +278,6 @@
</DL>
</P>
- <H2>Common Problems</H2>
-
- <H3>Invalid character set names</H3>
-
- <P>
- 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:
- </P>
-
- <PRE>
- iconv -f charsetsourceenc-value -t charsetdefault-value
- </PRE>
-
- <H3>Mismatch between character set of content and translation rules</H3>
-
- <P>
- If the translation rules don't make sense for the content, translation
- can fail in various ways, including:
- </P>
-
- <SL>
- <LI>
- The translation mechanism may return a bad return code, and the connection
- will be aborted.
- <LI>
- The translation mechanism may silently place special characters (e.g.,
question
- marks) in the output buffer when it cannot translate the input buffer.
- </SL>
<!--#include virtual="footer.html" -->
</BODY>
