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