Mailman 3 March 2017 - docs

[issue19871] json module won't parse a float that starts with a decimal point
by Serhiy Storchaka 07 Mar '17

07 Mar '17

Changes by Serhiy Storchaka <storchaka+cpython(a)gmail.com>: ---------- status: open -> pending _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19871> _______________________________________

1 0

[issue29716] Python 3 Module doc still sounds like __init__.py is required
by James O 06 Mar '17

06 Mar '17

New submission from James O: PEP 420 says "Allowing implicit namespace packages means that the requirement to provide an __init__.py file can be dropped completely..." (as described here: http://stackoverflow.com/questions/37139786/is-init-py-not-required-for-pac…) The documentation for modules <https://docs.python.org/3/tutorial/modules.html> doesn't seem to reflect this change. My "enhancement suggestion" is that a sentence (and perhaps an example) be added that explicitly states or shows an import from another directory. (P.S. This is my first Python bug submission, so if it's silly, let me know. Thanks!) ---------- assignee: docs@python components: Documentation messages: 288932 nosy: James O, docs@python priority: normal severity: normal status: open title: Python 3 Module doc still sounds like __init__.py is required type: enhancement versions: Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________

4 4

[issue29724] Itertools docs propose a harmful “speedup” without any explanation
by Chris Warrick 05 Mar '17

05 Mar '17

New submission from Chris Warrick: The itertools recipes list [0] ends with the following dubious advice: > Note, many of the above recipes can be optimized by replacing global lookups with local variables defined as default values. For example, the dotproduct recipe can be written as: > > def dotproduct(vec1, vec2, sum=sum, map=map, mul=operator.mul): > return sum(map(mul, vec1, vec2)) This is presented in the document without any explanation. It may confuse beginners into always doing it in their code (as evidenced in #python today), leading to unreadable code and function signatures. There is also no proof of there being a significant speed difference by using this “trick”. In my opinion, this should not be part of the documentation, or should provide proof that it can provide a real, noticeable speedup and is not premature optimization. (Added in [1] by Raymond Hettinger — added to nosy list) [0]: https://docs.python.org/3/library/itertools.html#itertools-recipes [1]: https://github.com/python/cpython/commit/fc91aa28fd8dad5280fd4d3a4747b5e08e… ---------- assignee: docs@python components: Documentation messages: 289020 nosy: Kwpolska, docs@python, rhettinger priority: normal severity: normal status: open title: Itertools docs propose a harmful “speedup” without any explanation versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29724> _______________________________________

7 10

ePub version does ont exist
by Nicolas Bergeaud 05 Mar '17

05 Mar '17

ePub version does ont exist

1 0

[issue29716] Python 3 Module doc still sounds like __init__.py is required
by INADA Naoki 04 Mar '17

04 Mar '17

INADA Naoki added the comment: namespace package is very advanced topic. I don't think tutorial should mention it. Putting __init__.py always in normal package is highly recommended. Otherwise, many tools can't distinguish normal directory and python package. 2017/03/04 午前6:26 "James O" <report(a)bugs.python.org>: New submission from James O: PEP 420 says "Allowing implicit namespace packages means that the requirement to provide an __init__.py file can be dropped completely..." (as described here: http://stackoverflow.com/questions/37139786/is-init-py- not-required-for-packages-in-python-3) The documentation for modules <https://docs.python.org/3/ tutorial/modules.html> doesn't seem to reflect this change. My "enhancement suggestion" is that a sentence (and perhaps an example) be added that explicitly states or shows an import from another directory. (P.S. This is my first Python bug submission, so if it's silly, let me know. Thanks!) ---------- assignee: docs@python components: Documentation messages: 288932 nosy: James O, docs@python priority: normal severity: normal status: open title: Python 3 Module doc still sounds like __init__.py is required type: enhancement versions: Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________ _______________________________________________ docs mailing list docs(a)python.org https://mail.python.org/mailman/listinfo/docs ---------- nosy: +inada.naoki _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________

1 0

Re: [docs] 9. Classes << The Python Tutorial
by Andrine Duus 03 Mar '17

03 Mar '17

Suddenly, some "I" is writing the tutorial. But, "we" don't care. That's only somewhat excusable in texts or papers written by one individual. Certainly, it wouldn't be excusable in documentation at the gateway of a massive community. And other things like statements "A *namespace* is a mapping from names to objects" should be looked into as well in a proofing. Most people learning to program for the first time may come to a language like Python, and they wouldn't have learned formal definitions of mathematical functions to make sense of such phrasings. A writer signaling their "higher knowledge" to a fraction of the audience doesn't serve pedagogical purposes.

1 0

[issue16355] inspect.getcomments() does not work in the interactive shell
by R. David Murray 03 Mar '17

03 Mar '17

R. David Murray added the comment: Correct. Tests are good, it's the fix I was rejecting. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16355> _______________________________________

1 0

[issue16355] inspect.getcomments() does not work in the interactive shell
by Berker Peksag 03 Mar '17

03 Mar '17

Berker Peksag added the comment: I think David's comment about tests was for the second patch. Looking at msg199395 and msg199397, my understanding is that tests are still needed. ---------- nosy: +berker.peksag versions: +Python 3.5, Python 3.6, Python 3.7 -Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16355> _______________________________________

1 0

[issue16355] inspect.getcomments() does not work in the interactive shell
by Marco Buttu 03 Mar '17

03 Mar '17

Changes by Marco Buttu <marco.buttu(a)gmail.com>: ---------- pull_requests: +356 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16355> _______________________________________

1 0

[issue29677] clarify docs about 'round()' accepting a negative integer for ndigits
by Brett Cannon 02 Mar '17

02 Mar '17

Changes by Brett Cannon <brett(a)python.org>: ---------- title: 'round()' accepts a negative integer for ndigits -> clarify docs about 'round()' accepting a negative integer for ndigits _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29677> _______________________________________

1 0