Mailman 3 May 2010 - docs

[issue8707] Duplicated document in telnetlib.
by INADA Naoki May 21, 2010

May 21, 2010

New submission from INADA Naoki <songofacandy(a)gmail.com>: http://docs.python.org/dev/library/telnetlib.html#telnetlib.Telnet The part "number can be passed to the constructor... " is duplicated. ---------- assignee: docs@python components: Documentation messages: 105667 nosy: docs@python, naoki priority: normal severity: normal status: open title: Duplicated document in telnetlib. versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.… [View More]

5 7

Python Documentation Typo
by Viktor Viktorov May 21, 2010

May 21, 2010

Hello,There is a typo in the documentation at http://docs.python.org/py3k/library/urllib.request.html:>>> import urllib.request >>> f = urllib.request.urlopen('http://www.python.org/') >>> print(fp.read(100).decode('utf-8')) <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtm Should be>>> import urllib.request >>> f = urllib.request.urlopen('http://www.python.org/') >>> print(f.read(100).… [View More]

2 1

[issue8724] bind_and_activate parameter is missed from directive
by Georg Brandl May 21, 2010

May 21, 2010

Georg Brandl <georg(a)python.org> added the comment: Thanks, fixed in r81419. ---------- nosy: +georg.brandl resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8724> _______________________________________

1 0

Typo in urllib2
by INADA Naoki May 21, 2010

May 21, 2010

I've found typo in urllib2. But bugs.python.org is down now. http://docs.python.org/dev/library/urllib2.html#urllib2.OpenerDirector.open -(if not specified, the global default timeout setting will be usedi). +(if not specified, the global default timeout setting will be used). # extra 'i' -- INADA Naoki <songofacandy(a)gmail.com>

2 1

Bad link in document
by Komorowski, George May 21, 2010

May 21, 2010

The link to the Apple website is broken. The current PDF file at Apple website has 2009 in file name the Apple Publications Style Guide wherever Documenting Python Release 3.1.2 Georg Brandl March 20, 2010 [cid:image001.jpg@01CAF28D.27E6D430] George Komorowski IT Service Desk Iberdrola USA Management Corporation 400 West Ave, Rochester, NY 14611 800-646-3850 Service Desk 585-771-4374 Direct George.Komorowski(a)EnergyEast.com [cid:image002.jpg@01CAF28D.27E6D430] In the interest of the … [View More]

2 1

Python 2.6.5 threading.Event.wait()
by Andrew Trusty May 21, 2010

May 21, 2010

Just spent a couple hours debugging some code because the threading.Event.wait() documentation said it returned the internal flag when it always returns None. I just noticed that there is an addendum that says this was behavior that was changed in 2.7 but since these are the 2.6.5 docs it would be a lot less confusing if it first said that it always returns None and then said that in 2.7 it will return the internal flag. http://docs.python.org/library/threading.html#threading.Event.wait Andrew

2 1

A documentation glitch
by Денис Горбачев May 21, 2010

May 21, 2010

Page in question: http://docs.python.org/py3k/tutorial/datastructures.html#sets >>> fruit = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana'] >>> fruit = set(basket) # create a set without duplicates Should be >>> fruit = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana'] >>> fruit = set(*fruit*) # create a set without duplicates as the intention is to show how to create a set without duplicates from a list. -- … [View More]

2 1

Typo in callable doc
by Éric Araujo May 21, 2010

May 21, 2010

Hello Revision 77096 fixed a bug in Doc/library/2to3.rst by changing “hasattr(x, "__call_")” to “isinstance(x, collections.Callable)”. However, in the 2.6 documentation still visible at docs.python.org, the incorrect “__call_” is still present. Regards

2 1

[issue8694] python3 FAQ mentions unicode()
by Nathan Phillip Brink May 21, 2010

May 21, 2010

New submission from Nathan Phillip Brink <ohnobinki(a)ohnopublishing.net>: http://docs.python.org/py3k/faq/programming.html#what-does-unicodeerror-asc… When I try to use unicode() from within python3, the call fails. I would actually expect that the FAQ should contain more information concerning the merging of the unicode and str classes. It would be nice if, when this FAQ entry is updated, there is a short discussion on making the code compatible with both python2 and python3, as it … [View More]

4 3

[issue8783] The external link to a "Hash Collision FAQ" points to some company's homepage
by Daniel Stutzbach May 21, 2010

May 21, 2010

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: At the bottom of the documentation for hashlib, there's a link to http://www.cryptography.com/cnews/hash.html which the hashlib documentation describes as "Hash Collision FAQ with information on which algorithms have known issues and what that means regarding their use." However, the page at that link is identical to http://www.cryptography.com/ which is just the homepage of some company that happens to deal … [View More]

2 1

[issue8778] typo in docs for symtable.SymbolTable.has_import_star
by Terrence Cole May 20, 2010

May 20, 2010

New submission from Terrence Cole <terrence(a)zettabytestorage.com>: The documentation for symtable.SymbolTable [http://docs.python.org/py3k/library/symtable.html] lists the function has_import_start. This should be has_import_star, as listed in help(symtable.SymbolTable). I've attached a patch, although it would probably be faster for a committer to just remove the 't' themselves. ---------- assignee: docs@python components: Documentation files: fix-has-import-star-doc.diff keywords: … [View More]

2 1

[issue8742] broken asdl link in Parser/asdl.py
by Patrick Sabin May 18, 2010

May 18, 2010

New submission from Patrick Sabin <patricksabin(a)gmx.at>: The link: http://www.cs.princeton.edu/~danwang/Papers/dsl97/dsl97-abstract.html in the file Parser/asdl.py seems to be broken. When I tried to open it I got a page with: "Sorry, the page you requested couldn't be found". It seems to me that this is a permanent issue and therefore the link should be removed as there is another link, that works. ---------- assignee: docs@python components: Documentation, Interpreter Core messages: … [View More]

3 2

[issue8619] Doc bug for urllib.request._urlopener in Python 3.1+
by Sriram Thaiyar May 18, 2010

May 18, 2010

New submission from Sriram Thaiyar <sriram.thaiyar(a)gmail.com>: http://docs.python.org/dev/py3k/library/urllib.request.html#urllib.request.… [in the body] urllib._urlopener should be urllib.request._urlopener ---------- assignee: docs@python components: Documentation messages: 104998 nosy: Sriram.Thaiyar, docs@python priority: normal severity: normal status: open title: Doc bug for urllib.request._urlopener in Python 3.1+ versions: Python 3.1 _______________________________________ … [View More]

4 9

[issue8744] Maybe typo in doc
by INADA Naoki May 18, 2010

May 18, 2010

New submission from INADA Naoki <songofacandy(a)gmail.com>: http://docs.python.org/dev/library/test.html#test.test_support.captured_std… "This is a context manager than runs the with statement body using a StringIO.StringIO object as sys.stdout." I think "than" is typo of "that". ---------- assignee: docs@python components: Documentation messages: 105946 nosy: docs@python, naoki priority: normal severity: normal status: open title: Maybe typo in doc versions: Python 2.6, Python 2.7 … [View More]

2 2

[issue6916] Remove deprecated items from asynchat
by Éric Araujo May 16, 2010

May 16, 2010

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6916> _______________________________________

1 0

Move some modules in the library ToC
by Éric Araujo May 16, 2010

May 16, 2010

Hi I suggest moving the index entries about argparse, optparse and logging from the catch-all and slightly obscure “Generic Operating System Services” heading to “Program Frameworks”. I can open a bug and attach a patch if people are +1. Regards

2 1

cursing curses in python 3.1
by John Summerfield May 15, 2010

May 15, 2010

First, we will deal with spammers. You do not have permission to store this email in a public space unless my email address is expunged. I am learning Python, and my references are Mark Summerfield's book on Python 3.0 and what I can find on the Internet. I know little C, and have no prior experience of curses. I do remember Turbo Pascal, with Turbo Vision, fondly, it allowed one to write text-based applications with hot keys, buttons, menus etc, and all with the use of the mouse. I am … [View More]finding the documentation I find (when google turns up the right release - it tends to find earlier releases, even at python.org) is incomplete and/or lacks clarity regarding the use of the mouse. I am using Python 3.1 on Debian Still In Development, on a Linux console and but for my wish to use the mouse, it would be in screen. I'm also using gpm. There might be room for argument as to whether any of these problems might be to do with the python/curses rather than its documentation. Here is the reference document: http://docs.python.org/py3k/library/curses.html The first problems I had is that, when I enabled the mouse using curses.mousemask(), I could not see what mask to use so I tried -1. This did not work, so I hunted further and eventually hit upon ALL_MOUSE_EVENTS. That didn't work differently. What happened is that my first getch() returned curses.KEY_MOUSE. When I used curses.getmouse() to find what happened, it raised an exception. I don't know what exception it raised, so I cannot selectively catch it. It might be curses.error, I hit on that after reading some source code (really!) and guessing. Anyway, that's what I'm catching. The error message being returned is ERR. I don't have the foggiest idea what that means (except something didn't work), and the documentation does not help me resolve the problem. Eventually, I tried it directly on a console and discovered, on a Linux console, it works. For diagnostic purposes, connected to localhost using ssh. It doesn't work through ssh either. I then tried to find a method to see whether I have a working mouse (curses.has_mouse() perhaps?) The crude hack I implemented is to, first, enable mouse events as above, and then if that errors, I disable them again. I would like to see the documentation updated to reflect the circumstances where curses' mouse support does not work, and the recommended way to discover whether there is a functional mouse at all. Had getch() not returned KEY_MOUSE, I would hardly have been better off, I would have clicked the mouse and had nothing happen. Which leads me to the next problem. Having sorted that our, and having debugging messages popping out whenever I clicked the mouse, I set about creating some code to distinguish mouse events. Of course, the first thing I wanted was code that would correctly identify when I clicked a button, and which one it was. The first part is easy, in fact, I already had that working. The second part was not. I printed out, in hex, the button state, but with no documentation that I could find, it was difficult matching the values I saw printed with the names in the web page. I clicked the mouse buttons, repeatedly, and saw the events being reported by my debugging code. However, the names I found, such as BUTTON1_CLICKED did not match what I saw with my eyes. More debugging code, and I find matches with PRESS and RELEASE. Never a CLICK. This behaviour needs to be documented, as does the question of how it works in, say, xterm. Is it different? I don't have X installed on Sid, nor python3 on anything that has. The binary values of the constants' names also need to be documented; if they vary between platforms (I think I read that they do), then in the packaged documentation. I also had some difficulty with curses windows on my Linux console. I discovered there were some things I needed to do before I could define a scrollable area or scroll the screen. I am not sure that all of the things I did are necessary. I would like to see the page improved with examples of the calls needed to prepare a screen for curses, for creating windows, for scrolling areas of the windows, and of the use of the mouse. I don't propose turning the page into a tutorial, just some basic examples (similar to those in the man pages for mawk and gawk) would have saved me hours of time and frustration. -- John Summerfield [View Less]

1 0

[issue8724] bind_and_activate parameter is missed from directive
by INADA Naoki May 15, 2010

May 15, 2010

Changes by INADA Naoki <songofacandy(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python versions: +Python 2.6, Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8724> _______________________________________

1 0

[issue8711] Document PyUnicode_DecodeFSDefault() and PyUnicode_DecodeFSDefaultAndSize()
by STINNER Victor May 14, 2010

May 14, 2010

New submission from STINNER Victor <victor.stinner(a)haypocalc.com>: Attached patch document PyUnicode_DecodeFSDefault() and PyUnicode_DecodeFSDefaultAndSize() in Doc/c-api/, and fix comment in Include/unicodeobject.c (remove reference to bytearray, and specify that surrogateescape is used). The patch adds also titles to group unicode functions and methods by topic. ---------- assignee: docs@python components: Documentation, Unicode files: unicode_doc.patch keywords: patch messages: … [View More]

3 5

[issue8703] Py3k PyList_Type documentation mentions types.ListType
by Daniel Urban May 13, 2010

May 13, 2010

New submission from Daniel Urban <urban.dani+py(a)gmail.com>: The Py3k documentation of PyList_Type [1] contains the sentence: "This is the same object as list and types.ListType in the Python layer." But there is no types.ListType object in py3k. [1] http://docs.python.org/dev/py3k/c-api/list.html#PyList_Type ---------- assignee: docs@python components: Documentation messages: 105631 nosy: docs@python, durban priority: normal severity: normal status: open title: Py3k PyList_Type … [View More]

2 1

Bug in Python xml document
by WANG Yanchao May 12, 2010

May 12, 2010

http://docs.python.org/library/xml.dom.html#attr-objects Attr.value should be added here. I know this may be a common knowledge, but for a new learner, it may be confusing. Thanks! Yanchao WANG

2 1

Typo in io.rst and meta-question about patches workflow
by Éric Araujo May 10, 2010

May 10, 2010

Hello everyone In trunk’s Doc/library/io.rst, a change from IOError to ValueError has left a stray “an”: --- Doc/library/io.rst Sat May 01 14:16:39 2010 +0200 +++ Doc/library/io.rst Sat May 01 15:26:32 2010 +0200 @@ -246,7 +246,7 @@ - (e.g. reading or writing) will raise an :exc:`ValueError`. + (e.g. reading or writing) will raise a :exc:`ValueError`. Is it ok to use the mailing list instead of the bug tracker for such tiny patches? Apart from Georg, are there people with commit … [View More]

2 1

ftplib nit
by Larry Tjoelker May 10, 2010

May 10, 2010

in ftplib docs, http://docs.python.org/library/ftplib.html?highlight=ftplib#module-ftplib, description of ftplib.all_errors 3rd line: "errors made by the caller). This set includes the four exceptions listed below as" It should be: "errors made by the caller). This set includes the four exceptions listed above as"

2 1

minor bugs in doc of python 3.1.2
by Heiner Marxen May 10, 2010

May 10, 2010

Hello, I think I have found a small bug in the python manual. URL: http://docs.python.org/py3k/reference/lexical_analysis.html chapter: 2.4.1. String and Bytes literals, Notes 4.: replace "exactly two hex digits" by "exactly four hex digits". An additional note from a python newbie, reading the doc the first time: At the very end of the above URL, there is clearly stated, that the characters $ and ? are immediate errors (outside strings and comments). But what about the backtick character ` (\… [View More]

2 1

Dead Link
by Ralf Ganswindt May 10, 2010

May 10, 2010

Hello, The following link: ------------------------ See also http://www.pysqlite.orgThe pysqlite web page – sqlite3 is developed externally under the name “pysqlite”.------------------------in the Python Library documentation, section 11.13.sqlite3, " http://docs.python.org/library/sqlite3.html," appears to be a dead link. Is "http://code.google.com/p/pysqlite/" the correct new location? Ralf Ganswindt RalfGanswindt(a)gmail.com

2 1