Mailman 3 January 2014 - docs

Upgrade to Sphinx 1.2
by Hernan Grecco 13 Jan '14

13 Jan '14

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 13 Jan '14

13 Jan '14

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 13 Jan '14

13 Jan '14

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 13 Jan '14

13 Jan '14

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 10 Jan '14

10 Jan '14

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 09 Jan '14

09 Jan '14

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 09 Jan '14

09 Jan '14

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 08 Jan '14

08 Jan '14

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 08 Jan '14

08 Jan '14

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 08 Jan '14

08 Jan '14

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