oglueck 2003/07/21 06:07:35
Modified: httpclient/xdocs Tag: HTTPCLIENT_2_0_BRANCH cookies.xml
charencodings.xml
Log:
added documentation about cookies and encoding
Revision Changes Path
No revision
No revision
1.2.2.1 +13 -1 jakarta-commons/httpclient/xdocs/cookies.xml
Index: cookies.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/cookies.xml,v
retrieving revision 1.2
retrieving revision 1.2.2.1
diff -u -r1.2 -r1.2.2.1
--- cookies.xml 3 Jun 2003 21:26:35 -0000 1.2
+++ cookies.xml 21 Jul 2003 13:07:33 -0000 1.2.2.1
@@ -131,5 +131,17 @@
non-compliant servers. In these cases, switching to the compatibility
cookie specification usually solves the problem.</p>
</section>
+
+ <section name="Encoding Issues">
+ <p>Since cookies are transfered as HTTP Headers they are confined to
+ the <tt>US-ASCII</tt> character set. Other characters will be lost or
+ mangeled. Cookies are typically set and read by the same server, so
+ a custom scheme for escaping non-ASCII characters can be used, for
+ instance the well-established URL encoding scheme. If cookies are
+ used to transfer data between server and client both parties must
+ agree on the escaping scheme used in a custom way. The HttpClient
+ cookie implementation provides no special means to handle non-ASCII
+ characters nor does it issue warnings.</p>
+ </section>
</body>
</document>
1.2.2.1 +5 -2 jakarta-commons/httpclient/xdocs/charencodings.xml
Index: charencodings.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/charencodings.xml,v
retrieving revision 1.2
retrieving revision 1.2.2.1
diff -u -r1.2 -r1.2.2.1
--- charencodings.xml 11 Mar 2003 08:03:12 -0000 1.2
+++ charencodings.xml 21 Jul 2003 13:07:34 -0000 1.2.2.1
@@ -25,7 +25,10 @@
It is not possible to use non <tt>US-ASCII</tt> characters in the header of
a
request or response. Generally this is not an issue however, because the
HTTP headers are designed to facilite the transfer of data rather than to
- actually transfer the data itself.
+ actually transfer the data itself.</p>
+ <p>One exception however are cookies. Since cookies are transfered as HTTP
Headers
+ they are confined to the <tt>US-ASCII</tt> character set. See the Cookie
Guide
+ for more information.
</p>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
