Mailman 3 March 2017 - docs

[issue29666] Issue in enum documentation
by STINNER Victor March 2, 2017

March 2, 2017

New submission from STINNER Victor: https://docs.python.org/dev/library/enum.html "This module defines four enumeration classes that can be used to define unique sets of names and values: Enum, IntEnum, and IntFlags" Enum, IntEnum, IntFlag: I count 3 classes, no 4? Moreover, the correct class name is IntFlag, not IntFlags. Or did I miss something? haypo@selma$ ./python Python 3.7.0a0 (default, Feb 25 2017, 04:30:32) >>> import enum >>> enum.IntFlags ... AttributeError: module 'enum' has no attribute 'IntFlags' ---------- assignee: docs@python components: Documentation keywords: easy messages: 288642 nosy: docs@python, haypo priority: normal severity: normal status: open title: Issue in enum documentation versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29666> _______________________________________

4 6

Margaret docs maintenance
by Steve Carter March 2, 2017

March 2, 2017

Hi all, How would I go about submitting a rewrite to the argparse page? I use argparse a lot (python 2.7) and find myself at the reference page often, but it opens with an example that is far from a typical argument parsing application. It should open with reference material and illustrate the reference material with realistic examples. Would such a contribution be welcome? How should I start? Thanks Best regards, Steve Carter

1 0

link to openssl ciphers from ssl module docs is dead
by Wysokinski, Michal March 1, 2017

March 1, 2017

In docs for set_ciphers method of the SSLContext class (https://docs.python.org/3.6/library/ssl.html#ssl.SSLContext.set_ciphers) there is an external link labeled OpenSSL cipher list format pointing to https://www.openssl.org/docs/manmaster/apps/ciphers.html#CIPHER-LIST-FORMAT That link is dead. I believe currently the link needs to include specific open ssl version in it and the following one works fine: https://www.openssl.org/docs/man1.0.2/apps/ciphers.html#CIPHER-LIST-FORMAT The problem is present in Python 3.6 and 3.5 docs. I haven’t checked docs for other versions. Cheers Michal

1 0

[issue29677] 'round()' accepts a negative integer for ndigits
by Vedran Čačić March 1, 2017

March 1, 2017

Vedran Čačić added the comment: This is one of those things that show Python being extremely consistent within itself. Of course, docs should be clarified if needed, but the feature is desirable and useful. ---------- nosy: +veky _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29677> _______________________________________

1 0