Mailman 3 October 2018 - docs

[issue32798] mmap.flush() on Linux does not accept the "offset" and "size" args
by STINNER Victor 20 Oct '18

20 Oct '18

STINNER Victor <vstinner(a)redhat.com> added the comment: New changeset 027664a3d5ebad575aafe5fcc572e3b05f7f24e5 by Victor Stinner (Pablo Galindo) in branch 'master': bpo-32798: Add restriction on the offset parameter for mmap.flush in the docs (#5621) https://github.com/python/cpython/commit/027664a3d5ebad575aafe5fcc572e3b05f… ---------- nosy: +vstinner _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32798> _______________________________________

1 0

[issue10344] codecs.open() buffering doc needs fix
by STINNER Victor 20 Oct '18

20 Oct '18

STINNER Victor <vstinner(a)redhat.com> added the comment: New changeset a2670565d8f5c502388378aba1fe73023fd8c8d4 by Victor Stinner (Alexey Izbyshev) in branch 'master': bpo-32236: open() emits RuntimeWarning if buffering=1 for binary mode (GH-4842) https://github.com/python/cpython/commit/a2670565d8f5c502388378aba1fe73023f… ---------- nosy: +vstinner _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue10344> _______________________________________

1 0

[issue33594] add deprecation since 3.5 for a few methods of inspect.
by Matthias Bussonnier 20 Oct '18

20 Oct '18

New submission from Matthias Bussonnier <bussonniermatthias(a)gmail.com>: inspect's getargspec, as well as Signature's from_function, and from_builtin are deprecated. They all emits DeprecationWarning but: The deprecation warning does not say since which version since are deprecated. For the two Signature's methods, there is no documentation available, so finding this information is difficult. Many tool rely on introspection to provide object help via docstring, which also did not include this deprecation notice. Adding the deprecation informations to these 3 function/methods would be good to foster migration to newer ways. ---------- assignee: docs@python components: Documentation messages: 317252 nosy: docs@python, mbussonn priority: normal severity: normal status: open title: add deprecation since 3.5 for a few methods of inspect. versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33594> _______________________________________

4 8

[issue33726] Add short descriptions to PEP references in seealso
by Andrés Delfino 20 Oct '18

20 Oct '18

New submission from Andrés Delfino <adelfino(a)gmail.com>: There are a couple of PEP references with no description in Simple/Compound Statements. Attached PR fixes this. ---------- assignee: docs@python components: Documentation messages: 318359 nosy: adelfino, docs@python priority: normal severity: normal status: open title: Add short descriptions to PEP references in seealso type: enhancement versions: Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33726> _______________________________________

4 9

[issue33708] Doc: Asyncio's Event documentation typo.
by Марк Коренберг 19 Oct '18

19 Oct '18

New submission from Марк Коренберг <socketpair(a)gmail.com>: https://docs.python.org/3/library/asyncio-sync.html#asyncio.Event : Class implementing event objects. An event manages a flag that can be set to true with the set() method and reset to false with the clear() method. The -----> wait() <----- method blocks until the flag is true. The flag is initially false. this link points to wrong place. ---------- assignee: docs@python components: Documentation, asyncio messages: 318270 nosy: asvetlov, docs@python, socketpair, yselivanov priority: normal severity: normal status: open title: Doc: Asyncio's Event documentation typo. type: enhancement versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33708> _______________________________________

3 7

Missing documentation in PDF format
by Sorin Szabo 19 Oct '18

19 Oct '18

Hi, I've been trying to download the python documentation in pdf format without success. The files appear to be missing. This is the page where I'm trying to access the files https://docs.python.org/3.6/download.html The link to the file is this one: https://docs.python.org/3.6/archives/python-3.6.7rc2-docs-pdf-letter.zip There may be more than one file missing. Thanks!

1 0

[issue32174] nonASCII punctuation characters can not display in python363.chm.
by Matej Cepl 19 Oct '18

19 Oct '18

Matej Cepl <mcepl(a)cepl.eu> added the comment: Sorry, my mistake, it seems I was using python2 Sphinx even for building python3 documentation, which is a bad idea, I guess. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32174> _______________________________________

1 0

The links for Download Python 3.7.1rc2 Documentation are not working
by Chinnathan Chongsujiphan 19 Oct '18

19 Oct '18

https://docs.python.org/3/download.html

1 0

ssl.create_default_context
by Christoph Egger 19 Oct '18

19 Oct '18

Hi! ``` The settings are: PROTOCOL_TLS, OP_NO_SSLv2, and OP_NO_SSLv3 with high encryption cipher suites without RC4 and without unauthenticated cipher suites. Passing SERVER_AUTH as purpose sets verify_mode to CERT_REQUIRED and either loads CA certificates (when at least one of cafile, capath or cadata is given) or uses SSLContext.load_default_certs() to load default CA certificates. ``` `SERVER_AUTH` not only sets `CERT_REQUIRED` but also `check_hostname` to `True`. As this is critical information for users with some familiarity with python’s SSL library the documentation should mention it (especially as it talks explicitly about the `CERT_REQUIRED` part) https://github.com/python/cpython/blob/master/Lib/ssl.py#L567 Thanks! Christoph

1 0

documentation pdf
by Pol Mollitor 19 Oct '18

19 Oct '18

Good morning, I wanted to let you know that the python documentation in pdf format is currently not available. Could you please update the link? Best regards, Pol Mollitor

1 0