Mailman 3 May 2010 - docs

[issue8865] select.poll is not thread safe
by Christian Schubert June 15, 2010

June 15, 2010

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 … [View More]

2 5

Bug in documentation of os.mkdir()
by Raphael.Mankin＠rbs.com June 12, 2010

June 12, 2010

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 … [View More]

2 1

Small documentation typo
by Charles Reinman June 12, 2010

June 12, 2010

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 June 2, 2010

June 2, 2010

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.… [View More]

2 2

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

May 29, 2010

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

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

May 29, 2010

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

1 0

[issue8840] truncate() semantics changed in 3.1.2
by Pascal Chambon May 29, 2010

May 29, 2010

Pascal Chambon <chambon.pascal(a)gmail.com> added the comment: Good B-) Woudl it be necessary to update the docstrings too ? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8840> _______________________________________

1 0

[issue8840] truncate() semantics changed in 3.1.2
by Antoine Pitrou May 29, 2010

May 29, 2010

Antoine Pitrou <pitrou(a)free.fr> added the comment: I've committed a doc update (a mix of the legacy truncate() doc and Pascal's proposal) in r81594. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8840> _______________________________________

1 0

[issue8840] truncate() semantics changed in 3.1.2
by Antoine Pitrou May 29, 2010

May 29, 2010

Antoine Pitrou <pitrou(a)free.fr> added the comment: How about reusing the documentation of legacy file objects: “Truncate the file’s size. If the optional size argument is present, the file is truncated to (at most) that size. The size defaults to the current position. The current file position is not changed. Note that if a specified size exceeds the file’s current size, the result is platform-dependent: possibilities include that the file may remain unchanged, increase to the … [View More]

1 0

[issue8840] truncate() semantics changed in 3.1.2
by Antoine Pitrou May 29, 2010

May 29, 2010

Changes by Antoine Pitrou <pitrou(a)free.fr>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python title: io.StringIO: truncate+print disabled in 3.1.2 -> truncate() semantics changed in 3.1.2 versions: +Python 2.6, Python 2.7, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8840> _______________________________________

1 0

clarification needed for multiprocessing.Process.join() method
by Mark Summerfield May 28, 2010

May 28, 2010

Hi, The multiprocessing.Process.join() method has a timeout argument but doesn't specify the units. My guess is that the units are seconds. It would be helpful to (1) specify the units and (2) if the units are seconds, specify whether floating-point values are accepted. For example: If timeout is None then the process will block the calling thread until the process terminates. Otherwise the process will block for at most timeout seconds (which can be fractional, e.g., 0.5), or … [View More]

1 0

[issue8836] Conflicting default values of parameter to __import__
by Anthony Foglia May 27, 2010

May 27, 2010

New submission from Anthony Foglia <afoglia(a)gmail.com>: Looking at the documentation for the __import__ builtin, the default value of the level parameter is unclear. Two different values are mentioned. The function signature is written: __import__(name, globals={}, locals={}, fromlist=[], level=-1) But the third paragraph begins: "level specifies whether to use absolute or relative imports. 0 (the default) means only perform absolute imports." So which is it, -1 or 0? I'm … [View More]

2 1

[issue8818] urlsplit and urlparse add extra slash when using scheme
by AdamN May 25, 2010

May 25, 2010

AdamN <adam(a)varud.com> added the comment: I would say right under: urlparse.urlparse(urlstring[, default_scheme[, allow_fragments]])¶ Put: urlstring is a pseudo-url. If the string has a scheme, it will be interpreted as a scheme, followed by a path, querystring and fragment. If it is prepended with a double-slash '//', it will be interpreted as a netloc followed by a path, querystring and fragment. Otherwise, it will be interpreted as a path followed by a querystring and fragment.… [View More]

2 1

[issue8818] urlsplit and urlparse add extra slash when using scheme
by R. David Murray May 25, 2010

May 25, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: How would you expect urlsplit to differentiate between a relative path and a path with a netloc? I would think that most people would expect the semantics the module provides without reading any additional documentation. I certainly did, to the point where when reading your example I didn't even notice that there was any problem report other than the misnaming of the scheme keyword :) You could suggest a clarification to the … [View More]

1 0

[issue8818] urlsplit and urlparse add extra slash when using scheme
by AdamN May 25, 2010

May 25, 2010

AdamN <adam(a)varud.com> added the comment: I think I misspoke before. What I'm referring to is when somebody uses the 'scheme' parameter: urlsplit('cnn.com',scheme='http') Is there no way that we can document that this won't work the way that people think it will? Is it really reasonable for a high-level language to expect people to have read a 100 page RFC in order to know that regular expressions will have to be used for this type of situation? ---------- … [View More]

1 0

[issue8818] urlsplit and urlparse add extra slash when using scheme
by AdamN May 25, 2010

May 25, 2010

AdamN <adam(a)varud.com> added the comment: I appreciate what you're saying but nobody, I guarantee nobody, is using the '//cnn.com' semantics. Anyway, in RFC 3986 in the Syntax Components section, you'll see that the '://' is not part of scheme or netloc. I could imagine urlsplit() failing if the url was not prepended by '//' or 'scheme://', but why would being prepended with nothing cause urlsplit() to presume it's a path? Can we at least document this? ---------- … [View More]

2 1

[issue8818] urlsplit and urlparse add extra slash when using scheme
by AdamN May 25, 2010

May 25, 2010

AdamN <adam(a)varud.com> added the comment: Ok, you're right: >>> urlsplit('cnn.com') SplitResult(scheme='', netloc='', path='cnn.com', query='', fragment='') >>> urlsplit('//cnn.com') SplitResult(scheme='', netloc='cnn.com', path='', query='', fragment='') >>> Although I see that nowhere in the documentation. It seems to me that in the scenario most people are dealing with, where they are getting 'cnn.com' or 'http://cnn.com' but don't know which ahead of … [View More]

2 1

[issue8818] urlsplit and urlparse add extra slash when using scheme
by R. David Murray May 25, 2010

May 25, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: I've added Senthil as nosy to double check me, but my understanding is that the scheme is just the part up to the colon. If you want to have a netloc in the URL, you have to precede it with a '//'. Otherwise there's no netloc. ---------- assignee: docs@python -> nosy: +orsenthil _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8818> _______________________________________

1 0

[issue8818] urlsplit and urlparse add extra slash when using scheme
by AdamN May 25, 2010

May 25, 2010

AdamN <adam(a)varud.com> added the comment: Great, thanks. However urlsplit and urlparse still take what one would expect to be recognized as the netloc and assigns it to the 'path' key. If that is by design perhaps we should at least warn people? ---------- status: closed -> open _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8818> _______________________________________

1 0

[issue8818] urlsplit and urlparse add extra slash when using scheme
by R. David Murray May 25, 2010

May 25, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: The keyword in the code is 'scheme'. I've updated the docs accordingly in r81521 and r81522. ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python, r.david.murray resolution: -> fixed stage: -> committed/rejected status: open -> closed versions: +Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> … [View More]

1 0

[issue8785] findall() and finditer() docs misleading
by Hagen Fürstenau May 22, 2010

May 22, 2010

New submission from Hagen Fürstenau <hfuerstenau(a)gmx.net>: The docs for the RegexpObject methods findall and finditer are misleading: They are said to behave the same way as the respective functions, but in fact the parameter semantics are different. ---------- assignee: docs@python components: Documentation messages: 106286 nosy: docs@python, hagen priority: normal severity: normal status: open title: findall() and finditer() docs misleading versions: Python 2.6, Python 2.7, Python 3.… [View More]

2 1

Incorrect information for multiprocessing.Semaphore
by Mike Hobbs May 21, 2010

May 21, 2010

There's a Note on the documentation for multiprocessing.Semaphore that says that sem_timedwait is unsupported on OS/X and that any timeout argument provided to acquire() will be ignored. I checked the Modules/_multiprocessing/semaphore.c code on the 2.6, 3.0, and 3.1 branches and I see that the module will fallback to sem_timedwait_save() if sem_timedwait is not available. That is, it will not ignore the timeout, but will instead emulate a timed wait using a sleep loop.

2 1

[issue8709] mention explicitly Windows support for os.devnull
by akira May 21, 2010

May 21, 2010

New submission from akira <4kir4.1i(a)gmail.com>: Currently it is not obvious that os.devnull works on Windows. ---------- assignee: docs@python components: Documentation files: doc-os-devnull-windows-r81160.diff keywords: patch messages: 105688 nosy: akira, docs@python priority: normal severity: normal status: open title: mention explicitly Windows support for os.devnull type: feature request Added file: http://bugs.python.org/file17331/doc-os-devnull-windows-r81160.diff … [View More]

4 4

no success in downloading python documentation
by Pietro Perona May 21, 2010

May 21, 2010

I clicked on the download links and got this error message. P. Not Found The requested URL /ftp/python/doc/current/python-2.6.4-docs-pdf-letter.zip was not found on this server. Apache/2.2.9 (Debian) DAV/2 SVN/1.5.1 mod_ssl/2.2.9 OpenSSL/0.9.8g mod_wsgi/2.5 Python/2.5.2 Server at docs.python.org Port 80

2 1

missing documentation on tempfile.NamedTempFile
by Jelte Jansen May 21, 2010

May 21, 2010

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi, in the docs for python 3.1.2, the argument list for tempfile.NamedTemporaryFile() is incomplete on http://docs.python.org/py3k/library/tempfile.html It does not mention the encoding and newline arguments. I haven't checked the other functions there but I assume this is not the only one (nor have I checked other versions, sorry). I found this out because I got quite unexpected errors when not using named parameters, which I know I should, … [View More]

2 1