Mailman 3 May 2010 - docs

[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 specified size as if zero-filled, or increase to the specified size with undefined new content.” http://docs.python.org/library/stdtypes.html#file.truncate ---------- _______________________________________ 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

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 until the process terminates, whichever occurs first. -- Mark Summerfield, Qtrac Ltd, www.qtrac.eu C++, Python, Qt, PyQt - training and consultancy "Programming in Python 3 (Second Edition)" - ISBN 0321680561

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 guessing 0. If -1 is still a valid value, it needs to be described. ---------- assignee: docs@python components: Documentation messages: 106621 nosy: afoglia, docs@python priority: normal severity: normal status: open title: Conflicting default values of parameter to __import__ versions: Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8836> _______________________________________

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. I'm still confused about when anybody would use a relative path with a default scheme and no netloc but I'll leave that decision to you guys. Thanks, Adam ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8818> _______________________________________

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 docs if you like. ---------- _______________________________________ 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: 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? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8818> _______________________________________

1 0