Mailman 3 December 2010 - docs

[issue8910] Write a text file explaining why Lib/test/data exists
by Éric Araujo Dec. 5, 2010

Dec. 5, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Temporarily reopening so that Martin can decide whether he wants to add Lib/test/data/README to msi.py ---------- status: closed -> open _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8910> _______________________________________

1 0

Possible bug in 3.2 Accumulate Function
by Frank Ellis Dec. 5, 2010

Dec. 5, 2010

Quoting from the http://docs.python.org/dev/py3k/whatsnew/3.2.html page: The itertools module has a new function, accumulate() modeled on APL’s scan operator and on Numpy’s accumulate function:>>> list(accumulate(8, 2, 50)) [8, 10, 60] >>> prob_dist = [0.1, 0.4, 0.2, 0.3] >>> list(accumulate(prob_dist)) # cumulative probability distribution [0.1, 0.5, 0.7, 1.0] I'm not sure if this is a bug as I'm not sure if this is how the function actually behaves. Should the first function not take a list? For example:>>> list(accumulate([8, 2, 50])) [8, 10, 60]Notice the square brackets. I have not actually tested the function personally but it seems like something worth noting.

1 0

[issue10609] dbm documentation example doesn't work (iteritems())
by Éric Araujo Dec. 4, 2010

Dec. 4, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Arg, the internal classes returned by dbm.*.open have keys but not necessarily items. See #9523, #6045 and #5736. The docs should be fixed independently of that, with the less non-idiomatic code that we can find. Do you want to check the dbm docs for other similar broken examples? I’ll review the patch. ---------- assignee: docs@python -> eric.araujo _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10609> _______________________________________

1 0

Re: [docs] [issue10516] Add list.clear() and list.copy()
by Éric Araujo Dec. 4, 2010

Dec. 4, 2010

Hi Eli, I think the right place is 4.6.4, http://docs.python.org/dev/library/stdtypes#mutable-sequence-types It starts with “List and bytearray objects support additional operations that allow in-place modification of the object”. For methods not supported by bytearray, you can use the fake footnote (8) and edit its texte (“sort() is not supported by bytearray objects”). Regards

1 0

Python Doc bug, 5.3 Pure Emebedding
by Bob Reese Dec. 4, 2010

Dec. 4, 2010

FYI (great job on documentation!!) 5.3 Pure Embedding code example. This is a good example but under 2.3 and 2.6 on my Linux systems, the example fails to run because the sys.path variable does not have the current working directory ('[]') on it, so the module is not found (the python code is in the cwd). I am not sure why this occurs, because if the normal python interpreter is executed and the sys.path variable printed, the current working directory is on that path. I don't know why starting up the interpreter under C code control produces a different sys.path value from starting up the Python interpret from a shell command line (everything is the same except for the cwd being present). Somebody else in web land has also experienced this problem, as evidenced by (this is the same behavior that I see): http://coding.derkeiler.com/Archive/Python/comp.lang.python/2006-10/msg0102… The real fix would be to identify what is causing this difference in sys.path values, but I have not been able to do this. It is probable that this is just an environment issue of some kind, but I don't know what it is. My bogus fix is to modify the example to add the current working directory to the sys.path variable as follows: void fixSysPath(void) { PyObject *pSysModule; PyObject *pSysPath; PyObject *pCwd; int i; pSysModule = PyImport_ImportModule("sys"); if (pSysModule == NULL) { myErr("Import of sys module failed"); exit(-1); } pSysPath = PyObject_GetAttrString(pSysModule, "path"); if (!pSysPath) { myErr("Cannot find 'sys.path'"); exit(-1); } pCwd = PyString_FromString(""); //null string represents cwd PyList_Insert(pSysPath,0,pCwd); } And in the example....: Py_Initialize(); fixSysPath(); //<<<<---Added Thanks. Great job on the documentation! ---------------------------------------------------------------- Bob Reese 662/325-3154 (voice) reese(a)ece.msstate.edu 662/325-2298 (fax) http://www.ece.msstate.edu/~reese Associate Prof/Electrical & Computer Engineering Mississippi State University US Mail Address: Box 9571, Miss State, MS 39762 Street Address: 309 Simrall Hall, Hardy Street, Miss State, MS 39762 ----------------------------------------------------------------

1 0

official place to document list's methods
by Eli Bendersky Dec. 4, 2010

Dec. 4, 2010

Hello docs@python, I'm currently working on issue 10516 (adding the .clear and .copy methods to list, for Python 3.3) and I'm wondering where in the documentation I should describe these new methods. The closest place I found that looks like it's listing the methods of a list is sections 3.3.6 and 4.6.4. In particular 4.6.4 looks suitable, but it talks about bytearray too. Can you recommend how to proceed with this? Thanks in advance, Eli

1 0

[issue10623] What’s New In Python 3.2 document refers to PEP 382: Defining a Stable ABI
by Daniel Urban Dec. 4, 2010

Dec. 4, 2010

New submission from Daniel Urban <urban.dani+py(a)gmail.com>: But "Defining a Stable ABI" is PEP 384: http://www.python.org/dev/peps/pep-0384/ (PEP 382 is "Namespace Packages") ---------- assignee: docs@python components: Documentation messages: 123345 nosy: docs@python, durban priority: normal severity: normal status: open title: What’s New In Python 3.2 document refers to PEP 382: Defining a Stable ABI type: behavior versions: Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10623> _______________________________________

2 1

[issue10609] dbm documentation example doesn't work (iteritems())
by Sandro Tosi Dec. 3, 2010

Dec. 3, 2010

Sandro Tosi <sandro.tosi(a)gmail.com> added the comment: Hi Eric, on and up-to-date py3k I got this: >>> for k, v in db.items(): ... print(k, '\t', v) ... Traceback (most recent call last): File "<stdin>", line 1, in <module> AttributeError: '_dbm.dbm' object has no attribute 'items' >>> 'items' in dir(db) False (I tried to use items() before proposing that code ;)). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10609> _______________________________________

1 0

[issue10609] dbm documentation example doesn't work (iteritems())
by Éric Araujo Dec. 3, 2010

Dec. 3, 2010

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: -> needs patch versions: +Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10609> _______________________________________

1 0

[issue10299] Add index with links section for built-in functions
by nestor Dec. 2, 2010

Dec. 2, 2010

New submission from nestor <nestornissen(a)gmail.com>: The built-in function page (http://docs.python.org/dev/py3k/library/functions.html) is pretty long. Each function has an anchor but unlike the built-in types section there is no quick way to get an overview or jump to a specific function (like open or print) short of scrolling through 22 pages. It would be nice to have an index of all built-in functions linked to the specific entry on the built-in functions page. This could be either somehow added to the index page (http://docs.python.org/dev/py3k/library/index.html) or to the top of the built-in functions page itself. For efficient use of real-estate multiple function names could be on one single line alphabetically sorted and separated by spaces. ---------- assignee: docs@python components: Documentation messages: 120327 nosy: docs@python, georg.brandl, nestor priority: normal severity: normal status: open title: Add index with links section for built-in functions type: feature request versions: Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10299> _______________________________________

7 19