[Python-checkins] cpython: issue2193 - Update docs about the legal characters allowed in Cookie name

[senthil.kumaran]

http://hg.python.org/cpython/rev/8cae3ee7f691
changeset:   76465:8cae3ee7f691
parent:      76462:0a63868c5e95
user:        Senthil Kumaran <senthil at uthcode.com>
date:        Sun Apr 22 10:31:52 2012 +0800
summary:
  issue2193 - Update docs about the legal characters allowed in Cookie name

files:
  Doc/library/http.cookies.rst |  13 +++++++++++--
  1 files changed, 11 insertions(+), 2 deletions(-)


diff --git a/Doc/library/http.cookies.rst b/Doc/library/http.cookies.rst
--- a/Doc/library/http.cookies.rst
+++ b/Doc/library/http.cookies.rst
@@ -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::
 

-- 
Repository URL: http://hg.python.org/cpython