Mailman 3 October 2019 - docs

[issue9182] document “--” as a way to distinguish option w/ narg='+' from positional argument in argparse
by Jackson Riley 31 Oct '19

31 Oct '19

Jackson Riley <jacriley(a)cisco.com> added the comment: Hi all, I'm a newcomer and wanted to try to make this change, is it still wanted/needed? ---------- nosy: +jacksonriley _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue9182> _______________________________________

1 0

[issue38600] Change the mark up of NULL
by Serhiy Storchaka 31 Oct '19

31 Oct '19

New submission from Serhiy Storchaka <storchaka+cpython(a)gmail.com>: Currently NULL is mostly marked up as *NULL* in the C API documentation (although it is marked up as ``NULL`` outside of the C API documentation). It is rendered with italic font as function parameters and contradicts with formatting other macros and constants with monospace font. The proposed PR replaces all *NULL* with ``NULL``. ---------- assignee: docs@python components: Documentation messages: 355452 nosy: docs@python, serhiy.storchaka priority: normal severity: normal status: open title: Change the mark up of NULL type: enhancement versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38600> _______________________________________

2 16

[issue16575] ctypes: unions as arguments
by Vinay Sajip 31 Oct '19

31 Oct '19

Vinay Sajip <vinay_sajip(a)yahoo.co.uk> added the comment: New changeset 79d4ed102a5069c6cebaed2627cb1645637f0429 by Vinay Sajip in branch 'master': bpo-16575: Add checks for unions passed by value to functions. (GH-16799) https://github.com/python/cpython/commit/79d4ed102a5069c6cebaed2627cb164563… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue16575> _______________________________________

1 0

[issue38637] fix GROWTH_RATE comments bug
by toywei 30 Oct '19

30 Oct '19

New submission from toywei <g1e2t3(a)foxmail.com>: It also exists in 3.7/3.6/3.3. ---------- assignee: docs@python components: Documentation messages: 355688 nosy: docs@python, toywei priority: normal pull_requests: 16516 severity: normal status: open title: fix GROWTH_RATE comments bug type: resource usage versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38637> _______________________________________

3 2

[issue30548] typo in documentation for create_autospec
by Erik Byström 30 Oct '19

30 Oct '19

New submission from Erik Byström: "a class" should most probably be replaced by "an instance" in the documentation for create_autospec. "You can use a class as the spec for an instance object by passing instance=True. The returned mock will only be callable if instances of the mock are callable." https://docs.python.org/3/library/unittest.mock.html#unittest.mock.create_a… ---------- assignee: docs@python components: Documentation messages: 294993 nosy: Erik Byström, docs@python priority: normal severity: normal status: open title: typo in documentation for create_autospec type: enhancement versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30548> _______________________________________

4 4

[issue36971] Add subsections in C API "Common Object Structures" page
by Jeroen Demeyer 30 Oct '19

30 Oct '19

New submission from Jeroen Demeyer <J.Demeyer(a)UGent.be>: The page https://docs.python.org/3/c-api/structures.html could be better structured by arranging the content in sub-sections. ---------- assignee: docs@python components: Documentation messages: 342911 nosy: docs@python, jdemeyer priority: normal severity: normal status: open title: Add subsections in C API "Common Object Structures" page versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue36971> _______________________________________

3 4

[issue35745] Add import statement in dataclass code snippet
by Windson Yang 29 Oct '19

29 Oct '19

New submission from Windson Yang <wiwindson(a)outlook.com>: Most of the example in https://docs.python.org/3/library/dataclasses.html miss code like from dataclasses import dataclass, field from typing import List I think we should add this statement in the code snippet. ---------- assignee: docs@python components: Documentation messages: 333707 nosy: Windson Yang, docs@python priority: normal severity: normal status: open title: Add import statement in dataclass code snippet type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35745> _______________________________________

3 3

[issue38336] Remove the __set__ method restriction on data descriptors for attribute lookup precedence
by Géry 29 Oct '19

29 Oct '19

New submission from Géry <gery.ogam(a)gmail.com>: The [language documentation](https://docs.python.org/3/reference/datamodel.html#invoking-… states: > Data descriptors with __set__() and __get__() defined always override a redefinition in an instance dictionary. In contrast, non-data descriptors can be overridden by instances. This override is not limited to data descriptors defining `__set__()` (and `__get__()`). It is also true for data descriptors defining `__delete__()` (and `__get__()`) and data descriptors defining both `__set__()` and `__delete__()` (and `__get__()`). In other words, _any_ data descriptors (objects defining either `__set__()` or `__delete__()` or both) defining `__get__()` override an attribute redefinition in an instance dictionary. ---------- assignee: docs@python components: Documentation messages: 353685 nosy: docs@python, maggyero priority: normal severity: normal status: open title: Remove the __set__ method restriction on data descriptors for attribute lookup precedence type: enhancement versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38336> _______________________________________

2 8

[issue38125] Can' build document in Sphinx v2.2.0
by Windson Yang 29 Oct '19

29 Oct '19

New submission from Windson Yang <wiwindson(a)outlook.com>: I got two errors when I try to build python document with make venv make html The first one is > Since v2.0, Sphinx uses "index" as master_doc by default. Please add "master_doc = 'contents'" to your conf.py. After fixing this one, the second one is > /Users/windson/learn/cpython/Doc/library/email.message.rst:4:duplicate object description of email.message, other instance in library/email.compat32-message, use :noindex: for one of them ---------- assignee: docs@python components: Documentation messages: 352034 nosy: Windson Yang, docs@python priority: normal severity: normal status: open title: Can' build document in Sphinx v2.2.0 type: crash versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38125> _______________________________________

2 2

[issue25299] TypeError: __init__() takes at least 4 arguments (4 given)
by A. Skrobov 28 Oct '19

28 Oct '19

New submission from A. Skrobov: Python 2.7.3 (default, Dec 18 2014, 19:10:20) [GCC 4.6.3] on linux2 Type "help", "copyright", "credits" or "license" for more information. >>> from argparse import ArgumentParser >>> parser = ArgumentParser() >>> parser.add_argument("--foo", help="foo", action='store_const') Traceback (most recent call last): File "<stdin>", line 1, in <module> File "/usr/lib/python2.7/argparse.py", line 1281, in add_argument action = action_class(**kwargs) TypeError: __init__() takes at least 4 arguments (4 given) >>> First, the exception message is entirely unhelpful (you wanted at least 4, you got 4, what's your problem?) Second, adding "const=None" to the invocation makes it succeed; but, according to https://docs.python.org/2/library/argparse.html#const this argument defaults to "None", so it shouldn't be necessary to specify it explicitly. Thus, either the documentation or the implementation is wrong. ---------- assignee: docs@python components: Documentation, Extension Modules messages: 252106 nosy: A. Skrobov, docs@python priority: normal severity: normal status: open title: TypeError: __init__() takes at least 4 arguments (4 given) type: behavior versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25299> _______________________________________

6 17