R. David Murray added the comment: The text in the docstrings appears to be accurate, and it seems to me they clarify it even more than your suggested changes do. Also, I think SimpleCookie's encode/decode roughly implements some RFC or another (though there are some tweaks), and it might be worth mentioning that. Even with these changes, though, I don't think it is possible to really understand what cookie is doing without reading the source, and even then it is non-obvious :( ---------- nosy: +r.david.murray _______________________________________ Python tracker http://bugs.python.org/issue11001 _______________________________________

Mark Lawrence added the comment: Given the comments in msg126979 do we formally review this, close as "won't fix" or what? ---------- nosy: +BreamoreBoy _______________________________________ Python tracker http://bugs.python.org/issue11001 _______________________________________

Change by Mark Lawrence : ---------- nosy: -BreamoreBoy _______________________________________ Python tracker https://bugs.python.org/issue11001 _______________________________________

Change by Roundup Robot : ---------- pull_requests: +13000 _______________________________________ Python tracker https://bugs.python.org/issue11001 _______________________________________

miss-islington added the comment: New changeset 91cc01f40eec03ece2d6b04ad9ea786e77707d8d by Miss Islington (bot) (Julia Iliuk) in branch 'master': bpo-11001: updated cookie docs (GH-13086) https://github.com/python/cpython/commit/91cc01f40eec03ece2d6b04ad9ea786e777... ---------- nosy: +miss-islington _______________________________________ Python tracker https://bugs.python.org/issue11001 _______________________________________

miss-islington added the comment: New changeset 1fe722cf14db0f786d6df1ff4392f44d37a9f867 by Miss Islington (bot) in branch '3.7': [3.7] bpo-11001: updated cookie docs (GH-13086) (GH-13161) https://github.com/python/cpython/commit/1fe722cf14db0f786d6df1ff4392f44d37a... ---------- _______________________________________ Python tracker https://bugs.python.org/issue11001 _______________________________________