Mailman 3 July 2016 - docs

[issue26462] Patch to enhance literal block language declaration
by Julien Aug. 5, 2016

Aug. 5, 2016

New submission from Julien: Hi, As I don't like warnings, and sphinx-doc was verbose about "Could not parse literal_block as "python3". highlighting skipped.", I fixed most of them. Bonus: It's graphically better, as an example the XML block here: https://docs.python.org/3.5/library/pyexpat.html is now nicely colored: http://www.afpy.org/doc/python/3.5/library/pyexpat.html ---------- assignee: docs@python components: Documentation files: literal_blocks_languages.patch keywords: patch messages: 261035 nosy: docs@python, sizeof priority: normal severity: normal status: open title: Patch to enhance literal block language declaration type: enhancement versions: Python 3.5 Added file: http://bugs.python.org/file42050/literal_blocks_languages.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26462> _______________________________________

8 34

Word missing
by Linda Pescatore Aug. 4, 2016

Aug. 4, 2016

Section 3.3.2, there is a word missing at the end of this sentence: This allows you to type python to run the interpreter, and pip or .

2 1

[issue24082] Obsolete note in argument parsing (c-api/arg.rst)
by Petr Viktorin Aug. 4, 2016

Aug. 4, 2016

New submission from Petr Viktorin: A note in the docs for the "u" format unit saus NULs are not allowed, but the previous sentence says they aren't accepted. ---------- assignee: docs@python components: Documentation files: 0002-Remove-obsolete-note-in-argument-parsing-docs.patch keywords: patch messages: 242271 nosy: docs@python, encukou priority: normal severity: normal status: open title: Obsolete note in argument parsing (c-api/arg.rst) versions: Python 3.4 Added file: http://bugs.python.org/file39236/0002-Remove-obsolete-note-in-argument-pars… _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue24082> _______________________________________

5 5

[issue23710] C API doc for PyObject_HEAD is outdated
by Tomi Pieviläinen Aug. 3, 2016

Aug. 3, 2016

New submission from Tomi Pieviläinen: https://docs.python.org/3/c-api/structures.html#c.PyObject_HEAD says that the macro should be used for creating new types and that it has ob_type. Unfortunately at some point (@61466 perhaps) that definition in object.h was changed. This affects other pages too (at least https://docs.python.org/3/extending/newtypes.html). I encountered this while checking if a C extension (imposm.parser) could be trivially ported for Python 3. Unfortunately not. I suppose self->ob_type should be replaced with Py_TYPE(self) but that isn't really clear from the docs. ---------- assignee: docs@python components: Documentation messages: 238530 nosy: docs@python, tpievila priority: normal severity: normal status: open title: C API doc for PyObject_HEAD is outdated _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23710> _______________________________________

7 10

[issue26576] Tweak wording of decorator docos
by Chris Angelico Aug. 3, 2016

Aug. 3, 2016

New submission from Chris Angelico: The official documentation declares an unambiguous equivalence which is not true in some corner cases: @deco def f(x): pass is not quite the same as def f(x): pass f = deco(f) as the name is never bound to the undecorated function. This is what makes @property and @prop.setter work; otherwise, the undecorated setter function would overwrite the property, and the decoration would fail. Attached patch loosens the wording slightly to "broadly equivalent"; this permits corner cases to vary from the equivalence, while still retaining its simplicity for the 99% of cases where it's correct. (Think of explaining "yield from iter" as "for x in iter: yield x" and you have a similar near-equivalence.) Also, class decorators aren't required to return classes. Text removed saying that they do. ---------- assignee: docs@python components: Documentation files: deco-docos.patch keywords: patch messages: 261888 nosy: Rosuav, docs@python priority: normal severity: normal status: open title: Tweak wording of decorator docos Added file: http://bugs.python.org/file42181/deco-docos.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26576> _______________________________________

6 12

[issue23746] sysconfg.is_python_build() is buggy
by Berker Peksag July 31, 2016

July 31, 2016

Changes by Berker Peksag <berker.peksag(a)gmail.com>: ---------- components: -Library (Lib) keywords: +easy stage: -> needs patch type: -> enhancement versions: +Python 3.6 -Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23746> _______________________________________

1 0

bug in python
by Srijan Lawrence July 31, 2016

July 31, 2016

i found a bug in python program during my computer practicals

2 1

'404 Not Found' errors at www.python.org/ftp/python/doc/3.4.5/
by Ramesh Jayaraman July 30, 2016

July 30, 2016

3.4.5 docs are inaccessible in any format ! (3.4.4 versions also inaccessible at docs.python.org/release/3.4.4/archives/python-3.4.4-docs-html.tar.bz2

1 0

Re: [docs] Expand documentation about type aliases and NewType in the typing module (issue 27644)
by levkivskyi＠gmail.com July 29, 2016

July 29, 2016

On 2016/07/30 00:33:29, gvanrossum wrote: > I probably didn't think about this when > reviewing the PEP text, so perhaps the PEP should also be updated. This is already in the PEP, quote: "NewType accepts only one argument that shoud be a proper class". http://bugs.python.org/review/27644/

1 0

[issue27644] Expand documentation about type aliases and NewType in the typing module
by Michael Lee July 29, 2016

July 29, 2016

New submission from Michael Lee: This is a patch to update the documentation on the typing module. It expands the section on type aliases and adds a section on [NewType][0]. Since support for NewType was [recently added][1] to mypy, it seemed like a prudent time to update the docs to describe this new feature. The section on type aliases was mainly expanded because the distinction between type aliases and NewType could be potentially confusing, so adding extra clarification seemed like a good idea. [0]: https://www.python.org/dev/peps/pep-0484/#newtype-helper-function [1]: https://github.com/python/mypy/pull/1939 ---------- assignee: docs@python components: Documentation files: document_newtype.patch keywords: patch messages: 271572 nosy: docs@python, michael0x2a priority: normal severity: normal status: open title: Expand documentation about type aliases and NewType in the typing module versions: Python 3.5, Python 3.6 Added file: http://bugs.python.org/file43926/document_newtype.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27644> _______________________________________

3 7