]> granicus.if.org Git - python/commitdiff
issue2193 - Update docs about the legal characters allowed in Cookie name
authorSenthil Kumaran <senthil@uthcode.com>
Sun, 22 Apr 2012 02:31:52 +0000 (10:31 +0800)
committerSenthil Kumaran <senthil@uthcode.com>
Sun, 22 Apr 2012 02:31:52 +0000 (10:31 +0800)
Doc/library/http.cookies.rst

index 6baf28ec98f7af01675f1cdc092aab5cdf4650c4..646f2e88602bb7466f5d66e6d66c93c0b7614073 100644 (file)
@@ -17,8 +17,17 @@ cookie value.
 
 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::