Mailman 3 April 2011 - docs

[issue10977] Concrete object C API needs abstract path for subclasses of builtin types
by Nick Coghlan April 6, 2011

April 6, 2011

Nick Coghlan <ncoghlan(a)gmail.com> added the comment: Changing the affected components. Antoine and Benjamin are right, this needs to be handled as a documentation and education problem. Raymond's suggestion can too easily trigger infinite recursion and mine would block legitimate use cases in 3rd party code. For heapq, we can just fix it to include the fallbacks to the abstract versions if PyList_CheckExact() fails. ---------- assignee: -> docs@python components: +Documentation -Interpreter Core nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10977> _______________________________________

1 0

[issue10175] vs version for win32 compilation of extension modules is undocumented.
by Brian Curtin April 4, 2011

April 4, 2011

Changes by Brian Curtin <brian(a)python.org>: ---------- nosy: +brian.curtin _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10175> _______________________________________

1 0

[issue10433] Document unique behavior of 'getgroups' on OSX
by Ned Deily April 4, 2011

April 4, 2011

Ned Deily <nad(a)acm.org> added the comment: Here's a revised doc patch. As noted from my investigation in Issue7900, the key getgroups behavior change is with the OS X 10.6 ABI (so > 10.5), not 10.5. ---------- stage: needs patch -> commit review Added file: http://bugs.python.org/file21528/issue10433-v2.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10433> _______________________________________

1 0

[issue11282] unittest document not keep consist with code
by Ray.Allen April 3, 2011

April 3, 2011

New submission from Ray.Allen <ysj.ray(a)gmail.com>: r88451: Remove unittest methods scheduled for removal in 3.3 This commit remove assertSameElements() and assertDictContainsSubset(). But shouldn't some modification be done in the unittest library documentation? I wonder if we should remove the docs about the two methods. Now the doc only said "Deprecated since version 3.2." ---------- assignee: docs@python components: Documentation messages: 129036 nosy: docs@python, ysj.ray priority: normal severity: normal status: open title: unittest document not keep consist with code versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11282> _______________________________________

7 13

Typo in cProfile documentation
by Kurt McKee April 3, 2011

April 3, 2011

Howdy! Just wanted to let you know that there's a simple typo at: http://docs.python.org/dev/library/profile.html The note in section 26.3.1 uses the word "resonably" which should be spelled "reasonably". Thank you for the excellent documentation, it's marvelous! Sincerely, Kurt McKee

2 1

Error in The Python Tutorial
by Dhaval Patel April 3, 2011

April 3, 2011

Hi I am learning Python. As a part of my learning process, I found your tutorial very helpful. Today I have found error in section 4.4. break<https://mail.google.com/mail/html/compose/reference/simple_stmts.html#break>and continue<https://mail.google.com/mail/html/compose/reference/simple_stmts.html#conti…>Statements, and else<https://mail.google.com/mail/html/compose/reference/compound_stmts.html#else>Clauses on Loops >>> for n in range(2, 10):... for x in range(2, n):... if n % x == 0:... print n, 'equals', x, '*', n/x... break... else:... # loop fell through without finding a factor... print n, 'is a prime number'...2 is a prime number3 is a prime number4 equals 2 * 25 is a prime number6 equals 2 * 37 is a prime number8 equals 2 * 49 equals 3 * 3 The first output 2 is a prime number is not coming out I think when it goes in first inner for loop for x in range(2,2): range (2,2) is [] so it is not printing 2 is a prime number is not coming out I just want to make sure it my understanding is correct or there is mistake in document. Thanks -- Dhaval Patel

2 1

[issue11699] Doc for optparse.OptionParser.get_option_group is wrong
by Terry J. Reedy April 2, 2011

April 2, 2011

Changes by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- title: Documentation for get_option_group is wrong -> Doc for optparse.OptionParser.get_option_group is wrong _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11699> _______________________________________

1 0

[issue11676] Improve imp.load_module and submodules doc
by Terry J. Reedy April 2, 2011

April 2, 2011

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I verified this for 3.2 (and IDLE) with import sys, tkinter "ttk" in dir(sys.modules['tkinter']) # False import tkinter.ttk "ttk" in dir(sys.modules['tkinter']) # True ====reload======== import sys,imp imp.load_module('tkinter',*imp.find_module('tkinter')) imp.load_module('tkinter.ttk',*imp.find_module('ttk', sys.modules["tkinter"].__path__)) "ttk" in dir(sys.modules['tkinter']) # False from tkinter import ttk # ImportError Given that 'ttk' is only added to the tkinter entry when ttk is imported via tkinter, I am not surprised that the direct import with imp fails to affect the tkinter entry. Imp would have to notice that ttk is in a directory with __init__, get the name of the parent directory, and then check to see whether or not that parent had already been imported. Unlike import import ttk #fails imp does not require such a previous import: imp.load_module('ttk',*imp.find_module('ttk', ["C:/programs/python32/Lib/tkinter"])) succeeds, which shows again that import and imp act differently. Dave, can you suggest added text and a location to put it? Hmmm. How about after "If the load ...", add "A successful load does not affect previously loaded package modules as this function operates independently of package structure." ---------- nosy: +terry.reedy title: imp.load_module and submodules - doc issue, or bug? -> Improve imp.load_module and submodules doc versions: +Python 3.1, Python 3.2, Python 3.3 -Python 2.5, Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11676> _______________________________________

1 0

[issue11690] Devguide: Add "communication" FAQ
by Ezio Melotti April 1, 2011

April 1, 2011

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- nosy: +ezio.melotti _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11690> _______________________________________

1 0

A bug in Python v2.6.6 documentation
by Jakub Kowalski April 1, 2011

April 1, 2011

Hello, I have found a bug in the chapter 9.7.1. Itertool functions: product(A, B) is not equivalent to ((x,y) for x in A for y in B) It is untrue for dependent iterators - and here is the proof: >>> class c: ... def g(self): ... for i in xrange(self.x): ... yield i ... def h(self, x): ... for i in xrange(x): ... self.x = i ... yield i >>> for i in ((x, y) for x in d.h(4) for y in d.g()): ... print i (1, 0) (2, 0) (2, 1) (3, 0) (3, 1) (3, 2) >>> for i in product(d.h(4), d.g()): ... print i (0, 0) (0, 1) (0, 2) (1, 0) (1, 1) (1, 2) (2, 0) (2, 1) (2, 2) (3, 0) (3, 1) (3, 2) Greetings, J.Kowalski

1 0