Mailman 3 September 2010 - docs

[issue6916] Remove deprecated items from asynchat
by Antoine Pitrou Sept. 4, 2010

Sept. 4, 2010

Changes by Antoine Pitrou <pitrou(a)free.fr>: ---------- assignee: josiahcarlson -> giampaolo.rodola stage: -> patch review versions: -Python 3.0, Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6916> _______________________________________

1 0

[issue9760] Suggestion for improving with documentation
by Jason Baker Sept. 3, 2010

Sept. 3, 2010

New submission from Jason Baker <amnorvend(a)gmail.com>: http://docs.python.org/reference/compound_stmts.html#with This documentation refers to "context expressions" in two places. However, it never really defines what a context expression is. The formal syntax that's presented is this: with_stmt ::= "with" with_item ("," with_item)* ":" suite with_item ::= expression ["as" target] As best I can tell, the context expression is essentially the with_item. If that's the case, I … [View More]

2 1

[issue9739] Output of help(...) is wider than 80 characters
by Terry J. Reedy Sept. 3, 2010

Sept. 3, 2010

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: Although this is not a problem in IDLE where the window can easily be expanded beyond 80 chars, I am in favor of the idea for other uses. The command line interpreter on Windows defaults to 80 chars and is not so easy to change, and one must be admin to make the change 'permanent' (until the next install reverts the change). In particular, the 82 char line for math.trun results in 'd.' of 'method.' wrapped to a line by itself with no … [View More]

1 0

[issue9755] Fix refcounting details in Py3k C API documentation
by Skip Montanaro Sept. 3, 2010

Sept. 3, 2010

Skip Montanaro <skip(a)pobox.com> added the comment: I thought Fred Drake wrote the code that generated that file, but that was a long time ago in a galaxy far, far away. Perhaps Georg has subsumed it into his Sphinx/Python doc workflow? (making Fred "nosy" so he sees this thread...) S ---------- nosy: +fdrake, skip.montanaro _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9755> _______________________________________

1 0

[issue9755] Fix refcounting details in Py3k C API documentation
by Nick Coghlan Sept. 3, 2010

Sept. 3, 2010

Changes by Nick Coghlan <ncoghlan(a)gmail.com>: ---------- assignee: -> docs@python nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9755> _______________________________________

1 0

Documentation bug for Python 3.x
by Sean McKean Sept. 3, 2010

Sept. 3, 2010

Greetings, I found a one-letter-missing bug on the page < http://docs.python.org/py3k/reference/simple_stmts.html > . Near the end of "The import statement," there is text declaring "import" as "imprt." Context: "from ..subpkg2 imprt mod" : html character 69441 of 88220, byte 69454 of 88236

1 0

[issue9739] Output of help(...) is wider than 80 characters
by Case Van Horsen Sept. 3, 2010

Sept. 3, 2010

Case Van Horsen <casevh(a)gmail.com> added the comment: According to PEP 7, the first line of the doc string should contain the signature of the function, then there should be a blank line, and then the rest of the doc string. There may be tools that extract the signature line. The patch just decreases the line length of the remaining lines of the doc string so they don't wrap when displayed on an 80 character wide terminal window. For an example, look at the text for modf(...) in help(… [View More]

1 0

[issue9739] Output of help(...) is wider than 80 characters
by Giampaolo Rodola' Sept. 2, 2010

Sept. 2, 2010

Changes by Giampaolo Rodola' <g.rodola(a)gmail.com>: ---------- nosy: +giampaolo.rodola _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9739> _______________________________________

1 0

[issue9739] Output of help(...) is wider than 80 characters
by Amaury Forgeot d'Arc Sept. 2, 2010

Sept. 2, 2010

Amaury Forgeot d'Arc <amauryfa(a)gmail.com> added the comment: Aren't there tools that extract only the first line of help? ---------- assignee: -> docs@python components: +Documentation -Extension Modules nosy: +amaury.forgeotdarc, docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9739> _______________________________________

1 0

[issue9677] "Global Module Index" link dead
by Brett Cannon Sept. 1, 2010

Sept. 1, 2010

New submission from Brett Cannon <brett(a)python.org>: When you build the HTML docs the "Global Module Index" link does not work while the "modules" link in the upper-right corner does. ---------- assignee: docs@python components: Documentation messages: 114832 nosy: brett.cannon, docs@python priority: high severity: normal stage: needs patch status: open title: "Global Module Index" link dead versions: Python 3.2 _______________________________________ Python tracker <report(a)bugs.… [View More]

3 2