Mailman 3 September 2011 - docs

[issue12951] List behavior is different
by शंतनू Sept. 10, 2011

Sept. 10, 2011

New submission from शंतनू <shantanoo(a)gmail.com>: URL: http://docs.python.org/library/stdtypes.html Following example is given. >>> lists = [[]] * 3 >>> lists [[], [], []] >>> lists[0].append(3) >>> lists [[3], [3], [3]] Behavior is as follows. >>> a = [[]] * 3 >>> a [[], [], []] >>> a[0] = 1 >>> a [1, [], []] >>> Python interpreter details: $ python Python 2.7.2 (default, Aug 22 2011, 13:53:27) [… [View More]

3 2

[issue12940] Cmd example using turtle left vs. right doc-bug
by Tim Chase Sept. 10, 2011

Sept. 10, 2011

New submission from Tim Chase <python.list(a)tim.thechases.com>: The Turtle example for the cmd module as documented at http://docs.python.org/py3k/library/cmd.html#cmd-example In the left() method, it calls turtle.right() instead of turtle.left(). Easy fix: /def left/+2s/left/right/ Likely exists in most 3.x documentation. ---------- assignee: docs@python components: Documentation messages: 143746 nosy: Gumnos, docs@python priority: normal severity: normal status: open title: Cmd … [View More]

4 7

[issue12902] help("modules") executes module code
by Ezio Melotti Sept. 10, 2011

Sept. 10, 2011

Ezio Melotti <ezio.melotti(a)gmail.com> added the comment: > "Warning: gathering the results for the topic 'modules' can take > considerable time and have side effects as it imports *every* module > available to get at its doc string." http://docs.python.org/documenting/style.html#affirmative-tone ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12902> _______________________________________

1 0

[issue12902] help("modules") executes module code
by Terry J. Reedy Sept. 9, 2011

Sept. 9, 2011

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: The immediate issue is improvement of the entries for help and help(): In builtin functions section: Expand "Invoke the built-in help system." to "Invoke the built-in help system, which uses *pydoc*." where *pydoc* is linked to the pydoc section. Add to the end of the entry something like "As needed, pydoc imports modules to get their doc strings." The special string 'modules' is not documented in the manual entry for help() … [View More]

1 0

[issue12896] Recommended location of the interpreter for Python 3
by Lennart Regebro Sept. 9, 2011

Sept. 9, 2011

New submission from Lennart Regebro <regebro(a)gmail.com>: The documentation on Using Python, 2.3. Python-related paths and files says that "exec_prefix/bin/python" is the recommended location for the interpreter, while for Python 3 it's "exec_prefix/bin/python3". http://docs.python.org/py3k/using/unix.html#python-related-paths-and-files ---------- assignee: docs@python components: Documentation messages: 143508 nosy: docs@python, lregebro priority: normal severity: normal status: open … [View More]

3 3

[issue12779] Update packaging documentation
by Ezio Melotti Sept. 7, 2011

Sept. 7, 2011

Ezio Melotti <ezio.melotti(a)gmail.com> added the comment: 1) sounds good; 2) would be fine too if it makes your life easier; 3) doesn't seem too useful. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12779> _______________________________________

1 0

[issue7798] Make generally useful pydoc functions public
by Éric Araujo Sept. 6, 2011

Sept. 6, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: I’ve looked hard at pydoc and opened distinct bug reports so that each piece of maybe-useful functionality can be discussed independently: #12918 New module for terminal utilities #12917 Make visiblename and allmethods functions public #12916 Add inspect.splitdoc #12915 Add inspect.locate and inspect.resolve #12914 Add cram function to textwrap ---------- resolution: -> invalid stage: needs patch -> committed/rejected status: … [View More]

1 0

[issue12906] Slight error in logging module's yaml config
by Derrick Petzold Sept. 6, 2011

Sept. 6, 2011

New submission from Derrick Petzold <dpetzold(a)gmail.com>: Hello, format: format=%(asctime)s - %(name)s - %(levelname)s - %(message)s Should be: format: %(asctime)s - %(name)s - %(levelname)s - %(message)s Regards, btw I have to say the logging module is just excellent. What a truly great work. ty. ---------- assignee: docs@python components: Documentation messages: 143579 nosy: Derrick.Petzold, docs@python priority: normal severity: normal status: open title: Slight … [View More]

4 5

[issue12779] Update packaging documentation
by Éric Araujo Sept. 5, 2011

Sept. 5, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: To make commit review possible, I thought I’d make two patches for this: the first would be only markup fixes and minimal updates to match the reality of the code (i.e. convert setup.py examples to setup.cfg or pysetup, remove obsolete parts, etc.) and a second one with more rephrasing and reorganization (i.e. file deletions, moving chunks of docs, etc.). I’m not finished on the first patch and the diff already contains 1026 … [View More]

1 0

[issue11155] multiprocessing.Queue's put() signature differs from docs
by Erik Cederstrand Sept. 5, 2011

Sept. 5, 2011

New submission from Erik Cederstrand <ec(a)1calendar.dk>: In Python 2.6.6 on OSX: >>> import inspect >>> from multiprocessing import Queue >>> q = Queue() >>> print(inspect.getargspec(q.put)) ArgSpec(args=['self', 'obj', 'block', 'timeout'], varargs=None, keywords=None, defaults=(True, None)) >>> from Queue import Queue >>> q = Queue() >>> print(inspect.getargspec(q.put)) ArgSpec(args=['self', 'item', 'block', 'timeout'], … [View More]

6 14