Mailman 3 August 2018 - docs

[issue34452] docs: help text for [>>>] toggle always in English
by Jonathan Fine 21 Aug '18

21 Aug '18

New submission from Jonathan Fine <jfine2358(a)gmail.com>: As subject. Background information in #34451. See https://docs.python.org/fr/3/tutorial/introduction.html The hover help text for the [>>>] is in English, not French. Korean and Japanese documentation has the same problem. ---------- assignee: docs@python components: Documentation messages: 323840 nosy: docs@python, jfine2358 priority: normal severity: normal status: open title: docs: help text for [>>>] toggle always in English type: behavior versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34452> _______________________________________

2 3

[issue34434] Removal of kwargs for built-in types not covered with "changed in Python" note in documentation
by Louis Sautier 21 Aug '18

21 Aug '18

Change by Louis Sautier <sautier.louis(a)gmail.com>: ---------- keywords: +patch pull_requests: +8320 stage: -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34434> _______________________________________

1 0

[issue34434] Removal of kwargs for built-in types not covered with "changed in Python" note in documentation
by Brett Cannon 20 Aug '18

20 Aug '18

Brett Cannon <brett(a)python.org> added the comment: Any interest in submitting a pull request to update the documentation? ---------- assignee: -> docs@python components: +Documentation nosy: +brett.cannon, docs@python title: Removal of kwargs for int() etc not described as change -> Removal of kwargs for built-in types not covered with "changed in Python" note in documentation _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34434> _______________________________________

1 0

[issue18925] select.poll.modify is not documented
by Giampaolo Rodola' 19 Aug '18

19 Aug '18

New submission from Giampaolo Rodola': It was introduced in Python 2.6: http://bugs.python.org/issue1657 Will commit a patch soon. ---------- assignee: docs@python components: Documentation messages: 196953 nosy: docs@python, giampaolo.rodola priority: normal severity: normal status: open title: select.poll.modify is not documented versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18925> _______________________________________

4 3

[issue27088] doc: select: epoll.poll: incorrect timeout units, missing maxevents
by Steve Ford 19 Aug '18

19 Aug '18

New submission from Steve Ford: The short description of epoll.poll is correct (gives timeout unit as seconds [float]; includes maxevents). However, the long description lists the timeout units as milliseconds ("If timeout is given, it specifies the length of time in milliseconds which the system will wait for events before returning."), and does not include maxevents at all. See https://docs.python.org/3.5/library/select.html#select.poll.poll See also https://docs.python.org/2.7/library/select.html#select.poll.poll ---------- assignee: docs@python components: Documentation messages: 266118 nosy: docs@python, fordsfords priority: normal severity: normal status: open title: doc: select: epoll.poll: incorrect timeout units, missing maxevents versions: Python 2.7, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27088> _______________________________________

2 1

[issue22057] The doc say all globals are copied on eval(), but only __builtins__ is copied
by Alon Mishne 19 Aug '18

19 Aug '18

New submission from Alon Mishne: According to the documentation of eval(): > If the globals dictionary is present and lacks '__builtins__', the current globals are copied into globals before expression is parsed. However in practice only the __builtins__ items are copied, see: http://hg.python.org/cpython/file/2.7/Python/bltinmodule.c#l655 See http://stackoverflow.com/q/24934908/242762 ---------- assignee: docs@python components: Documentation messages: 223837 nosy: amishne, docs@python priority: normal severity: normal status: open title: The doc say all globals are copied on eval(), but only __builtins__ is copied versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue22057> _______________________________________

6 14

[issue26363] __builtins__ propagation is misleading described in exec and eval documentation
by Xavier Combelle 19 Aug '18

19 Aug '18

New submission from Xavier Combelle: According to my experiment in code, the current behavior of python3.5 is different that the document says. If I understand well the purpose of this behavior is to propagate the __builtins__ global constant if globals has not one. In https://docs.python.org/3.6/library/functions.html#eval it is written "If the globals dictionary is present and lacks ‘__builtins__’, the current globals are copied into globals before expression is parsed." only the __builtins__ looks copied not all the globals In https://docs.python.org/3.6/library/functions.html#exec It is written: "If the globals dictionary does not contain a value for the key __builtins__, a reference to the dictionary of the built-in module builtins is inserted under that key." it looks like it is not a reference to the built-in module builtin, but a reference to __builtin__ global ---------- title: builtins propagation is misleading described in exec and eval documentation -> __builtins__ propagation is misleading described in exec and eval documentation versions: +Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26363> _______________________________________

6 10

[issue34432] doc Mention complex and decimal.Decimal on str.format note about locales
by Andrés Delfino 18 Aug '18

18 Aug '18

New submission from Andrés Delfino <adelfino(a)gmail.com>: On str.format method, the note about how locales are dealt with reads: "When formatting a number (int, float, float and subclasses)..." PR removes the second float, and mentions complex and decimal.Decimal. The bug which introduced this note is: #31900 ---------- assignee: docs@python components: Documentation messages: 323718 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc Mention complex and decimal.Decimal on str.format note about locales type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34432> _______________________________________

3 8

[issue34413] Porting section of 3.5 "What's New" doc does not mention bytecode changes.
by Eric Snow 17 Aug '18

17 Aug '18

New submission from Eric Snow <ericsnowcurrently(a)gmail.com>: In the 3.5 "What's New" doc, the porting section [1] does not mention the bytecode changes resulting from the PEP 448 implementation. [2][3] It should. I've marked this issue for the versions past 3.5 because each branch has its own "What's New" doc for 3.5. [1] https://docs.python.org/3/whatsnew/3.5.html#porting-to-python-3-5 [2] bpo-33216 [3] https://github.com/python/cpython/pull/8783#discussion_r210642202 ---------- assignee: docs@python components: Documentation messages: 323605 nosy: docs@python, eric.snow, serhiy.storchaka priority: low severity: normal stage: needs patch status: open title: Porting section of 3.5 "What's New" doc does not mention bytecode changes. type: enhancement versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34413> _______________________________________

2 2

[issue34418] Arguments missing from documentation for HTTPErrorProcessor.http(s)_response()
by Sebastian Rittau 17 Aug '18

17 Aug '18

New submission from Sebastian Rittau <srittau(a)rittau.biz>: The documentation at https://docs.python.org/3/library/urllib.request.html#urllib.request.HTTPEr… does not list the two arguments "request" and "response" that HTTPErrorProcessor.http_response() and https_response() actually require. (I checked the implementation in Python 3.5 and 3.7.) ---------- assignee: docs@python components: Documentation messages: 323638 nosy: docs@python, srittau priority: normal severity: normal status: open title: Arguments missing from documentation for HTTPErrorProcessor.http(s)_response() versions: Python 3.5, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34418> _______________________________________

3 7