Mailman 3 June 2015 - docs

[issue23054] ConnectionError: ('Connection aborted.', BadStatusLine(""''''"))
by Joe Cabrera July 19, 2015

July 19, 2015

New submission from Joe Cabrera: ConnectionError: ('Connection aborted.', BadStatusLine(""''''")) This error can also occur on Linux and Windows, a more descriptive error messages would be useful for people trying to debug their code. ---------- assignee: docs@python components: Documentation messages: 232664 nosy: docs@python, joecabrera priority: normal severity: normal status: open title: ConnectionError: ('Connection aborted.', BadStatusLine(""''''")) type: behavior versions: Python 2.7 … [View More]

4 8

[issue17359] python modules.zip is not documented
by Marc-Andre Lemburg July 16, 2015

July 16, 2015

New submission from Marc-Andre Lemburg: The feature to run a ZIP file containing Python modules is not documented. It was implemented in Python 2.6: * http://bugs.python.org/issue1739468 and mentioned in the "What's new": * http://docs.python.org/2/whatsnew/2.6.html?highlight=python%20run%20zip%20f… but searching the documentation for "__main__.py" returns 0 hits in the docs (for Python 2.7 and 3.4). I guess "python dir" should also be mentioned somewhere... ---------- assignee: docs@… [View More]

6 13

[issue24525] [doc] missing word
by Vincent Legoll July 3, 2015

July 3, 2015

New submission from Vincent Legoll: Here is a patch to fix a missing word in the urllib doc ---------- assignee: docs@python components: Documentation files: python-doc-fix.hgpatch messages: 245927 nosy: docs@python, vincent-legoll priority: normal severity: normal status: open title: [doc] missing word type: enhancement versions: Python 2.7 Added file: http://bugs.python.org/file39828/python-doc-fix.hgpatch _______________________________________ Python tracker <report(a)bugs.python.org&… [View More]

3 2

[issue24458] Documentation for PEP 489
by Petr Viktorin July 3, 2015

July 3, 2015

New submission from Petr Viktorin: Hello, Here is a patch documenting PEP 489. I don't feel comfortable rewriting the tutorial [0] yet: before the issue with callbacks/module state [1] is solved, which is 3.6 material, multi-phase init is not suitable for all modules. So everything in PEP 489 is described in reference-style documentation. [0] https://docs.python.org/3/extending/extending.html [1] https://www.python.org/dev/peps/pep-0489/#module-state-and-c-level-callbacks ---------- … [View More]

4 8

[issue24515] docstring of isinstance
by Luc Saffre July 2, 2015

July 2, 2015

New submission from Luc Saffre: The docstring of built-in function 'isinstance' should explain that if the classinfo is a tuple, the object must be instance of *any* (not *all*) of the class objects. ---------- assignee: docs@python components: Documentation messages: 245841 nosy: Luc Saffre, docs@python priority: normal severity: normal status: open title: docstring of isinstance type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.… [View More]

3 5

[issue24487] Change asyncio.async() → ensure_future()
by Martin Panter July 1, 2015

July 1, 2015

New submission from Martin Panter: The async() function is marked as deprecated in 3.4.4. This patch replaces most references to it with references to ensure_future(). The exception is <https://docs.python.org/3.4/library/asyncio-eventloop.html#asyncio.BaseEven…>, which suggests using it in Python < 3.4.2. ---------- assignee: docs@python components: Documentation, asyncio files: ensure_future.patch keywords: patch messages: 245631 nosy: docs@python, gvanrossum, haypo, vadmium, … [View More]

4 7

[issue3530] ast.NodeTransformer doc bug
by Terry J. Reedy June 29, 2015

June 29, 2015

Terry J. Reedy added the comment: I am reopening this as a doc bug because RewriteName is a copy (with 'ast.' prefixes added) of a buggy example in the doc. The bug is that the new .value Name and Str attributes do not get the required 'lineno' and 'col_offset' attributes. As Armin said, copy_location is not recursive and does not fix children of the node it fixes. Also, the recursive .visit method does not recurse into children of replacement nodes (and if it did, the new Str node would … [View More]

1 0

[issue17546] Document the circumstances where the locals() dict get updated
by Martin Panter June 29, 2015

June 29, 2015

Martin Panter added the comment: I quickly scanned through the email thread from Issue 17960. I guess it makes sense to specify that locals() can be used to directly get a class’s namespace. Probably doesn’t hurt to say locals() is equivalent to globals() at module level, although this seems like a fairly redundant feature. Here is locals_doc.03.patch, which uses my wording for function namespaces, and also adds more for class and global namespaces, as suggested by Nick. ---------- Added … [View More]

1 0

Re: [docs] Rename and document test.script_helper as test.support.script_helper (issue 18576)
by vadmium+py＠gmail.com June 29, 2015

June 29, 2015

https://bugs.python.org/review/18576/diff/15165/Doc/library/test.rst File Doc/library/test.rst (right): https://bugs.python.org/review/18576/diff/15165/Doc/library/test.rst#newcod… Doc/library/test.rst:652: variables *env_vars*, asserting that run succeeds (``rc == 0``). (return code is zero) might be better, to match the term used in the next paragraph https://bugs.python.org/review/18576/diff/15165/Doc/library/test.rst#newcod… Doc/library/test.rst:655: appropriate :exc:`AssertionError`` … [View More]

1 0