Index: /home/oleg/src/apache.org/jakarta-commons/httpclient-trunk/src/java/org/apache/commons/httpclient/cookie/CookiePolicy.java
===================================================================
--- /home/oleg/src/apache.org/jakarta-commons/httpclient-trunk/src/java/org/apache/commons/httpclient/cookie/CookiePolicy.java (revision 354827)
+++ /home/oleg/src/apache.org/jakarta-commons/httpclient-trunk/src/java/org/apache/commons/httpclient/cookie/CookiePolicy.java (working copy)
@@ -47,6 +47,7 @@
* management practices (even if they are not 100% standards compliant)
*
NETSCAPE : Netscape cookie draft compliant
* RFC_2109 : RFC2109 compliant (default)
+ * IGNORE_COOKIES : do not automatically process cookies
*
*
* @author Oleg Kalnichevski
@@ -206,10 +207,10 @@
/**
* @return default cookie policy
- * (COMPATIBILITY | NETSCAPE_DRAFT | RFC2109)
*
- * @deprecated Use {@link CookiePolicy#getCookieSpec(String)}
- * @see #DEFAULT
+ * @deprecated Use {@link #getDefaultSpec()}
+ *
+ * @see #getDefaultSpec()
*/
public static int getDefaultPolicy() {
return defaultPolicy;
@@ -218,7 +219,6 @@
/**
* @param policy new default cookie policy
- * (COMPATIBILITY | NETSCAPE_DRAFT | RFC2109)
*
* @deprecated Use {@link CookiePolicy#registerCookieSpec(String, Class)}
* @see #DEFAULT
@@ -230,7 +230,6 @@
/**
* @param policy cookie policy to get the CookieSpec for
* @return cookie specification interface for the given policy
- * (COMPATIBILITY | NETSCAPE_DRAFT | RFC2109)
*
* @deprecated Use {@link CookiePolicy#getCookieSpec(String)}
*/
Index: /home/oleg/src/apache.org/jakarta-commons/httpclient-trunk/xdocs/cookies.xml
===================================================================
--- /home/oleg/src/apache.org/jakarta-commons/httpclient-trunk/xdocs/cookies.xml (revision 354827)
+++ /home/oleg/src/apache.org/jakarta-commons/httpclient-trunk/xdocs/cookies.xml (working copy)
@@ -54,6 +54,8 @@
RFC2109 is available at
http://www.w3.org/Protocols/rfc2109/rfc2109.txt
+
+ RFC2109 is the default cookie policy used by HttpClient.
@@ -123,6 +125,20 @@
-->
+
+ The cookie management API of HttpClient can co-exist with the manual
+ cookie handling. One can manually set request Cookie
+ headers or process response Set-Cookie headers in addition
+ or instead of the automatic cookie management
+
+
+
+
+
The most common problems encountered with parsing cookies is due to
non-compliant servers. In these cases, switching to the compatibility