[issue11001] Various obvious errors in cookies documentation

[Gregory P. Smith]

Gregory P. Smith  added the comment:

Thanks Julia!

--
nosy: +gregory.p.smith
resolution:  -> fixed
stage: patch review -> commit review
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[miss-islington]

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/1fe722cf14db0f786d6df1ff4392f44d37a9f867


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[miss-islington]

Change by miss-islington :


--
pull_requests: +13080

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[miss-islington]

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/91cc01f40eec03ece2d6b04ad9ea786e77707d8d


--
nosy: +miss-islington

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[Gregory P. Smith]

Change by Gregory P. Smith :


--
versions: +Python 3.7, Python 3.8 -Python 3.2, Python 3.3

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[Roundup Robot]

Change by Roundup Robot :


--
pull_requests: +13000

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[Julia]

Julia  added the comment:

Working on it at the moment

--
nosy: +jiliuk

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[Mark Lawrence]

Change by Mark Lawrence :


--
nosy:  -BreamoreBoy

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[Mark Lawrence]

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 rep...@bugs.python.org
http://bugs.python.org/issue11001
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[R. David Murray]

R. David Murray added the comment:

My suggestion was that the help text from the doc strings be used to update the 
ReST documentation.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue11001
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[Ezio Melotti]

Changes by Ezio Melotti ezio.melo...@gmail.com:


--
keywords: +easy
nosy: +petri.lehtinen
stage:  - patch review
versions: +Python 3.3 -Python 3.1

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue11001
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[Luke Plant]

New submission from Luke Plant l.plant...@cantab.net:

Docs for SimpleCookie, BaseCookie.value_encode and BaseCookie.value_decode are 
obviously incorrect.  Attempt at patch attached.

The error has existed in every Python version I've seen, I've tagged the ones I 
believe can receive fixes, sorry if I've made a mistake.

Thanks.

--
assignee: docs@python
components: Documentation
files: http_cookies_doc_corrections.diff
keywords: patch
messages: 126962
nosy: docs@python, spookylukey
priority: normal
severity: normal
status: open
title: Various obvious errors in cookies documentation
versions: Python 2.7, Python 3.1, Python 3.2
Added file: http://bugs.python.org/file20507/http_cookies_doc_corrections.diff

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue11001
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue11001] Various obvious errors in cookies documentation

[R. David Murray]

R. David Murray rdmur...@bitdance.com 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 rep...@bugs.python.org
http://bugs.python.org/issue11001
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com