Mailman 3 August 2016 - docs

[issue27712] Tiny typos in import.rst
by Martin Panter Aug. 12, 2016

Aug. 12, 2016

New submission from Martin Panter: Looks good to me ---------- nosy: +martin.panter stage: -> commit review versions: +Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27712> _______________________________________

4 3

Superfluous dict() call in metaclass example?
by Matthias Geier Aug. 12, 2016

Aug. 12, 2016

Dear list. Regarding this metaclass example: https://docs.python.org/3.6/reference/datamodel.html#metaclass-example It contains this line: result = type.__new__(cls, name, bases, dict(namespace)) I think the invocation of dict() here is superfluous and misleading. It's explained in the paragraph directly above this section: """ When a new class is created by type.__new__, the object provided as the namespace parameter is copied to a standard Python dictionary and the original object is discarded. The new copy becomes the __dict__ attribute of the class object. """ Since a copy is made anyway, what's the use of calling dict() on the OrderedDict instance? I tried running the code without dict() and it still seems to work fine. But maybe I'm wrong? cheers, Matthias

1 0

[issue27719] Misleading note about "args" attribute in "User-defined Exceptions" section of tutorial
by Ben Hoyt Aug. 12, 2016

Aug. 12, 2016

New submission from Ben Hoyt: In the official tutorial in the "User-defined Exceptions" section (https://docs.python.org/3.5/tutorial/errors.html#user-defined-exceptions) there's a note about a user-defined Exception subclass as follows: "In this example, the default __init__() of Exception has been overridden. The new behavior simply creates the value attribute. This replaces the default behavior of creating the args attribute." That last sentence is wrong: it used to be that way (it is in Python 2.x and I believe in Python pre 3.2), but now the implementation of BaseException.__new__ now sets args, so even when you override __init__ and don't call super() args is set. I think that's what you want, so I'm putting this down to a documentation bug. I think the sentence "This replaces the default behavior of creating the args attribute." should simply be removed (BaseException.__init__ basically does nothing now). This change happened for Python 3.3 and was backported to Python 3.2. See also: * The relevant part of BaseException.__new__ in the CPython codebase: https://github.com/python/cpython/blob/601ee5fab5df81a25611da0667030de531c1… * The issue where this behaviour was changed: http://bugs.python.org/issue1692335 * The commit where it was changed: https://hg.python.org/cpython/rev/68e2690a471d (on GitHub at https://github.com/python/cpython/commit/a71a87e695b05a67bd22c6ac74311b1f56…) * You can repro this and confirm that "args" is definitely set with the attached script: $ python exception_args_test.py sys.version_info(major=3, minor=5, micro=2, releaselevel='final', serial=0) Error args: ('error!',) ---------- assignee: docs@python components: Documentation files: exception_args_test.py messages: 272256 nosy: benhoyt, docs@python, georg.brandl, sbt priority: normal severity: normal status: open title: Misleading note about "args" attribute in "User-defined Exceptions" section of tutorial versions: Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6 Added file: http://bugs.python.org/file44058/exception_args_test.py _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27719> _______________________________________

4 8

[issue27745] Fix typos in Argument Clinic howto
by SilentGhost Aug. 12, 2016

Aug. 12, 2016

SilentGhost added the comment: Thanks, Lele. ---------- resolution: -> fixed stage: commit review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27745> _______________________________________

1 0

[issue27745] Fix typos in Argument Clinic howto
by Roundup Robot Aug. 12, 2016

Aug. 12, 2016

Roundup Robot added the comment: New changeset 129c601e7bfa by Martin Panter in branch '3.5': Issue #27745: Fix some typos in Argument Clinic howto, by Lele Gaifax https://hg.python.org/cpython/rev/129c601e7bfa New changeset 8c33152fd75c by Martin Panter in branch 'default': Issue #27745: Merge typo fixes from 3.5 https://hg.python.org/cpython/rev/8c33152fd75c ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27745> _______________________________________

1 0

[issue27745] Fix typos in Argument Clinic howto
by SilentGhost Aug. 12, 2016

Aug. 12, 2016

Changes by SilentGhost <ghost.adh(a)runbox.com>: ---------- components: +Documentation versions: +Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27745> _______________________________________

1 0

[issue27745] Fix typos in Argument Clinic howto
by SilentGhost Aug. 12, 2016

Aug. 12, 2016

SilentGhost added the comment: LGTM ---------- stage: -> commit review type: -> behavior _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27745> _______________________________________

1 0

[issue27745] Fix typos in Argument Clinic howto
by Lele Gaifax Aug. 12, 2016

Aug. 12, 2016

Changes by Lele Gaifax <lelegaifax(a)gmail.com>: Removed file: http://bugs.python.org/file44083/ac-doc-typos.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27745> _______________________________________

1 0

[issue27745] Fix typos in Argument Clinic howto
by Lele Gaifax Aug. 12, 2016

Aug. 12, 2016

Lele Gaifax added the comment: Re-uploaded the patch file, without spurious stuff. ---------- Added file: http://bugs.python.org/file44084/ac-doc-typos.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27745> _______________________________________

1 0