Mailman 3 May 2017 - docs

[issue29947] In SocketServer, why not passing a factory instance for the RequestHandlerClass instead of the class itself?
by Louie Lu 08 May '17

08 May '17

Changes by Louie Lu <me(a)louie.lu>: ---------- pull_requests: +1598 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29947> _______________________________________

1 0

[issue30168] Class Logger is unindented in the documentation.
by Jim Fasarakis-Hilliard 08 May '17

08 May '17

New submission from Jim Fasarakis-Hilliard: Currently, `Logger` in `logging.rst` doesn't have an indent after `.. class:: Logger`. This causes the formatting for the specific section to look somewhat unexpected [1]. I've already created a PR that indents the methods/attributes accordingly. After @bitdancer's request, created this issue to get feedback from vinay if this was done on purpose. [1]: https://docs.python.org/3/library/logging.html#logging.Logger ---------- assignee: docs@python components: Documentation messages: 292336 nosy: Jim Fasarakis-Hilliard, docs@python, vinay.sajip priority: normal severity: normal status: open title: Class Logger is unindented in the documentation. versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30168> _______________________________________

2 2

[issue30292] Why is there a concept "unbound method" in <Descriptor HowTo Guide> python3 version?
by debuggy 06 May '17

06 May '17

New submission from debuggy: When I read <Descriptor HowTo Guide> (python 3.6.1 version), I found there is a concept of 'unbound method' in some places. However, when I referred to <What’s New In Python 3.0>, it said the concept of “unbound methods” has been removed from the language. So I wondered if there should be a change in <Descriptor HowTo Guide> python3 version? For instance, in this code example of the guide: >>> class D(object): ... def f(self, x): ... return x ... >>> d = D() >>> D.__dict__['f'] # Stored internally as a function <function f at 0x00C45070> >>> D.f # Get from a class becomes an unbound method <unbound method D.f> >>> d.f # Get from an instance becomes a bound method <bound method D.f of <__main__.D object at 0x00B18C90>> When I tested myself, the result of statement "D.f" should be <function> not <unbound method>. ---------- assignee: docs@python components: Documentation messages: 293160 nosy: debuggy, docs@python priority: normal severity: normal status: open title: Why is there a concept "unbound method" in <Descriptor HowTo Guide> python3 version? type: enhancement versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30292> _______________________________________

2 1

[issue30278] The element div#sidebar on documentation requires the attribute role="button".
by Kyle Thomas 05 May '17

05 May '17

New submission from Kyle Thomas: Elements other than buttons which act as buttons require metadata to be accessible. Refer to https://www.w3.org/TR/wai-aria-practices/examples/button/button.html ---------- assignee: docs@python components: Documentation messages: 293056 nosy: Kyle Thomas, docs@python priority: normal severity: normal status: open title: The element div#sidebar on documentation requires the attribute role="button". type: enhancement versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30278> _______________________________________

1 0

[issue28315] incorrect "in ?" output in 'divide' example at "Defining Clean-up Actions" in tutorial
by Viorel Tabara 04 May '17

04 May '17

New submission from Viorel Tabara: At https://docs.python.org/3.5/tutorial/errors.html#defining-clean-up-actions when I'm running the "divide('2', '1')" example I get: File "<stdin>", line 1, in <module> instead of the documentation output of: File "<stdin>", line 1, in ? The same message is included with the 2.7 tutorial. To wit: $ python3 Python 3.5.2 (default, Sep 14 2016, 11:28:32) [GCC 6.2.1 20160901 (Red Hat 6.2.1-1)] on linux Type "help", "copyright", "credits" or "license" for more information. >>> def divide(x, y): ... try: ... result = x / y ... except ZeroDivisionError: ... print('division by zero!') ... else: ... print('result is', result) ... finally: ... print('executing finally clause') ... >>> divide(2, 1) result is 2.0 executing finally clause >>> divide(2, 0) division by zero! executing finally clause >>> divide('2', '1') executing finally clause Traceback (most recent call last): File "<stdin>", line 1, in <module> File "<stdin>", line 3, in divide TypeError: unsupported operand type(s) for /: 'str' and 'str' $ python2 Python 2.7.12 (default, Sep 2 2016, 15:40:50) [GCC 6.2.1 20160901 (Red Hat 6.2.1-1)] on linux2 Type "help", "copyright", "credits" or "license" for more information. >>> def divide(x, y): ... result = x / y KeyboardInterrupt >>> def divide(x, y): ... try: ... result = x / y ... except ZeroDivisionError: ... print('division by zero!') ... else: ... print('result is', result) ... finally: ... print('executing finally clause') ... >>> divide(2, 1) ('result is', 2) executing finally clause >>> divide(2, 0) division by zero! executing finally clause >>> divide('2', '1') executing finally clause Traceback (most recent call last): File "<stdin>", line 1, in <module> File "<stdin>", line 3, in divide TypeError: unsupported operand type(s) for /: 'str' and 'str' Nice tutorial by the way ;) Thanks! ---------- assignee: docs@python components: Documentation messages: 277731 nosy: docs@python, viorel priority: normal severity: normal status: open title: incorrect "in ?" output in 'divide' example at "Defining Clean-up Actions" in tutorial type: behavior versions: Python 2.7, Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28315> _______________________________________

5 46

[issue30208] Small typos in IDLE doc
by Cheryl Sabella 03 May '17

03 May '17

New submission from Cheryl Sabella: Fix some small typos in IDLE doc. ---------- assignee: docs@python components: Documentation messages: 292593 nosy: csabella, docs@python priority: normal severity: normal status: open title: Small typos in IDLE doc type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30208> _______________________________________

3 17

What are the license for python manuals?
by Zen Milen 02 May '17

02 May '17

Dear, copyright holder for python manuals. I want to know if I can redistribute python manuals with the form of mobile application. If I can, what are the restrictions ? Can I add an Ads in that application ? Thanks for your help in advance. Chun.

1 0

[issue27618] docs for threading.Lock claim it's a class (since 3.3), but it's not (and has never been, apparently)
by Mariatta Wijaya 02 May '17

02 May '17

Changes by Mariatta Wijaya <mariatta.wijaya(a)gmail.com>: ---------- stage: -> patch review versions: +Python 2.7, Python 3.7 -Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27618> _______________________________________

1 0

[issue30180] PyArg_ParseTupleAndKeywords supports required keyword only arguments
by Xiang Zhang 01 May '17

01 May '17

Changes by Xiang Zhang <angwerzx(a)126.com>: ---------- nosy: +xiang.zhang _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30180> _______________________________________

1 0