Mailman 3 August 2016 - docs

[issue18548] In unittest doc change WidgetTestCase to SimpleWidgetTestCase in suite()
by py.user Aug. 6, 2016

Aug. 6, 2016

New submission from py.user: http://docs.python.org/3/library/unittest.html#organizing-test-code """ def suite(): suite = unittest.TestSuite() suite.addTest(WidgetTestCase('test_default_size')) suite.addTest(WidgetTestCase('test_resize')) return suite """ ---------- assignee: docs@python components: Documentation files: issue.diff keywords: patch messages: 193667 nosy: docs@python, py.user priority: normal severity: normal status: open title: In unittest doc change WidgetTestCase to SimpleWidgetTestCase in suite() type: enhancement versions: Python 3.4 Added file: http://bugs.python.org/file31029/issue.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18548> _______________________________________

5 4

[issue15639] csv.Error description is incorrectly broad
by Xavier Morel Aug. 5, 2016

Aug. 5, 2016

New submission from Xavier Morel: In both Python 2.7 and Python 3.x, csv.Error is documented as: Raised by any of the functions when an error is detected. As far as I can tell from using the module and looking at the code, this is completely incorrect. There is actually a single instance of csv.Error being used: the instantiation of csv.Dialect (which converts TypeError raised from _csv._Dialect() into csv.Error, a comment notes that this is "for compatibility with py 2.3"). And the only way to hit that code paths seems to be subclassing `Dialect` and putting incorrect values in the various attributes (providing them to `csv.reader` raises a TypeError). I believe the documentation to csv.Error should be changed to: 1. Mark it as effectively deprecated 2. Indicate that the only situation in which it it may be raised is when initializing a subclass of csv.Dialect ---------- assignee: docs@python components: Documentation messages: 168096 nosy: docs@python, xmorel priority: normal severity: normal status: open title: csv.Error description is incorrectly broad versions: Python 2.7, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15639> _______________________________________

2 2

[issue14594] document imp.load_dynamic()
by Stefan Behnel Aug. 5, 2016

Aug. 5, 2016

New submission from Stefan Behnel <scoder(a)users.sourceforge.net>: The imp.load_dynamic() function is used by third party code (e.g. Cython's pyximport) but is not currently documented. http://docs.python.org/dev/library/imp.html The latest changes to the import mechanism suggest that it should better be documented to give a hint that users can rely on it. ---------- assignee: docs@python components: Documentation messages: 158412 nosy: docs@python, scoder priority: normal severity: normal status: open title: document imp.load_dynamic() type: behavior versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14594> _______________________________________

6 6

[issue3216] Scarce msilib documentation
by Berker Peksag Aug. 5, 2016

Aug. 5, 2016

Berker Peksag added the comment: All obvious bugs have already been fixed. ---------- nosy: +berker.peksag resolution: -> fixed stage: -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue3216> _______________________________________

1 0

[issue12276] 3.x ignores sys.tracebacklimit=0
by Berker Peksag Aug. 5, 2016

Aug. 5, 2016

Changes by Berker Peksag <berker.peksag(a)gmail.com>: ---------- keywords: +easy stage: -> needs patch type: -> behavior versions: +Python 3.5, Python 3.6 -Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12276> _______________________________________

1 0

[issue27242] Clarify the use cases of NotImplemented in the docs
by Emanuel Barry Aug. 5, 2016

Aug. 5, 2016

New submission from Emanuel Barry: The NotImplemented docs aren't explicit enough when it comes to where it can/should be used. Patch attached. ---------- assignee: docs@python components: Documentation files: NotImplemented_wording_1.patch keywords: patch messages: 267543 nosy: docs@python, ebarry priority: normal severity: normal stage: patch review status: open title: Clarify the use cases of NotImplemented in the docs type: enhancement versions: Python 3.6 Added file: http://bugs.python.org/file43263/NotImplemented_wording_1.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27242> _______________________________________

7 17

[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