Mailman 3 September 2010 - docs

[issue9956] memoryview type documentation lacks versionadded
by Andreas Stührk Sept. 27, 2010

Sept. 27, 2010

New submission from Andreas Stührk <andy-python(a)hammerhartes.de>: Title says all, attached is a patch against trunk (2.7). I'm not familiar with what version is correct for the Python 3 documentation. ---------- assignee: docs@python components: Documentation files: stdtypes-memoryview-2.7.patch keywords: patch messages: 117432 nosy: Trundle, docs@python, pitrou priority: normal severity: normal status: open title: memoryview type documentation lacks versionadded versions: Python 2.7, Python 3.1 Added file: http://bugs.python.org/file19025/stdtypes-memoryview-2.7.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9956> _______________________________________

3 2

[issue9934] Python Docs Typo
by Retro Sept. 27, 2010

Sept. 27, 2010

New submission from Retro <vinetouu(a)gmail.com>: http://docs.python.org/distutils/sourcedist.html#manifest-related-options Please visit the above link and note the typo in: -o is a sortcut for --manifest-only. Should be: -o is a shortcut for --manifest-only. The word "sortcut" is a typo. Please fix it to "shortcut". Thanks. ---------- assignee: docs@python components: Documentation messages: 117248 nosy: Retro, docs@python priority: normal severity: normal status: open title: Python Docs Typo versions: Python 2.5, 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/issue9934> _______________________________________

4 4

[issue1665333] Documentation missing for OptionGroup class in optparse
by Sandro Tosi Sept. 27, 2010

Sept. 27, 2010

Sandro Tosi <sandro.tosi(a)gmail.com> added the comment: I will work on it, it noone objects. Cheers, Sandro ---------- nosy: +sandro.tosi _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1665333> _______________________________________

1 0

master list of file properties
by John Hensby Sept. 26, 2010

Sept. 26, 2010

The TextIOWrapper has a name attribute, but that fact not easily discovered because name is mentioned only under 15.2.3. *Raw* File I/O. Would it be a good idea to make a list of all the properties that are possessed by most normal files, and put it where the user-in-a-hurry can find it easily. Linking to it from the builtin open function may help too. Sorry I don't have time to do it myself. -- jh

1 0

[issue9562] Slightly misleading wording in documentation of dict.update
by Mitchell Model Sept. 25, 2010

Sept. 25, 2010

New submission from Mitchell Model <mlm(a)acm.org>: The documentation of dict.update says that it "accepts either another dictionary object or an iterable of key/value pairs (as a tuple or other iterable of length two)" The parenthesized phrase is slightly misleading in that it could be interpreted as requiring the argument to be an iterable of length two, whereas the argument should be an iterable of iterables of length 2 (if not a dictionary). Suggest rewriting in the plural: (as tuples or other iterables of length two) ---------- assignee: docs@python components: Documentation messages: 113557 nosy: MLModel, docs@python priority: normal severity: normal status: open title: Slightly misleading wording in documentation of dict.update versions: Python 2.6, Python 2.7, Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9562> _______________________________________

5 4

[issue6634] sys.exit() called from threads other than the main one: undocumented behaviour
by Terry J. Reedy Sept. 25, 2010

Sept. 25, 2010

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I do not use threads so I cannot comment on the technical issue. Since the current behavior is not clearly a bug, I do not think a change would or know that it should be applied to 2.7/3.1. So I suggest that you both 1. Suggest a doc patch on this issue. That should not controversial and might be quickly applied. 2. Submit a separate feature request issue to change behavior in 3.2 or beyond. You could request that the change be backported to 2.7 and try to make a case for doing so. Unless you can quickly write a tested patch, such a change in unlikely to make it into 3.2 anyway. And even then, no guarantee. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6634> _______________________________________

1 0

[issue1865] Document bytes alias for 2.7
by Georg Brandl Sept. 25, 2010

Sept. 25, 2010

Georg Brandl <georg(a)python.org> added the comment: Fixed in r85010. ---------- resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1865> _______________________________________

1 0

Link Error
by Sweet Toother Sept. 25, 2010

Sept. 25, 2010

Hi, just want to let you all know that the links to download all the documents from the 2.6.1 download page (http://docs.python.org/release/2.6.1/download.html) are incorrect. They link to the doc/current subdir of the FTP site, instead of the doc/2.6.1 subdir. BTW, I navigated to the 2.6.1 download page from the Versions page ( http://www.python.org/doc/versions/ ). Take care.

2 1

possible error on http://docs.python.org/library/struct.html
by Michael Shannon Sept. 25, 2010

Sept. 25, 2010

I was trying the example 7.3.2.3 - and when I tried: >>> unpack( 'hhl', '\x00\x01\x00\x02\x00\x00\x00\x03') I got the following error: Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: 'str' does not support the buffer interface However, if I declared the second string to be a byte array: >>> unpack( 'hhl', b'\x00\x01\x00\x02\x00\x00\x00\x03') (256, 512, 50331648) ... it works :-) I'm running: aMac:~ mike$ python3 -V Python 3.1.2 aMac:~ mike$ uname -a Darwin dd-wrt.local 10.4.0 Darwin Kernel Version 10.4.0: Fri Apr 23 18:27:12 PDT 2010; root:xnu-1504.7.4~1/RELEASE_X86_64 x86_64 So to summarize; I think that the example 7.3.2.3 needs a 'b' char added to the beginning of the second string, to declare it to be a byte array. cheers, m i k e ps - here's some other *possibly relevant" examples of how it works on this platform: >>> calcsize( 'hhl' ) 8 >>> unpack( 'hhl', b'\x01\x00\x02\x00\x03\x00\x00\x00') (1, 2, 3) >>> unpack( '<hhl', b'\x00\x01\x00\x02\x00\x00\x00\x03') (256, 512, 50331648) >>> unpack( '>hhl', b'\x00\x01\x00\x02\x00\x00\x00\x03') (1, 2, 3) >>>

2 1

[issue9944] Typo in doc for itertools recipe of consume
by Jon Clements Sept. 25, 2010

Sept. 25, 2010

New submission from Jon Clements <joncle(a)googlemail.com>: Very low priority. def consume(iterator, n): "Advance the iterator n-steps ahead. If n is none, consume entirely." # Use functions that consume iterators at C speed. if n is None: # feed the entire iterator into a zero-length deque collections.deque(iterator, maxlen=0) else: # advance to the emtpy slice starting at position n next(islice(iterator, n, n), None) Hardly a show stoppper, and not me worth submitting a patch, but "emtpy" should be "empty". Just thought I'd make note of it before I forgot. ---------- assignee: docs@python components: Documentation messages: 117339 nosy: docs@python, joncle priority: normal severity: normal status: open title: Typo in doc for itertools recipe of consume versions: Python 2.5, 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/issue9944> _______________________________________

2 1