Mailman 3 August 2012 - docs

Missing ')' in argparse docs
by kishkin 12 Aug '12

12 Aug '12

Hello, Just a minor typo here: http://docs.python.org/library/argparse.html#action "values - The associated command-line arguments, with any type conversions applied. (Type conversions are specified with the type keyword argument to add_argument()." - here ')' is missing at the end. Thanks. --- Michael

2 1

New link for CodeTools
by Robert Kern 12 Aug '12

12 Aug '12

The Python 3 docs <http://python.readthedocs.org/en/latest/_sources/library/collections.txt> link to a file in an old repository. * The `MultiContext class <http://svn.enthought.com/svn/enthought/CodeTools/trunk/enthought/contexts/m…>`_ in the Enthought `CodeTools package <https://github.com/enthought/codetools>`_ has options to support writing to any mapping in the chain. Should be this: * The `MultiContext class <https://github.com/enthought/codetools/blob/4.0.0/codetools/contexts/multi_…>`_ in the Enthought `CodeTools package <https://github.com/enthought/codetools>`_ has options to support writing to any mapping in the chain. That link should persist more reliably in the future. Thank you! -- Robert Kern Enthought

2 1

code-example doesn't work as displayed in documentation
by Martin 12 Aug '12

12 Aug '12

http://docs.python.org/py3k/tutorial/datastructures.html#nested-list-compre… the code-example in the last paragraph of nested list comprehensions doesn't work like displayed. displayed: >>> zip(*matrix) [(1, 5, 9), (2, 6, 10), (3, 7, 11), (4, 8, 12)] but works like that: >>> zip(*matrix) <zip object at 0x7fd9d8a660e0> to make it work like displayed i had to type: >>> list(zip(*matrix)) [(1, 5, 9), (2, 6, 10), (3, 7, 11), (4, 8, 12)] i guess the example was just copied from the 2.7.3 python documentation because it worked like displayed with Python 2.7.3, but not with Python 3.2.3 Regards Martin

2 1

Bug in doctest documentation
by Scott Mancuso 12 Aug '12

12 Aug '12

This is an issue with the documentation of directives found at http://docs.python.org/library/doctest.html#option-flags-and-directives Quite a few examples of how to use the directives are included. Unfortunately, the actually directives aren't visible in the code examples given. For example, this: >>> print range(20) #doctest: +NORMALIZE_WHITESPACE [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19] is rendered as >>> print range(20) [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19] Scott Mancuso

2 1

print "Hello World" not working
by Richard Hendricks 12 Aug '12

12 Aug '12

Hello, Looks like there has been a format change in a recent version that has not propagated to documentation? http://docs.python.org/tutorial/introduction.html#strings has example hello = "This is a rather long string containing\n\ several lines of text just as you would do in C.\n\ Note that whitespace at the beginning of the line is\ significant." print hello However, when I try to use that in a plain 3.2.3 install on a PC: >>> hello = "This is a rather long string containing\n\ ... several lines of text just as you would do in C.\n\ ... Note that whitespace at the beginning of the line is\ ... significant." >>> >>> print hello File "<stdin>", line 1 print hello ^ SyntaxError: invalid syntax >>> ...but this works... >>> print (hello) This is a rather long string containing several lines of text just as you would do in C. Note that whitespace at the beginning of the line is significant. >>> Thank you. -- "Every gun that is made, every warship launched, every rocket fired signifies, in the final sense, a theft from those who hunger and are not fed, those who are cold and are not clothed. This world in arms is not spending money alone. It is spending the sweat of its laborers, the genius of its scientists, the hopes of its children..." -- Dwight D Eisenhower

2 1

Typo in the String docs
by Ramon Royo Giner 12 Aug '12

12 Aug '12

Hi,I found a typo in the following address, at the bottom:http://docs.python.org/library/string.html string.replace(str, old, new[, maxreplace])Should read: string.replace(old, new[, maxreplace])Thanks for all the work and effort you put into making Python better and better.Best regards,Ramon Royo i GinerEstudiant de Grau Multimèdiarroyog(a)uoc.edu

2 1

A typo in an example code.
by 김영휘 12 Aug '12

12 Aug '12

Hi, An example logging server code in the following url gives an error: http://docs.python.org/howto/logging-cookbook.html#sending-and-receiving-lo… It seems that the code has typos. import socketserver should be import SocketServer I am using Python 2.7.3, FYI. Regards.

2 1

[issue15619] set.pop() documentation is confusing
by Anton Barkovsky 11 Aug '12

11 Aug '12

New submission from Anton Barkovsky: I've seen people being confused by the documentation for set.pop() method. It makes it look like the element is selected randomly while it's just unspecified. I'm attaching a patch that clarifies the doc, tested on 3.3, 3.2 and 2.7 ---------- assignee: docs@python components: Documentation files: set_pop_doc.patch keywords: patch messages: 167895 nosy: anton.barkovsky, docs@python priority: normal severity: normal status: open title: set.pop() documentation is confusing versions: Python 2.7, Python 3.2, Python 3.3 Added file: http://bugs.python.org/file26759/set_pop_doc.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15619> _______________________________________

4 4

[issue15628] Add import ABC hierarchy to docs for importlib
by Andrew Svetlov 11 Aug '12

11 Aug '12

Andrew Svetlov added the comment: Brett, what do you think about? ---------- assignee: -> docs@python components: +Documentation keywords: +easy nosy: +brett.cannon, docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15628> _______________________________________

1 0

[issue15606] re.VERBOSE whitespace behavior not completely documented
by Steven Collins 11 Aug '12

11 Aug '12

Steven Collins added the comment: Fair enough, but in that case I still think the current behavior should be documented. Attached is a possible patch. (This is my first interaction with the Python issue tracker, by the way; apologies if I ought to have set some field differently or left some other field alone.) ---------- assignee: -> docs@python components: +Documentation keywords: +patch nosy: +docs@python title: re.VERBOSE doesn't ignore certain whitespace -> re.VERBOSE whitespace behavior not completely documented type: behavior -> enhancement versions: +Python 3.3 -Python 2.7, Python 3.2 Added file: http://bugs.python.org/file26767/re_whitespace.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15606> _______________________________________

1 0