Mailman 3 October 2016 - docs

Cant Access Python 3.6 Documentation
by Vincent Carlos 06 Oct '16

06 Oct '16

I want to download python 3.6 documentation but it shows “404 Not Found nginx”. I hope it will be fixed soon. Thanks

1 0

[issue27998] Bytes paths now are supported in os.scandir() on Windows
by Serhiy Storchaka 06 Oct '16

06 Oct '16

Serhiy Storchaka added the comment: Tests are passed on Windows. Now we need to document that bytes paths are supported in os.scandir() on Windows since 3.6. ---------- assignee: serhiy.storchaka -> docs@python components: +Documentation -Extension Modules nosy: +docs@python stage: patch review -> needs patch versions: +Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27998> _______________________________________

1 0

include structmember.h in Python.h (issue 2897)
by storchaka+cpython＠gmail.com 06 Oct '16

06 Oct '16

http://bugs.python.org/review/2897/diff/18779/Doc/extending/newtypes.rst File Doc/extending/newtypes.rst (right): http://bugs.python.org/review/2897/diff/18779/Doc/extending/newtypes.rst#ne… Doc/extending/newtypes.rst:1155: (defined in the :file:`structmember.h` header), the attribute is read-only; otherwise Too long line. http://bugs.python.org/review/2897/diff/18779/Doc/extending/newtypes.rst#ne… Doc/extending/newtypes.rst:1156: it should be set to `0`. ``0`` http://bugs.python.org/review/2897/

1 0

[issue2897] Deprecate structmember.h
by Alexander Belopolsky 06 Oct '16

06 Oct '16

Alexander Belopolsky added the comment: I am attaching a proposed doc patch for Python 3.5+. For 2.7 we should probably just add a versionchanged note explaining "restricted mode" has been deprecated in Python 2.3. ---------- Added file: http://bugs.python.org/file44976/issue2897-docs-3x.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue2897> _______________________________________

1 0

[issue28362] Deprecation warning doesn't stand out enough
by Mariatta Wijaya 05 Oct '16

05 Oct '16

New submission from Mariatta Wijaya: In documentation for python 3.3, the deprecation warning is rendered in a red box which is more eye-catching. eg https://docs.python.org/3.3/library/imp.html?highlight=imp#module-imp But since python 3.4 onwards, seems like the red box disappears and the deprecation warning message no longer stands out. for example https://docs.python.org/3.4/library/imp.html?highlight=imp#module-imp I kinda prefer like the older style (with the red box). ---------- assignee: docs@python components: Documentation messages: 278103 nosy: Mariatta, docs@python priority: normal severity: normal status: open title: Deprecation warning doesn't stand out enough versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28362> _______________________________________

4 3

Bug on Import statement
by Lidia Martinez 05 Oct '16

05 Oct '16

The link to the article on the import statement: "From a file system perspective, packages are directories and modules are files. The original specification for packages <http://www.python.org/doc/essays/packages.html> " Does not work. Thanks -- Lidia

1 1

Re: [docs] "CPython implementation detail:" is removed when contents is translated (issue 28331)
by songofacandy＠gmail.com 05 Oct '16

05 Oct '16

Reviewers: Mariatta, Message: Thanks. http://bugs.python.org/review/28331/diff/18722/Doc/tools/extensions/pyspeci… File Doc/tools/extensions/pyspecific.py (right): http://bugs.python.org/review/28331/diff/18722/Doc/tools/extensions/pyspeci… Doc/tools/extensions/pyspecific.py:24: import sphinx.locale On 2016/10/05 07:58:24, Mariatta wrote: > seems like it's more of a common pattern to do: > > from sphinx.locale import translators > > and then line 112 can become: > > label = translators['sphinx'].gettext(self.label_text) > > but maybe I'm too nitpicky :) Done. http://bugs.python.org/review/28331/diff/18722/Doc/tools/extensions/pyspeci… Doc/tools/extensions/pyspecific.py:124: pnode[0].replace_self(nodes.paragraph('', '', content, translatable=False)) On 2016/10/05 07:58:24, Mariatta wrote: > The line is kinda long. > Do you think it could be broken using continuation line? > > Thanks. Done. Please review this at http://bugs.python.org/review/28331/ Affected files: Doc/tools/extensions/pyspecific.py Doc/tools/templates/dummy.html diff -r 02eb35b79af0 Doc/tools/extensions/pyspecific.py --- a/Doc/tools/extensions/pyspecific.py Wed Sep 28 21:57:25 2016 -0400 +++ b/Doc/tools/extensions/pyspecific.py Sat Oct 01 22:25:22 2016 +0900 @@ -21,6 +21,7 @@ from sphinx import addnodes from sphinx.builders import Builder +import sphinx.locale from sphinx.util.nodes import split_explicit_title from sphinx.util.compat import Directive from sphinx.writers.html import HTMLTranslator @@ -103,16 +104,24 @@ optional_arguments = 1 final_argument_whitespace = True + # This text is copied to templates/dummy.html + label_text = 'CPython implementation detail:' + def run(self): pnode = nodes.compound(classes=['impl-detail']) + label = sphinx.locale.translators['sphinx'].gettext(self.label_text) content = self.content - add_text = nodes.strong('CPython implementation detail:', - 'CPython implementation detail:') + add_text = nodes.strong(label, label) if self.arguments: n, m = self.state.inline_text(self.arguments[0], self.lineno) pnode.append(nodes.paragraph('', '', *(n + m))) self.state.nested_parse(content, self.content_offset, pnode) if pnode.children and isinstance(pnode[0], nodes.paragraph): + content = nodes.inline(pnode[0].rawsource, translatable=True) + content.source = pnode[0].source + content.line = pnode[0].line + content += pnode[0].children + pnode[0].replace_self(nodes.paragraph('', '', content, translatable=False)) pnode[0].insert(0, add_text) pnode[0].insert(1, nodes.Text(' ')) else: diff -r 02eb35b79af0 Doc/tools/templates/dummy.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Doc/tools/templates/dummy.html Sat Oct 01 22:25:22 2016 +0900 @@ -0,0 +1,6 @@ +This file is not an actual template, but used to add some +texts in extensions to sphinx.pot file. + +In extensions/pyspecific.py: + +{% trans %}CPython implementation detail:{% endtrans %}

1 0

"CPython implementation detail:" is removed when contents is translated (issue 28331)
by mariatta.wijaya＠gmail.com 05 Oct '16

05 Oct '16

http://bugs.python.org/review/28331/diff/18722/Doc/tools/extensions/pyspeci… File Doc/tools/extensions/pyspecific.py (right): http://bugs.python.org/review/28331/diff/18722/Doc/tools/extensions/pyspeci… Doc/tools/extensions/pyspecific.py:24: import sphinx.locale seems like it's more of a common pattern to do: from sphinx.locale import translators and then line 112 can become: label = translators['sphinx'].gettext(self.label_text) but maybe I'm too nitpicky :) http://bugs.python.org/review/28331/diff/18722/Doc/tools/extensions/pyspeci… Doc/tools/extensions/pyspecific.py:124: pnode[0].replace_self(nodes.paragraph('', '', content, translatable=False)) The line is kinda long. Do you think it could be broken using continuation line? Thanks. http://bugs.python.org/review/28331/

1 0

incorrect "in ?" output in 'divide' example at "Defining Clean-up Actions" in tutorial (issue 28315)
by mariatta.wijaya＠gmail.com 05 Oct '16

05 Oct '16

Thanks for the patches, Jaysinh. In some of these patches, the word 'in' is missing. For example, it should have been ... line 1, in <module> instead, I'm seeing ... line 1, <module> Thanks :) http://bugs.python.org/review/28315/diff/18761/Doc/library/ctypes.rst File Doc/library/ctypes.rst (right): http://bugs.python.org/review/28315/diff/18761/Doc/library/ctypes.rst#newco… Doc/library/ctypes.rst:100: File "<stdin>", line 1, <module> The word 'in' is missing, eg File "<stdin>", line 1, in <module> http://bugs.python.org/review/28315/diff/18762/Doc/library/ctypes.rst File Doc/library/ctypes.rst (right): http://bugs.python.org/review/28315/diff/18762/Doc/library/ctypes.rst#newco… Doc/library/ctypes.rst:90: File "<stdin>", line 1, <module> Should be in <module> http://bugs.python.org/review/28315/diff/18763/Doc/library/ctypes.rst File Doc/library/ctypes.rst (right): http://bugs.python.org/review/28315/diff/18763/Doc/library/ctypes.rst#newco… Doc/library/ctypes.rst:100: File "<stdin>", line 1, <module> It should say ", in <module>" http://bugs.python.org/review/28315/

1 0

[issue28348] Doc typo in asyncio.Task
by Poren Chiang 05 Oct '16

05 Oct '16

New submission from Poren Chiang: Version: Latest (v3.5.2) Affected module: asyncio (section 18.5) Problem: Under section 18.5.3.5. "Task", The word "completion" is misspelled "completition". > A task is responsible for executing a coroutine object in an event loop. If the wrapped coroutine yields from a future, the task suspends the execution of the wrapped coroutine and waits for the **completition** of the future. When the future is done, the execution of the wrapped coroutine restarts with the result or the exception of the future. Possible fixes: Replace "completition" with "completion". Reference: [1] https://docs.python.org/3/library/asyncio-task.html#task ---------- assignee: docs@python components: Documentation messages: 277962 nosy: RSChiang, docs@python priority: normal severity: normal status: open title: Doc typo in asyncio.Task versions: Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28348> _______________________________________

4 4