Mailman 3 September 2013 - docs

[Python Documentation Bug] __next__() method or next() method for Iterator class
by vishal yadav 12 Sep '13

12 Sep '13

Dear python.org documentation team, The method that should be defined under Iterator Class should be __next__() or next(). Problem: In case __next__() method is defined python under user defined Iterator class, interpreter gives following error: *TypeError: instance has no next() method* Resolution: The problem is resolved when __next__() is renamed to next(). PS: My version of python Python 2.7.3 Regards, Vishal

1 2

[issue18911] minidom does not encode correctly when calling Document.writexml
by Serhiy Storchaka 12 Sep '13

12 Sep '13

Changes by Serhiy Storchaka <storchaka(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18911> _______________________________________

1 0

[issue11163] iter() documentation code doesn't work
by Michael Grazebrook 12 Sep '13

12 Sep '13

New submission from Michael Grazebrook <michael(a)grazebrook.com>: This code fragment from the documentation of iter() doesn't work as intended. Change "STOP" to "STOP\n". Maybe also check for EOF as it hangs. with open("mydata.txt") as fp: for line in iter(fp.readline, "STOP"): process_line(line) Or maybe this makes a better example because it's clearer wha'ts going on: square_generator = (i * i for i in range(100000)) for n in iter( square_generator.next, 144): print n ---------- assignee: docs@python components: Documentation messages: 128238 nosy: docs@python, mgrazebrook priority: normal severity: normal status: open title: iter() documentation code doesn't work type: behavior versions: Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11163> _______________________________________

6 10

[issue10977] Concrete object C API considered harmful to subclasses of builtin types
by Arfrever Frehtes Taifersar Arahesis 11 Sep '13

11 Sep '13

Changes by Arfrever Frehtes Taifersar Arahesis <Arfrever.FTA(a)GMail.Com>: ---------- nosy: +Arfrever _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10977> _______________________________________

1 0

[issue18815] DOCUMENTATION: "mmap .close()" doesn't close the underlying file
by Jesús Cea Avión 10 Sep '13

10 Sep '13

New submission from Jesús Cea Avión: In documentation http://docs.python.org/3.3/library/mmap.html#mmap.close you can read: "Close the file". I could interpret that it is going to close the file vinculated to the MMAP. But it doesn't. It only close the MMAP object (as it should). Please, update doc to clear possible misunderstandings. Thanks. ---------- assignee: docs@python keywords: easy messages: 195939 nosy: docs@python, jcea priority: normal severity: normal status: open title: DOCUMENTATION: "mmap .close()" doesn't close the underlying file _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18815> _______________________________________

4 3

[issue18800] Document Fraction's numerator and denominator properties
by icedream91 10 Sep '13

10 Sep '13

New submission from icedream91: The document (http://docs.python.org/3/library/fractions.html) doesn't mention Fraction's numerator and denominator properties, I knew these properties from dir(). Since sometimes these two properties are very useful, for example: http://projecteuler.net/problem=33 and http://projecteuler.net/problem=57 , I think document should mention them. Thanks. ---------- assignee: docs@python components: Documentation messages: 195808 nosy: docs@python, icedream91 priority: normal severity: normal status: open title: Document Fraction's numerator and denominator properties type: enhancement versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18800> _______________________________________

7 8

[issue18313] In itertools recipes repeatfunc() defines a non-keyword argument as keyword
by py.user 09 Sep '13

09 Sep '13

New submission from py.user: http://docs.python.org/3/library/itertools.html#itertools-recipes "def repeatfunc(func, times=None, *args):" >>> repeatfunc(lambda x: x, times=None, 1) File "<stdin>", line 1 SyntaxError: non-keyword arg after keyword arg >>> >>> repeatfunc(lambda x: x, 1, times=None) Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: repeatfunc() got multiple values for argument 'times' >>> ---------- assignee: docs@python components: Documentation messages: 191930 nosy: docs@python, py.user priority: normal severity: normal status: open title: In itertools recipes repeatfunc() defines a non-keyword argument as keyword type: enhancement versions: Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18313> _______________________________________

5 10

[issue18301] In itertools.chain.from_iterable() there is no cls argument
by py.user 09 Sep '13

09 Sep '13

New submission from py.user: http://docs.python.org/2/library/itertools.html#itertools.chain.from_iterab… >>> class A: ... @classmethod ... def from_iterable(iterables): ... for it in iterables: ... for element in it: ... yield element ... >>> A.from_iterable(['ABC', 'DEF']) Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: from_iterable() takes 1 positional argument but 2 were given >>> ---------- assignee: docs@python components: Documentation files: issue.diff keywords: patch messages: 191874 nosy: docs@python, py.user priority: normal severity: normal status: open title: In itertools.chain.from_iterable() there is no cls argument type: enhancement versions: Python 3.3, Python 3.4 Added file: http://bugs.python.org/file30702/issue.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18301> _______________________________________

7 12

[issue18980] Docs: enum - ReST format
by Elazar Gershuni 09 Sep '13

09 Sep '13

New submission from Elazar Gershuni: in http://docs.python.org/3.4/library/enum.html : "..note: Nomenclature" and ".:meth:__format__" visible in the html. ---------- assignee: docs@python components: Documentation files: enum_minor.patch keywords: patch messages: 197312 nosy: docs@python, elazar priority: normal severity: normal status: open title: Docs: enum - ReST format versions: Python 3.4 Added file: http://bugs.python.org/file31682/enum_minor.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18980> _______________________________________

3 2

[issue18953] Typo in NEWS about fixed format specifiers for Py_ssize_t in debugging output in the _sre module
by Vajrasky Kok 08 Sep '13

08 Sep '13

New submission from Vajrasky Kok: File Misc/NEWS, line 65 & 66: - Issue #18672: Fixed format specifiers for Py_ssize_t in debugging output in the _sre moduel. "moduel" => "module" Related commit: http://hg.python.org/cpython/rev/c41c68a18bb6 ---------- assignee: docs@python components: Documentation messages: 197134 nosy: docs@python, serhiy.storchaka, vajrasky priority: normal severity: normal status: open title: Typo in NEWS about fixed format specifiers for Py_ssize_t in debugging output in the _sre module versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18953> _______________________________________

3 2