(original) (raw)

changeset: 76465:8cae3ee7f691 parent: 76462:0a63868c5e95 user: Senthil Kumaran senthil@uthcode.com date: Sun Apr 22 10:31:52 2012 +0800 files: Doc/library/http.cookies.rst description: issue2193 - Update docs about the legal characters allowed in Cookie name diff -r 0a63868c5e95 -r 8cae3ee7f691 Doc/library/http.cookies.rst --- a/Doc/library/http.cookies.rst Sat Apr 21 21:47:08 2012 -0400 +++ b/Doc/library/http.cookies.rst Sun Apr 22 10:31:52 2012 +0800 @@ -17,8 +17,17 @@ The module formerly strictly applied the parsing rules described in the :rfc:`2109` and :rfc:`2068` specifications. It has since been discovered that -MSIE 3.0x doesn't follow the character rules outlined in those specs. As a -result, the parsing rules used are a bit less strict. +MSIE 3.0x doesn't follow the character rules outlined in those specs and also +many current day browsers and servers have relaxed parsing rules when comes to +Cookie handling. As a result, the parsing rules used are a bit less strict. + +The character set, :data:`string.ascii_letters`, :data:`string.digits` and +``!#$%&'*+-.^_`|~:`` denote the set of valid characters allowed by this module +in Cookie name (as :attr:`~Morsel.key`). + +.. versionchanged:: 3.3 + Allowed ':' as a valid Cookie name character. + .. note:: /senthil@uthcode.com