Mailman 3 May 2018 - docs

[issue22069] TextIOWrapper(newline="\n", line_buffering=True) mistakenly treat \r as a newline
by Antoine Pitrou May 14, 2018

May 14, 2018

Change by Antoine Pitrou <pitrou(a)free.fr>: ---------- nosy: -pitrou _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22069> _______________________________________

1 0

[issue22069] TextIOWrapper(newline="\n", line_buffering=True) mistakenly treat \r as a newline
by miss-islington May 14, 2018

May 14, 2018

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset 9fd5b5fdf851d35a5c1314360119850e86a1fd0d by Miss Islington (bot) in branch '3.6': bpo-22069: Update TextIO documentation (GH-6609) https://github.com/python/cpython/commit/9fd5b5fdf851d35a5c1314360119850e86… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22069> _______________________________________

1 0

[issue22069] TextIOWrapper(newline="\n", line_buffering=True) mistakenly treat \r as a newline
by miss-islington May 14, 2018

May 14, 2018

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset 84fc6c59cf286fc4e6b3a700c6db36ecc2bff92b by Miss Islington (bot) in branch '2.7': bpo-22069: Update TextIO documentation (GH-6609) https://github.com/python/cpython/commit/84fc6c59cf286fc4e6b3a700c6db36ecc2… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22069> _______________________________________

1 0

[issue22069] TextIOWrapper(newline="\n", line_buffering=True) mistakenly treat \r as a newline
by miss-islington May 14, 2018

May 14, 2018

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset 050e041bf7e5260013a74c75a05a3f0fb16447ec by Miss Islington (bot) in branch '3.7': bpo-22069: Update TextIO documentation (GH-6609) https://github.com/python/cpython/commit/050e041bf7e5260013a74c75a05a3f0fb1… ---------- nosy: +miss-islington _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22069> _______________________________________

1 0

[issue22069] TextIOWrapper(newline="\n", line_buffering=True) mistakenly treat \r as a newline
by miss-islington May 14, 2018

May 14, 2018

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +6487 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22069> _______________________________________

1 0

[issue22069] TextIOWrapper(newline="\n", line_buffering=True) mistakenly treat \r as a newline
by miss-islington May 14, 2018

May 14, 2018

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +6486 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22069> _______________________________________

1 0

[issue22069] TextIOWrapper(newline="\n", line_buffering=True) mistakenly treat \r as a newline
by miss-islington May 14, 2018

May 14, 2018

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +6485 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22069> _______________________________________

1 0

[issue22069] TextIOWrapper(newline="\n", line_buffering=True) mistakenly treat \r as a newline
by Mariatta Wijaya May 14, 2018

May 14, 2018

Mariatta Wijaya <mariatta.wijaya(a)gmail.com> added the comment: New changeset 7ffd4c58fae08b29259eebd6cbcd2287820b14e8 by Mariatta (Elena Oat) in branch 'master': bpo-22069: Update TextIO documentation (GH-6609) https://github.com/python/cpython/commit/7ffd4c58fae08b29259eebd6cbcd228782… ---------- nosy: +Mariatta _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22069> _______________________________________

1 0

[issue33479] Document tkinter and threads
by Ivan Pozdeev May 14, 2018

May 14, 2018

Ivan Pozdeev <ivan_pozdeev(a)mail.ru> added the comment: I was composing a letter to python-dev with all I know of how tkinter works with regard to threads and Tcl, and the fixing plans so that we're all on the same page if you wish to participate. I'm no longer sure if it belongs in the mailing list so see it in the attachment. The plan I have for fixing the documentation is there towards the end. It includes what you suggested but is more detailed. I'll recite it below: --- * Document the current behaviour by rewriting https://docs.python.org/3/library/tkinter.html . Since I've recently learned Tkinter, I can say which critical information is missing and which existing one proved useless. Principles: * include fundamental information critical to understand the module's behaviour * concentrate on reference documentation for the module because it's more important to have than a user guide ( https://meta.serverfault.com/questions/8934/what-to-do-with-questions-when-… ) * split off/drop anything unrelated to the above two Resulting scheme: 0. Intro: +supported Tcl/Tk versions and the two flavors; the fact that Tkinter adds its own logic, and the Tkinter doc concentrates on that logic and refers to Tcl/Tk docs for details that are taken from there without changes. * Move external links section to be bottom. 1. Architecture. "Unlike most other GUI toolkits, Tcl/Tk consists of a few separate modules with a clear distinction between them, and this is non-transparect to the user:..." Base on https://docs.python.org/3/library/tkinter.html#how-tk-and-tkinter-are-relat… , but focus on what implements what rather than what _calls_ what; drop Xlib entry (transparent implementation detail, not required for understanding). 2. Threading model. The above-described general idea and user-visible limitations what can be called where and when. (the letter has details that this refers to, too long to recite) 3. References for `tkinter`, `tkinter.Tk()`, `_tkinter.Tkapp` (public interface only -- `call()` at least). Mention which functions cannot be called from other threads. Do not mention the two issue33257 bugs. * Move widget reference to another page. * Drop Python-Tcl mappings unless the reference sections need them as supplemental reference. * Drop tutorial: too primitive to be useful. Move tutorials to another page like https://docs.python.org/3/library/logging.html does. * Drop https://docs.python.org/3/library/tk.html -- proved hard to find. Make https://docs.python.org/3/library/tkinter.html the head page instead. * Discuss which of the described behaviour is as intended and which is a bug. Proceed with fixing. ---------- assignee: -> docs@python components: +Documentation nosy: +Ivan.Pozdeev, docs@python Added file: https://bugs.python.org/file47586/[Python-Dev] Tkinter threading model description and fix plan.eml _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33479> _______________________________________

1 0

[issue33488] github pull request template does not satisfy markdownlint
by Eitan Adler May 14, 2018

May 14, 2018

New submission from Eitan Adler <lists(a)eitanadler.com>: markdownlint is, as the name implies, a tool for linting markdown files. The current template has the following lint warnings: ``` ./.github/PULL_REQUEST_TEMPLATE.md:8: MD031 Fenced code blocks should be surrounded by blank lines ./.github/PULL_REQUEST_TEMPLATE.md:10: MD031 Fenced code blocks should be surrounded by blank lines ./.github/PULL_REQUEST_TEMPLATE.md:19: MD031 Fenced code blocks should be surrounded by blank lines ./.github/PULL_REQUEST_TEMPLATE.md:21: MD031 Fenced code blocks should be surrounded by blank lines ``` These should be fixed ---------- assignee: docs@python components: Documentation messages: 316484 nosy: docs@python, eitan.adler priority: normal severity: normal status: open title: github pull request template does not satisfy markdownlint type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33488> _______________________________________

2 5