Mailman 3 March 2020 - docs

[issue40122] The implementation and documentation of "dis.findlables" don't match
by Serhiy Storchaka 31 Mar '20

31 Mar '20

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: dis.findlabels() always worked with a byte code. And the docstring correctly describes this. I think this is a documentation issue. The documentation fix should be backported to all maintained Python versions. If you want to make dis.findlabels() accepting a code object, it would be a new feature and it may be only added in future Python release (3.9). It needs a separate issue. In any case the documentation bug should be fixed in maintained versions. ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python stage: -> needs patch type: -> behavior versions: +Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40122> _______________________________________

1 0

[issue37390] Generate table of audit events for docs
by Steve Dower 31 Mar '20

31 Mar '20

New submission from Steve Dower <steve.dower(a)python.org>: All audit events are marked in the docs with the ".. audit-event:: <name> <args>" syntax. We should automatically collate these into a single table and generate a new doc page as part of docs build. ---------- assignee: docs@python components: Documentation messages: 346417 nosy: christian.heimes, docs@python, steve.dower priority: normal severity: normal stage: needs patch status: open title: Generate table of audit events for docs type: enhancement versions: Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue37390> _______________________________________

3 17

[issue40046] Increase test coverage of the random module
by Serhiy Storchaka 31 Mar '20

31 Mar '20

New submission from Serhiy Storchaka <storchaka+cpython(a)gmail.com>: The propose test adds several tests for random module. Mainly tests for integer, sequence and iterable arguments. It also documents that randrange() accepts non-integers. ---------- assignee: docs@python components: Documentation, Tests messages: 364840 nosy: docs@python, mark.dickinson, rhettinger, serhiy.storchaka, tim.peters priority: normal severity: normal status: open title: Increase test coverage of the random module type: enhancement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40046> _______________________________________

3 6

[issue40090] The referenced RFC for the json module should be corrected to rfc8259
by Ama Aje My Fren 29 Mar '20

29 Mar '20

New submission from Ama Aje My Fren <amaajemyfren(a)gmail.com>: Currently the Documentation of the json library module refers to :rfc:`7159` . That RFC has however been obsoleted by :rfc:`8259`. The Documentation for :mod:`json` should be changed to indicate this. ---------- assignee: docs@python components: Documentation messages: 365162 nosy: amaajemyfren, docs@python priority: normal severity: normal status: open title: The referenced RFC for the json module should be corrected to rfc8259 type: enhancement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40090> _______________________________________

2 3

Possible error in description of NaN comparisons
by John Doe 28 Mar '20

28 Mar '20

The section at https://github.com/python/cpython/blob/master/Doc/reference/expressions.rst… contains the following text: """ The not-a-number values float('NaN') and decimal.Decimal('NaN') are special. Any ordered comparison of a number to a not-a-number value is false. A counter-intuitive implication is that not-a-number values are not equal to themselves. For example, if x = float('NaN'), 3 < x, x < 3, x == x, x != x are all false. This behavior is compliant with IEEE 754. """ There seems to be a problem with the last (x != x) comparison, namely: the current v3.8.2 of CPython returns True instead. In fact, some googling shows that the behavior of CPython is consistent with the standard convention, which suggests that the fault is in the documentation.

1 0

Error in documentation
by Igor Fomenko 27 Mar '20

27 Mar '20

Hi this article https://docs.python.org/3.7/library/decimal.html?highlight=multiply#decimal… contain wrong information about divmod(*x*, *y*) this function returns two values -- Best regards Igor Fomenko

1 0

[issue40053] Document the behavior that no interplotation is applied when no *args are passed in for logging statements
by Eric V. Smith 27 Mar '20

27 Mar '20

Eric V. Smith <eric(a)trueblade.com> added the comment: Thanks for the bug report! I'll mark it "fixed". If there's more to do, let us know. ---------- resolution: -> fixed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40053> _______________________________________

1 0

[issue40053] Document the behavior that no interplotation is applied when no *args are passed in for logging statements
by Nan Hua 27 Mar '20

27 Mar '20

Nan Hua <nanhua2013(a)gmail.com> added the comment: Note that this issue has already been mostly addressed by https://github.com/python/cpython/pull/19132. I think we can close this issue now. Thanks Eric, Gregory and Vinay! ---------- stage: needs patch -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40053> _______________________________________

1 0

[issue19698] Implement _imp.exec_builtin and exec_dynamic
by Brett Cannon 27 Mar '20

27 Mar '20

Brett Cannon <brett(a)python.org> added the comment: New changeset 2929bfb973da249ed4f056c88a69bcc48e5a4843 by Miss Islington (bot) in branch '3.7': bpo-19698: Document when importlib.machinery.FrozenImporter gained spec-related methods (GH-19158) (GH-19165) https://github.com/python/cpython/commit/2929bfb973da249ed4f056c88a69bcc48e… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue19698> _______________________________________

1 0

[issue19698] Implement _imp.exec_builtin and exec_dynamic
by Brett Cannon 27 Mar '20

27 Mar '20

Brett Cannon <brett(a)python.org> added the comment: New changeset 8dad09a2242194a4101374b91ce87bb47a487cf7 by Miss Islington (bot) in branch '3.8': bpo-19698: Document when importlib.machinery.FrozenImporter gained spec-related methods (GH-19158) (#19164) https://github.com/python/cpython/commit/8dad09a2242194a4101374b91ce87bb47a… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue19698> _______________________________________

1 0