Mailman 3 May 2017 - docs

[issue27618] docs for threading.Lock claim it's a class (since 3.3), but it's not (and has never been, apparently)
by Cheryl Sabella May 31, 2017

May 31, 2017

Cheryl Sabella added the comment: *bump* The PR was approved by R. David Murray a while ago. I can backport once it's merged. Thanks! ---------- nosy: +csabella _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27618> _______________________________________

1 0

Minor Issue (Broken Link) on SSL Module Library Page
by Micah Parks May 30, 2017

May 30, 2017

Hello, I found a broken link on the SSL module library page for Python 3.6.1. This link is under "18.2.1.1. Socket creation" in the "ssl.wrap_socket" function. The description for the *ciphers *keyword argument contains this text: "The *ciphers* parameter sets the available ciphers for this SSL object. It should be a string in the OpenSSL cipher list format <https://www.openssl.org/docs/apps/ciphers.html#CIPHER-LIST-FORMAT>." This link is broken. I believe the correct link should lead to: " https://www.openssl.org/docs/man1.1.0/apps/ciphers.html". Other versions of the docs appear to need this small updated link too. Thank you contributing your time to the Python community! Micah Parks

1 0

[issue17188] Document 'from None' in raise statement doc.
by Terry J. Reedy May 30, 2017

May 30, 2017

New submission from Terry J. Reedy: Language manual, section 7.8. The raise statement has no mention of the 'from None' option. Indeed it says "if given, the second expression must be another exception class or instance", which would exclude None. Library manual, Ch 5. Built-in Exceptions, says ''' When raising a new exception (rather than using a bare raise to re-raise the exception currently being handled), the implicit exception context can be supplemented with an explicit cause by using from with raise: raise new_exc from original_exc The expression following from must be an exception or None. It will be set as __cause__ on the raised exception. Setting __cause__ also implicitly sets the __suppress_context__ attribute to True, so that using raise new_exc from None effectively replaces the old exception with the new one for display purposes (e.g. converting KeyError to AttributeError, while leaving the old exception available in __context__ for introspection when debugging. ''' I am not sure how much should be copied over, but None should be at least mentioned and perhaps there should be a cross-reference. I am also not sure how much applies to 3.2, but there is no version-added or -changed note with the above. ---------- assignee: docs@python components: Documentation messages: 181939 nosy: docs@python, ncoghlan, terry.reedy priority: normal severity: normal stage: needs patch status: open title: Document 'from None' in raise statement doc. versions: Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17188> _______________________________________

13 34

[issue30354] Change data model documentation to zero-argument super()
by Cheryl Sabella May 30, 2017

May 30, 2017

New submission from Cheryl Sabella: Update data model documentaion to reflect the zero-argument form of super(). ---------- assignee: docs@python components: Documentation messages: 293566 nosy: csabella, docs@python priority: normal severity: normal status: open title: Change data model documentation to zero-argument super() type: enhancement versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30354> _______________________________________

3 8

[issue9544] xdrlib.Packer().pack_fstring throws a TypeError when called with a str()
by Jan Hnatek May 30, 2017

May 30, 2017

Jan Hnatek added the comment: Attached an updated patch against 3.7 fixing the remaining mentions of string. ---------- Added file: http://bugs.python.org/file46914/issue9544.2.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9544> _______________________________________

1 0

[issue30361] Docs example: converting mixed types to floating point
by Mihai Borobocea May 29, 2017

May 29, 2017

New submission from Mihai Borobocea: Section 3.1.1 in the Docs states: "operators with mixed type operands convert the integer operand to floating point" https://docs.python.org/3/tutorial/introduction.html But gives an example using the division operator: >>> 3 * 3.75 / 1.5 7.5 >>> 7.0 / 2 3.5 In Python 3, division always returns a float, e.g. when all operands are integers: >>> 3 * 3 / 1 9.0 >>> 7 / 2 3.5 To illustrate that "operators with mixed type operands convert the integer operand to floating point" the example should not use division. For example: >>> 3 * 3.75 - 1 10.25 >>> 7.0 + 2 9.0 ---------- assignee: docs@python components: Documentation messages: 293641 nosy: MihaiHimself, docs@python priority: normal severity: normal status: open title: Docs example: converting mixed types to floating point versions: Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30361> _______________________________________

4 12

[issue9544] xdrlib.Packer().pack_fstring throws a TypeError when called with a str()
by Serhiy Storchaka May 29, 2017

May 29, 2017

Serhiy Storchaka added the comment: issue9544.patch LGTM as the first step. There are other mentions of strings in the documentation. ---------- nosy: +serhiy.storchaka stage: -> needs patch versions: +Python 3.5, Python 3.6, Python 3.7 -Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9544> _______________________________________

1 0

[issue9544] xdrlib.Packer().pack_fstring throws a TypeError when called with a str()
by Jan Hnatek May 29, 2017

May 29, 2017

Changes by Jan Hnatek <jan.hnatek(a)gmail.com>: ---------- nosy: +hnhn _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9544> _______________________________________

1 0

[issue22702] to improve documentation for join() (str method)
by Raymond Hettinger May 27, 2017

May 27, 2017

Raymond Hettinger added the comment: > Do you think that's sufficient to fully resolve the request here, Thanks Nick. That will suffice. ---------- resolution: -> fixed stage: -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue22702> _______________________________________

1 0

[issue30470] Deprecate invalid ctypes call protection on Windows
by Mariatta Wijaya May 27, 2017

May 27, 2017

New submission from Mariatta Wijaya: It was proposed by Steve Dower by email to python-dev: https://mail.python.org/pipermail/python-dev/2017-May/147959.html It should be deprecated in Python 3.6.2 and removed in 3.7.0 ---------- assignee: docs@python components: Documentation, ctypes messages: 294435 nosy: Mariatta, docs@python, haypo, steve.dower priority: normal severity: normal status: open title: Deprecate invalid ctypes call protection on Windows versions: Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30470> _______________________________________

1 5