Mailman 3 August 2013 - docs

[issue18445] Tools/Script/Readme is outdated
by A.M. Kuchling Aug. 19, 2013

Aug. 19, 2013

A.M. Kuchling added the comment: Seydou: thanks for the patch! I've applied it to 3.4. ---------- nosy: +akuchling resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18445> _______________________________________

1 0

[issue18445] Tools/Script/Readme is outdated
by Roundup Robot Aug. 19, 2013

Aug. 19, 2013

Roundup Robot added the comment: New changeset 16fad6c48016 by Andrew Kuchling in branch 'default': #18445: update Tools/scripts/README. http://hg.python.org/cpython/rev/16fad6c48016 ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18445> _______________________________________

1 0

[issue18445] Tools/Script/Readme is outdated
by Roundup Robot Aug. 18, 2013

Aug. 18, 2013

Roundup Robot added the comment: New changeset 9d5468a7a381 by Andrew Kuchling in branch 'default': #18445: change permissions on some scripts to executable http://hg.python.org/cpython/rev/9d5468a7a381 ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18445> _______________________________________

1 0

[issue18562] Regex howto: revision pass
by A.M. Kuchling Aug. 18, 2013

Aug. 18, 2013

New submission from A.M. Kuchling: I read through the 3.3 regex howto and have made various edits in the attached patch. * describe how \w is different when used in bytes and Unicode patterns. * describe re.ASCII flag to change that behaviour. * remove a personal reference ('I generally prefer...') * some small edits and re-wording. ---------- assignee: docs@python components: Documentation files: regex.diff keywords: patch messages: 193733 nosy: akuchling, docs@python priority: normal severity: normal stage: patch review status: open title: Regex howto: revision pass versions: Python 3.3 Added file: http://bugs.python.org/file31039/regex.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18562> _______________________________________

5 8

Re: [docs] Fix internal doc references for the email package (issue 18761)
by storchaka＠gmail.com Aug. 18, 2013

Aug. 18, 2013

http://bugs.python.org/review/18761/diff/8959/Doc/library/email.rst File Doc/library/email.rst (right): http://bugs.python.org/review/18761/diff/8959/Doc/library/email.rst#newcode… Doc/library/email.rst:300: * The method :meth:`setboundary` was renamed to :meth:`~email.message.Message.set_boundary`. On 2013/08/16 23:38:47, ezio.melotti wrote: > Is there any way to either set a shortcut somewhere for email.message.Message or > set is as current class/module? Yes, we can change current module and class. But then we should change them back when we want refers to entities in other modules/classes. And we should always remember which module and class are current (it can be declared several pages above). I think explicitness is better here. http://bugs.python.org/review/18761/

1 0

[issue18768] Wrong documentation of RAND_egd function in ssl module
by Vajrasky Kok Aug. 17, 2013

Aug. 17, 2013

New submission from Vajrasky Kok: >>> import ssl >>> ssl.RAND_egd.__doc__ "RAND_egd(path) -> bytes\n\nQueries the entropy gather daemon (EGD) on the socket named by 'path'.\nReturns number of bytes read. Raises SSLError if connection to EGD\nfails or if it does provide enough data to seed PRNG." Compare it to documentation about RAND_egd() function from openssl website (https://www.openssl.org/docs/crypto/RAND_egd.html): RAND_egd() and RAND_egd_bytes() return the number of bytes read from the daemon on success, and -1 if the connection failed or the daemon did not return enough data to fully seed the PRNG. Attached the patch to fix the documentation. I am not sure whether we should put the word "fully" or not. On the side note: In line 813 in Modules/_ssl.c (the same file where my patch fixed the documentation about RAND_egd function): gntype = name-> type; The space between "->" and "type" irritates my eyes. Maybe we can fix this while we fix the documentation? Anyway, this is not really important. I just want to expose it to public and think this does not deserve a dedicated ticket. ---------- assignee: docs@python components: Documentation files: fix_documentation_on_rand_egd_function.patch keywords: patch messages: 195482 nosy: christian.heimes, docs@python, vajrasky priority: normal severity: normal status: open title: Wrong documentation of RAND_egd function in ssl module versions: Python 3.3, Python 3.4 Added file: http://bugs.python.org/file31338/fix_documentation_on_rand_egd_function.pat… _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18768> _______________________________________

3 4

[issue15939] make *.rst files in Doc/ parseable by doctest
by Chris Jerdonek Aug. 17, 2013

Aug. 17, 2013

New submission from Chris Jerdonek: Currently, when trying to parse the *.rst files in the Doc/ folder (i.e. not actually running them but simply generating unittest.TestCase instances from them by passing them to doctest.DocFileSuite()), five files yield errors. This issue is to make it so that all of the *.rst files in our Doc/ folder are at least parseable by doctest without error. I will submit a patch. Below are the errors that currently occur: (1) test fdoc:library/ctypes.rst crashed -- Traceback (most recent call last): ... ValueError: line 55 of the doctest for ctypes.rst has an invalid option: '+WINDOWS' (2) test fdoc:library/doctest.rst crashed -- Traceback (most recent call last): ... ValueError: line 1592 of the docstring for doctest.rst has inconsistent leading whitespace: ' """))' (3) test fdoc:library/multiprocessing.rst crashed -- Traceback (most recent call last): ... ValueError: line 1016 of the docstring for multiprocessing.rst lacks blank after >>>: '>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>' (4) test fdoc:whatsnew/2.4.rst crashed -- Traceback (most recent call last): ... ValueError: line 1422 of the docstring for 2.4.rst lacks blank after >>>: ' >>>"""' (5) test fdoc:whatsnew/2.7.rst crashed -- Traceback (most recent call last): ... ValueError: line 1531 of the docstring for 2.7.rst lacks blank after .: ' ...' ---------- assignee: docs@python components: Documentation messages: 170441 nosy: cjerdonek, docs@python priority: normal severity: normal status: open title: make *.rst files in Doc/ parseable by doctest versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15939> _______________________________________

2 11

[issue18553] os.isatty() is not Unix only
by Ezio Melotti Aug. 17, 2013

Aug. 17, 2013

Ezio Melotti added the comment: Are there tests for this? ---------- components: +Tests keywords: +easy nosy: +ezio.melotti _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18553> _______________________________________

1 0

[issue6916] Remove deprecated items from asynchat
by Ezio Melotti Aug. 17, 2013

Aug. 17, 2013

Ezio Melotti added the comment: What's the status of this? ---------- nosy: +ezio.melotti _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6916> _______________________________________

1 0

[issue15248] Better explain "TypeError: 'tuple' object is not callable"
by Ezio Melotti Aug. 17, 2013

Aug. 17, 2013

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation keywords: +easy nosy: +docs@python versions: +Python 2.7, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15248> _______________________________________

1 0