Mailman 3 August 2016 - docs

[issue8243] curses writing to window's bottom right position raises: `_curses.error: addstr() returned ERR'
by Ned Deily Aug. 5, 2016

Aug. 5, 2016

Ned Deily added the comment: See also Issue27693 which documents a similar issue using curses.textpad. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8243> _______________________________________

1 0

[issue27689] Add documentation for typing.Generator
by Michael Lee Aug. 5, 2016

Aug. 5, 2016

New submission from Michael Lee: This patch adds (previously missing) documentation for `typing.Generator`. ---------- assignee: docs@python components: Documentation files: document-generators.patch keywords: patch messages: 272010 nosy: docs@python, gvanrossum, michael0x2a priority: normal severity: normal status: open title: Add documentation for typing.Generator versions: Python 3.5, Python 3.6 Added file: http://bugs.python.org/file44013/document-generators.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27689> _______________________________________

3 6

Redundancy in Docs
by Thomas Roethenbacher Aug. 5, 2016

Aug. 5, 2016

1 0

Re: [docs] Add documentation for typing.Generator (issue 27689)
by guido＠python.org Aug. 5, 2016

Aug. 5, 2016

http://bugs.python.org/review/27689/diff/18074/Doc/library/typing.rst File Doc/library/typing.rst (right): http://bugs.python.org/review/27689/diff/18074/Doc/library/typing.rst#newco… Doc/library/typing.rst:474: while sent is not None: On 2016/08/05 20:15:15, levkivskyi wrote: > One more comment: One might be confused why send type is float and not > Optional[float], maybe you could add an explanation that one anyway can only > send None as a first value, so that Optional is redundant. Hm, that initial None is not given to yield (it just starts execution of the generator body). This code really needs Optional[float] in the signature, if that's used as the sentinel (once we have strict optional checking). http://bugs.python.org/review/27689/

1 0

Add documentation for typing.Generator (issue 27689)
by levkivskyi＠gmail.com Aug. 5, 2016

Aug. 5, 2016

http://bugs.python.org/review/27689/diff/18074/Doc/library/typing.rst File Doc/library/typing.rst (right): http://bugs.python.org/review/27689/diff/18074/Doc/library/typing.rst#newco… Doc/library/typing.rst:474: while sent is not None: One more comment: One might be confused why send type is float and not Optional[float], maybe you could add an explanation that one anyway can only send None as a first value, so that Optional is redundant. http://bugs.python.org/review/27689/

1 0

Re: [docs] Expand documentation about Any in the typing module (issue 27688)
by stephane＠wirtel.be Aug. 5, 2016

Aug. 5, 2016

it's ok for me, but I am not an expert with the type hinting of 3.5. http://bugs.python.org/review/27688/

1 0

[issue20004] csv.DictReader classic class has a property with setter
by Mathieu Dupuy Aug. 5, 2016

Aug. 5, 2016

Mathieu Dupuy added the comment: The comment is still present in python 3 sources at the moment. Shouldn't we remove it in python 3 ? ---------- nosy: +deronnax _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20004> _______________________________________

1 0

[issue26462] Patch to enhance literal block language declaration
by Julien Aug. 5, 2016

Aug. 5, 2016

New submission from Julien: Hi, As I don't like warnings, and sphinx-doc was verbose about "Could not parse literal_block as "python3". highlighting skipped.", I fixed most of them. Bonus: It's graphically better, as an example the XML block here: https://docs.python.org/3.5/library/pyexpat.html is now nicely colored: http://www.afpy.org/doc/python/3.5/library/pyexpat.html ---------- assignee: docs@python components: Documentation files: literal_blocks_languages.patch keywords: patch messages: 261035 nosy: docs@python, sizeof priority: normal severity: normal status: open title: Patch to enhance literal block language declaration type: enhancement versions: Python 3.5 Added file: http://bugs.python.org/file42050/literal_blocks_languages.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26462> _______________________________________

8 34

Re: [docs] Expand documentation about Any in the typing module (issue 27688)
by levkivskyi＠gmail.com Aug. 5, 2016

Aug. 5, 2016

Two minor comments. http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst File Doc/library/typing.rst (right): http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:222: # The static type checker treats the above Maybe "A static type checker" here too? http://bugs.python.org/review/27688/diff/18064/Doc/library/typing.rst#newco… Doc/library/typing.rst:236: That means when the type of a value is :class:`object`, the type checker will same here "a type checker" http://bugs.python.org/review/27688/

1 0