Mailman 3 September 2011 - docs

[issue12725] Docs: Odd phrase "floating seconds" in socket.html
by Cris Simpson Sept. 4, 2011

Sept. 4, 2011

New submission from Cris Simpson <crisor(a)gmail.com>: In http://docs.python.org/library/socket.html, the description for socket.setdefaulttimeout(timeout) reads: Set the default timeout in *floating seconds* for new socket objects. [occurs two other times on that page] "floating seconds" is a confusing construction. Suggestion: "float expressing seconds" as per socket.settimeout(value) or "seconds (float)". ---------- assignee: docs@python components: Documentation messages: … [View More]

6 6

[issue12838] FAQ/Programming typo: range[3] is used
by Eli Bendersky Sept. 4, 2011

Sept. 4, 2011

New submission from Eli Bendersky <eliben(a)gmail.com>: User report from docs@python: On http://docs.python.org/faq/programming.html for i in range[3]: Should be: for i in range(3): ---------- assignee: docs@python components: Documentation keywords: easy messages: 142952 nosy: docs@python, eli.bendersky priority: normal severity: normal stage: needs patch status: open title: FAQ/Programming typo: range[3] is used type: behavior versions: Python 2.7, Python 3.2, Python 3.3 … [View More]

2 2

[issue12781] Mention SO_REUSEADDR near socket doc examples
by Sandro Tosi Sept. 4, 2011

Sept. 4, 2011

New submission from Sandro Tosi <sandro.tosi(a)gmail.com>: Following up http://mail.python.org/pipermail/docs/2011-April/004025.html here's a patch to add a notice about SO_REUSEADDR after the examples, so even re-running several times and getting that error, wont scare anyone. ---------- assignee: docs@python components: Documentation files: socket_resueaddr.patch keywords: patch messages: 142403 nosy: docs@python, ezio.melotti, sandro.tosi priority: normal severity: normal stage: … [View More]

4 6

404 on http://docs.python.org/bugs.html
by Yves Dorfsman Sept. 4, 2011

Sept. 4, 2011

In http://docs.python.org/bugs.html "See http://www.python.org/dev/workflow/ for a detailed description of the issue workflow." Then http://www.python.org/dev/workflow/ fourofours. -- Yves. http://www.SollerS.ca/ http://ipv6.SollerS.ca http://blog.zioup.org/

2 1

[issue12761] Typo in Doc/license.rst
by Roundup Robot Sept. 4, 2011

Sept. 4, 2011

Roundup Robot <devnull(a)psf.upfronthosting.co.za> added the comment: New changeset 5b21312c3800 by Sandro Tosi in branch '3.2': #12761: fix wording of zlib license section http://hg.python.org/cpython/rev/5b21312c3800 ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12761> _______________________________________

1 0

[issue12672] Some problems in documentation extending/newtypes.html
by Eli Bendersky Sept. 4, 2011

Sept. 4, 2011

New submission from Eli Bendersky <eliben(a)gmail.com>: Reading the C API documentation: extending/newtypes.html Some problems: 1. In the first paragraph of 2.1 - "to distinguish them from things like [].append", it's unclear what [].append is. Maybe "[] and append"? 2. The C coding convention is unusual and non PEP-7 in 2.1.1 (after "if (self->first == NULL)" in Noddy_new) 3. The previous problem repeats in other instances of Noddy_new in the document I found these while reading … [View More]

6 21

[issue11360] In documentation of getopt, advertise argparse instead of optparse
by Daniel Haertle Sept. 4, 2011

Sept. 4, 2011

New submission from Daniel Haertle <haertle(a)uni-bonn.de>: At the beginning of http://docs.python.org/dev/library/getopt.html the line "A more convenient, flexible, and powerful alternative is the optparse module." routes the user to optparse. Since optparse is deprecated in favor of argparse, this line is no more up-to-date. The best is to remove this line completely, since there already is a note routing to argparse. ---------- assignee: docs@python components: Documentation … [View More]

3 4

About
by Adam Woodbeck Sept. 2, 2011

Sept. 2, 2011

I was reading through the Python docs tonight and ran across the About section. It contained a comprehensive list of people who contributed to the Python documentation. I'm not sure if I qualify, but I contributed patches for issue10403, issue12369, and issue12278 - all three of which were accepted. So if those patches qualify, I would appreciate it if you added my name to the About page of the Python documentation. Sincerely, Adam Woodbeck

3 4

[issue10454] Clarify compileall options
by Éric Araujo Sept. 2, 2011

Sept. 2, 2011

New submission from Éric Araujo <merwok(a)netwok.org>: This is the help text of compileall: usage: python compileall.py [-l] [-f] [-q] [-d destdir] [-x regexp] [-i list] [directory|file ...] -l: don't recurse down -f: force rebuild even if timestamps are up-to-date -q: quiet operation -d destdir: purported directory name for error messages if no directory arguments, -l sys.path is assumed -x regexp: skip files matching the regular expression regexp the regexp is searched … [View More]

4 11

Doc link incorrect
by T.Hill Sept. 1, 2011

Sept. 1, 2011

Found a link that needs to be corrected... On page: http://docs.python.org/release/2.6/download The PLAIN TEXT (zipped) link is: *http://docs.python.org/ftp/python/doc/2.6/python-2.6-docs-pdf-text.zip* Should be changed to: *http://docs.python.org/ftp/python/doc/2.6/python-2.6-docs-text.zip* Note: Removed "-pdf" before "-text". Thanks for the documentation... Cal

3 2