Mailman 3 May 2010 - docs

[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: patch messages: 106194 nosy: docs@python, terrence priority: normal severity: normal status: open title: typo in docs for symtable.SymbolTable.has_import_star versions: Python 3.1, Python 3.2, Python 3.3 Added file: http://bugs.python.org/file17420/fix-has-import-star-doc.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8778> _______________________________________

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: 105923 nosy: docs@python, pyfex priority: normal severity: normal status: open title: broken asdl link in Parser/asdl.py _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8742> _______________________________________

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 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8619> _______________________________________

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 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8744> _______________________________________

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 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

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: 105706 nosy: docs@python, haypo priority: normal severity: normal status: open title: Document PyUnicode_DecodeFSDefault() and PyUnicode_DecodeFSDefaultAndSize() versions: Python 3.1, Python 3.2 Added file: http://bugs.python.org/file17336/unicode_doc.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8711> _______________________________________

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 documentation mentions types.ListType versions: Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8703> _______________________________________

2 1