Mailman 3 May 2010 - docs

[issue8562] hasattr(open, 'newlines') example gives incorrect results from PEP0278
by AdamN 02 Aug '10

02 Aug '10

New submission from AdamN <adam(a)varud.com>: This bug from the Ubuntu list is being moved here: https://bugs.launchpad.net/ubuntu/+source/python-defaults/+bug/570737 Newlines support is enabled on Ubuntu but the example from: http://www.python.org/dev/peps/pep-0278/ Does not give the correct results (of True): if hasattr(open, 'newlines'): print 'We have universal newline support' I don't know if this is a documentation problem or whether there is another attr that matters here. ---------- assignee: docs@python components: Documentation, Windows messages: 104454 nosy: adamnelson, docs@python priority: normal severity: normal status: open title: hasattr(open,'newlines') example gives incorrect results from PEP0278 type: behavior versions: Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8562> _______________________________________

4 3

[issue8602] documentation of bz2 module mildly erroneous
by Matt Wartell 01 Aug '10

01 Aug '10

New submission from Matt Wartell <matt.wartell+pt(a)gmail.com>: This is related to http://bugs.python.org/issue8601 "bz2.BZ2File should support "with" protocol per PEP 343" The documentation at http://docs.python.org/library/bz2.html states: "This module provides a comprehensive interface for the bz2 compression library. It implements a complete file interface,..." although bz2.BZ2File does not support the __enter__ and __exit__ methods so arguably doesn't implement the "complete file interface". If issue8601 is declined then the documentation should probably note this exception. ---------- assignee: docs@python components: Documentation messages: 104818 nosy: Matt.Wartell, docs@python priority: normal severity: normal status: open title: documentation of bz2 module mildly erroneous type: behavior versions: Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8602> _______________________________________

3 5

[issue8638] Remove suggestion for name mangling from the tutorial
by Lucian Ursu 31 Jul '10

31 Jul '10

New submission from Lucian Ursu <lucian_ursu(a)yahoo.com>: I suggest that name mangling should not be recommended as a way of having private attributes. Instead, one underscore should be suggested as a signal that the attribute is private. This suggestion comes after discussing with some of the helpers from #python. Basically, they said that name mangling should never be used, so it would be appropriate to remove this recommendation from the tutorial. ---------- assignee: docs@python components: Documentation messages: 105161 nosy: LucianU, docs@python priority: normal severity: normal status: open title: Remove suggestion for name mangling from the tutorial type: feature request versions: Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8638> _______________________________________

8 8

[issue8564] Update documentation on doctest/unittest2 integration
by Peter Fein 10 Jul '10

10 Jul '10

New submission from Peter Fein <pfein(a)pobox.com>: The documentation on integrating doctests in a file of unittests is confusing and out of date. This patch updates the documentation to use unittest2 test discovery. ---------- assignee: docs@python components: Documentation files: doctest_unittest_integration_doc.diff keywords: patch messages: 104468 nosy: docs@python, pfein priority: normal severity: normal status: open title: Update documentation on doctest/unittest2 integration versions: Python 2.7, Python 3.3 Added file: http://bugs.python.org/file17123/doctest_unittest_integration_doc.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8564> _______________________________________

5 6

[issue8653] urlparse.urlparse/urlsplit doc missing
by Dave Abrahams 28 Jun '10

28 Jun '10

New submission from Dave Abrahams <dave(a)boostpro.com>: The docstrings for these functions don't explain the 'scheme' parameter. Even renaming it to default_scheme would help. ---------- assignee: docs@python components: Documentation messages: 105221 nosy: dabrahams, docs@python priority: normal severity: normal status: open title: urlparse.urlparse/urlsplit doc missing _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8653> _______________________________________

5 8

[issue8865] select.poll is not thread safe
by Christian Schubert 15 Jun '10

15 Jun '10

New submission from Christian Schubert <bugs(a)apexo.de>: invoking select.poll.poll() concurrently from multiple threads frequently yields garbage in one thread: while poll_poll in thread 1 is parsing its result, another thread 2 calling poll may overwrite revents; assuming poll_result was 1 in thread 1 and thread 2 managed to clear all revents before thread 1 started scanning ufds, thread 1 would iterate straight through all ufds, past its bounds (no bound checks there), and return the first out-of-bounds entry that happens to have revents != 0 this issue needs at least documentation (although bounds-checking to prevent garbage in the result wouldn't hurt) also, since there doesn't seem to be any locking w/ regards to ufds, it might be possible to corrupt python's heap, by concurrently invoking poll_register and poll_poll. poll_register could move the ufds array to another location while resizing it and poll_poll would subsequently overwrite memory that is not allocated anymore or allocated by someone else (did not test that) python 2.5.5 ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 106815 nosy: apexo, docs@python priority: normal severity: normal status: open title: select.poll is not thread safe type: behavior versions: Python 2.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8865> _______________________________________

2 5

Bug in documentation of os.mkdir()
by Raphael.Mankin＠rbs.com 12 Jun '10

12 Jun '10

The web page http://docs.python.org/library/os.html#file-object-creation does not specify what os.mkdir() does if the directory already exists. Makedirs() does, but mkdir() does not. *********************************************************************************** The Royal Bank of Scotland plc. Registered in Scotland No 90312. Registered Office: 36 St Andrew Square, Edinburgh EH2 2YB. Authorised and regulated by the Financial Services Authority. The Royal Bank of Scotland N.V. is authorised and regulated by the De Nederlandsche Bank and has its seat at Amsterdam, the Netherlands, and is registered in the Commercial Register under number 33002587. Registered Office: Gustav Mahlerlaan 10, Amsterdam, The Netherlands. The Royal Bank of Scotland N.V. and The Royal Bank of Scotland plc are authorised to act as agent for each other in certain jurisdictions. This e-mail message is confidential and for use by the addressee only. If the message is received by anyone other than the addressee, please return the message to the sender by replying to it and then delete the message from your computer. Internet e-mails are not necessarily secure. The Royal Bank of Scotland plc and The Royal Bank of Scotland N.V. including its affiliates ("RBS group") does not accept responsibility for changes made to this message after it was sent. Whilst all reasonable care has been taken to avoid the transmission of viruses, it is the responsibility of the recipient to ensure that the onward transmission, opening or use of this message and any attachments will not adversely affect its systems or data. No responsibility is accepted by the RBS group in this regard and the recipient should carry out such virus and other checks as it considers appropriate. Visit our website at www.rbs.com ***********************************************************************************

2 1

Small documentation typo
by Charles Reinman 12 Jun '10

12 Jun '10

In the sentence: “Private” instance variables that cannot be accessed except from inside an > object, don’t exist in Python. The comma is extraneous and should be removed. http://docs.python.org/tutorial/classes.html#private-variables Thanks, - Charles

2 1

[issue8788] urllib.urlencode documentation unclear on doseq
by Jeroen Habraken 01 Jun '10

01 Jun '10

New submission from Jeroen Habraken <vexocide(a)gmail.com>: The urllib.urlencode documentation is unclear with regard to the 'doseq' option. In my opinion it does not clearly state what its functionality is. ---------- assignee: docs@python components: Documentation messages: 106311 nosy: VeXocide, docs@python priority: normal severity: normal status: open title: urllib.urlencode documentation unclear on doseq _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8788> _______________________________________

2 2

[issue8481] doc: ctypes no need to explicitly allocate writable memory with Structure
by Éric Araujo 29 May '10

29 May '10

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- assignee: flox -> theller nosy: +theller -flox priority: -> normal _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8481> _______________________________________

1 0