Mailman 3 August 2016 - docs

[issue23542] Update PEP 476 for using urllib2.build_opener()
by Shakeel Mohamed Aug. 6, 2016

Aug. 6, 2016

New submission from Shakeel Mohamed: In the "Opting Out" section of PEP 476, there's a workaround for disabling SSL cert verification. I think it would be worth updating the section to include the following workaround when using urllib2.build_opener(), like so: unverified_ssl_handler = urllib2.HTTPSHandler(context=ssl._create_unverified_context()) opener = urllib2.build_opener(unverified_ssl_handler) ---------- assignee: docs@python components: Documentation messages: 236835 nosy: Shakeel Mohamed, docs@python priority: normal severity: normal status: open title: Update PEP 476 for using urllib2.build_opener() versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23542> _______________________________________

2 3

[issue23105] os.O_SHLOCK and os.O_EXLOCK are not available on Linux
by Berker Peksag Aug. 6, 2016

Aug. 6, 2016

Changes by Berker Peksag <berker.peksag(a)gmail.com>: ---------- keywords: +easy stage: -> needs patch versions: +Python 3.6 -Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23105> _______________________________________

1 0

Re: [docs] UUID docs should say how to get "standard form" (issue 26267)
by ammar＠ammaraskar.com Aug. 6, 2016

Aug. 6, 2016

https://bugs.python.org/review/26267/diff/18046/Doc/library/uuid.rst File Doc/library/uuid.rst (right): https://bugs.python.org/review/26267/diff/18046/Doc/library/uuid.rst#newcod… Doc/library/uuid.rst:56: .. describe:: uuid1 == uuid2 On 2016/08/03 10:09:25, berkerpeksag wrote: > Same as above. See datetime or decimal documentations for an example of how to > document comparison operations. So datetime takes the approach of documenting operators in a table (presumably because it has a lot of ops) https://docs.python.org/3/library/datetime.html#datetime.date.day decimal seems to do it in this way https://docs.python.org/3/library/decimal.html#decimal.Decimal.compare The style I used here is from https://docs.python.org/3/library/stdtypes.html#set but now that I look at it, within the stdtypes there's also the datetime style operator documentation for numbers. https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-com… Is there a preferred style for documenting operators? Which one should I use here? (apparently I forgot to click the publish button on Rietveld, I wrote this day before yesterday) https://bugs.python.org/review/26267/

1 0

[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