Mailman 3 January 2014 - docs

Upgrade to Sphinx 1.2
by Hernan Grecco Jan. 13, 2014

Jan. 13, 2014

Hi, Not really an error but a suggestion. A year ago, I suggested improving the search results in the Python Documentation. I am not going through all the arguments again, you can see the thread here [0]. For this purpose, I contributed some patches to Sphinx which are included in Sphinx 1.2 (released last month). It will be great if you could upgrade the docs in docs.python.org to the new sphinx. It makes using the docs much easier, specially for newbies. See the comparison here [1] thanks for your hard work, cheers, Hernán [0] https://groups.google.com/forum/#!msg/python-ideas/Xxb4PiTWS3g/ft8w1UftYZ0J [1] http://hgrecco.github.io/searchpydocs/

1 1

Typo in upcoming python 3.4 documentation
by Lauri Hakko Jan. 13, 2014

Jan. 13, 2014

http://docs.python.org/3.4/whatsnew/3.4.html#http On this page on http paragraph, the new option is said to be "exaplain" although it should be "explain"

2 1

Print Command
by Camil Kassar Jan. 13, 2014

Jan. 13, 2014

IN Topic 2 and Topic 3, (maybe later topics) print commands are missing parenthesis, for example: >>> i = 256*256 >>> print 'The value of i is', i The value of i is 65536Should be>>> i = 256*256 >>> print ('The value of i is', i) The value of i is 65536

2 1

[issue20236] Invalid inline markup in xml document.
by INADA Naoki Jan. 13, 2014

Jan. 13, 2014

New submission from INADA Naoki: http://docs.python.org/3.3/library/xml.html#xml-vulnerabilities > DTD retrieval > Some XML libraries like Python’s mod:’xml.dom.pulldom’ retrieve document mod: should be :mod: ---------- assignee: docs@python components: Documentation messages: 208012 nosy: docs@python, naoki priority: normal severity: normal status: open title: Invalid inline markup in xml document. versions: Python 3.3, Python 3.4, Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20236> _______________________________________

3 2

[issue20135] FAQ need list mutation answers
by Terry J. Reedy Jan. 10, 2014

Jan. 10, 2014

Changes by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- stage: -> needs patch title: mutate list -> FAQ need list mutation answers _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20135> _______________________________________

1 0

[issue20200] Argument Clinic howto: custom self_converter example broken
by Roundup Robot Jan. 10, 2014

Jan. 10, 2014

Roundup Robot added the comment: New changeset 5a8301002f5a by Zachary Ware in branch 'default': Closes #20200: Argument Clinic custom converter example should be in a http://hg.python.org/cpython/rev/5a8301002f5a ---------- nosy: +python-dev resolution: -> fixed stage: patch review -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20200> _______________________________________

1 0

[issue20200] Argument Clinic howto: custom self_converter example broken
by Larry Hastings Jan. 10, 2014

Jan. 10, 2014

Larry Hastings added the comment: LGTM. Check it in please! ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20200> _______________________________________

1 0

[issue20200] Argument Clinic howto: custom self_converter example broken
by Zachary Ware Jan. 9, 2014

Jan. 9, 2014

Changes by Zachary Ware <zachary.ware(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, larry stage: -> patch review versions: +Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20200> _______________________________________

1 0

[issue20153] New-in-3.4 weakref finalizer doc section is already out of date.
by R. David Murray Jan. 8, 2014

Jan. 8, 2014

New submission from R. David Murray: The following discussion section in the weakref docs: http://docs.python.org/dev/library/weakref.html#comparing-finalizers-with-d… which was added in 3.4, is out of date because of the GC improvements. It should be tweaked to match the new reality. (I've already deleted the Note under __callback__.) ---------- assignee: docs@python components: Documentation messages: 207489 nosy: docs@python, pitrou, r.david.murray, sbt priority: normal severity: normal stage: needs patch status: open title: New-in-3.4 weakref finalizer doc section is already out of date. type: behavior versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20153> _______________________________________

2 1

[issue18011] Inconsistency between b32decode() documentation, docstring and code
by Serhiy Storchaka Jan. 8, 2014

Jan. 8, 2014

New submission from Serhiy Storchaka: b32decode() documentation says: "A TypeError is raised if s were incorrectly padded or if there are non-alphabet characters present in the string." b32decode() docstring says: "binascii.Error is raised if the input is incorrectly padded or if there are non-alphabet characters present in the input." Actually binascii.Error (which is a ValueError subtype) is raised if the input is incorrectly padded and TypeError is raised if there are non-alphabet characters present in the input. At least 2 of 3 (documentation, docstring and implementation) should be corrected. Base32 support was originally added in 3cc0d8fd4e2b (TypeError was used everywhere) and then modified in eb45f85c4c79 (TypeError was partially changed to binascii.Error). ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 189571 nosy: barry, docs@python, gvanrossum, serhiy.storchaka priority: normal severity: normal status: open title: Inconsistency between b32decode() documentation, docstring and code type: behavior versions: Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18011> _______________________________________

4 12