Mailman 3 November 2019 - docs

[issue3530] ast.NodeTransformer doc bug
by Terry J. Reedy 17 Nov '19

17 Nov '19

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I re-verified the problem, its presence in the doc, and the fix with 3.9. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue3530> _______________________________________

1 0

[issue26011] Document necesities for cmp argument of sorted
by Karl Richter 16 Nov '19

16 Nov '19

New submission from Karl Richter: The docstring of `sorted` doesn't explain what can be passed to the `cmp` and `key` argument of `sorted`. ---------- assignee: docs@python components: Documentation messages: 257505 nosy: docs@python, krichter priority: normal severity: normal status: open title: Document necesities for cmp argument of sorted type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26011> _______________________________________

4 3

[issue38446] Ambiguous signature for builtins.__build_class__
by Batuhan 16 Nov '19

16 Nov '19

Batuhan <batuhanosmantaskaya(a)gmail.com> added the comment: This issue is fixed with PR 16735, @pablogsal can we close it? ---------- nosy: +BTaskaya, pablogsal _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38446> _______________________________________

1 0

[issue26103] Contradiction in definition of "data descriptor" between (dotted lookup behavior/datamodel documentation) and (inspect lib/descriptor how-to)
by miss-islington 16 Nov '19

16 Nov '19

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +16689 pull_request: https://github.com/python/cpython/pull/17180 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26103> _______________________________________

1 0

[issue38778] Document that os.fork is not allowed in subinterpreters
by Phil Connell 16 Nov '19

16 Nov '19

New submission from Phil Connell <pconnell(a)gmail.com>: Add a comment to the os.fork docs to note that forking from a subinterpreter is no longer allowed (see issue34651) ---------- assignee: docs@python components: Documentation messages: 356459 nosy: docs@python, eric.snow, pconnell priority: normal severity: normal status: open title: Document that os.fork is not allowed in subinterpreters versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38778> _______________________________________

4 6

duplicate sentence in datetime.datetime.fromisoformat docs
by laundmo 16 Nov '19

16 Nov '19

hey there the "Caution:" section for datetime.datetime.fromisoformat <https://docs.python.org/3/library/datetime.html#datetime.datetime.fromisofo…>includes the sentence " This does *not* support parsing arbitrary ISO 8601 strings - it is only intended as the inverse operation of datetime.isoformat()." twice, once at the start and once at the end. greetings, - laurin

1 0

[issue3530] ast.NodeTransformer doc bug
by Batuhan 16 Nov '19

16 Nov '19

Change by Batuhan <batuhanosmantaskaya(a)gmail.com>: ---------- keywords: +patch pull_requests: +16681 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/17172 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue3530> _______________________________________

1 0

[issue38351] Modernize email example from %-formatting to f-string
by Mariatta 15 Nov '19

15 Nov '19

New submission from Mariatta <mariatta(a)python.org>: A string was formatted with %s in the code example https://github.com/python/cpython/blob/b3e7045f8314e7b62cd95861d207fe2f97e4… ``` msg['Subject'] = 'The contents of %s' % textfile ``` It would be great to modernize that into fstring. Doc can be read at: https://docs.python.org/3.7/library/email.examples.html ---------- assignee: docs@python components: Documentation keywords: easy, newcomer friendly messages: 353749 nosy: Mariatta, docs@python priority: normal severity: normal stage: needs patch status: open title: Modernize email example from %-formatting to f-string versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38351> _______________________________________

12 24

[issue38809] On Windows, build scripts should prefer using python.exe from an active virtual env
by Tal Einat 15 Nov '19

15 Nov '19

New submission from Tal Einat <taleinat(a)gmail.com>: On windows several .bat scripts call find_python.bat to find an appropriate python.exe. find_python.bat has no specific support for virtual envs, and usually ends up calling py.exe to find python.exe. Due to virtual envs not including a py.exe, this effectively ignores having an activated virtual env. It is currently possible to build with the specific python that one wants by setting the PYTHON env var. However, this is a simplistic and non-standard solution compared to virtual envs. IMO when there is an active virtual env, these scripts should certainly use python.exe from it! ---------- assignee: docs@python components: Documentation messages: 356649 nosy: docs@python, taleinat priority: normal severity: normal status: open title: On Windows, build scripts should prefer using python.exe from an active virtual env type: enhancement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38809> _______________________________________

1 2

[issue38802] Clearer wording of os.WNOHANG documentation to avoid misinterpretation
by Michael Yagliyan 15 Nov '19

15 Nov '19

New submission from Michael Yagliyan <myagliyan1(a)bloomberg.net>: For versions 2.7 through 3.9 of https://docs.python.org/3/library/os.html, os.WNOHANG is described as returning (0, 0) when no child process status is immediately available. However, both os.wait3() and os.wait4() return 3-element tuples and are described as being similar to os.waitpid(). This, combined with the os.WNOHANG documentation being somewhat open to interpretation, makes it very easy to conclude (incorrectly) that wait3(WNOHANG) and wait4(WNOHANG) would return (0, 0) when no child process status is immediately available. In fact, they would return a 3-element tuple with the first 2 elements being 0. I suggest rephrasing the os.WNOHANG documentation to the following (or something similar): "The option for waitpid() to return immediately if no child process status is available immediately, in which case the function returns (0, 0). Correspondingly, wait3() and wait4() would return 3-element tuples with the first 2 elements being 0 and the last being a default-constructed resource usage information object." Unfortunately that last part about the default-constructed resource usage information object is only true after this recent bug fix: https://github.com/python/cpython/pull/15111/files So I'll leave it to y'all to decide how to update the documentation since my proposed phrasing is dependent on that bug fix. ---------- assignee: docs@python components: Documentation messages: 356627 nosy: bbmmy, docs@python priority: normal severity: normal status: open title: Clearer wording of os.WNOHANG documentation to avoid misinterpretation type: enhancement versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38802> _______________________________________

1 1