Mailman 3 August 2013 - docs

There is a spelling mistakes in Python source code
by 张佩佩 Oct. 6, 2013

Oct. 6, 2013

Hello: I found there is a spelling mistakes in Python source code comment. In file: Python\lib\_pyio.py Line 413: """closed: bool. True iff the file has been closed. Best regards! peipei

2 1

very miscellaneous doc bug
by tomo cocoa Oct. 6, 2013

Oct. 6, 2013

Hello I am a translator on Japanese Python documents. A period was omitted after the word ":func:`distutils.util.execute`" http://docs.python.org/3.3/distutils/apiref.html#distutils.ccompiler.CCompi… Excuse me for reporting a small mistake :p Regards, cocoatomo -- class Cocoatomo: name = 'cocoatomo' email_address = 'cocoatomo77(a)gmail.com' twitter_id = '@cocoatomo'

2 1

Unittest documentation points to deprecated resource
by Daniel Greenfeld Oct. 6, 2013

Oct. 6, 2013

On http://docs.python.org/2/library/unittest.html The "seealso" includes a link to "The Python Testing Tools Taxonomy", which states that it is deprecated in favor of contents on the official Python wiki: http://wiki.python.org/moin/PythonTestingToolsTaxonomy Regards, Daniel Greenfeld

2 1

minor bug in http://docs.python.org/3/tutorial/modules.html
by Hugh O'Brien Oct. 6, 2013

Oct. 6, 2013

In section 6.4 the example file hierarchy seems to be affected by Python syntax highlighting, resulting in the 'for' term appearing bold.

2 1

Minor bug on http://docs.python.org/2/tutorial/interpreter.html
by Hugh O'Brien Oct. 6, 2013

Oct. 6, 2013

Section 2.2.5 shows the following demo code: >>> import site >>> site.getusersitepackages() '/home/user/.local/lib/python3.2/site-packages' The path provided is for python3, not 2. Thanks for the docs, Hugh

2 1

Fwd: Order in Python documentation search results
by Draic Kin Oct. 6, 2013

Oct. 6, 2013

Hello, in January there was an attempt by Hernan Grecco to improve the order in documentation search. Even a patch for Sphinx was accepted, however the improvement wasn't implemented on docs.python.org. It would be nice to be done. See forwarded message for details. Thank you for reaction, Drekin ---------- Forwarded message ---------- From: Hernan Grecco <hernan.grecco(a)gmail.com> Date: Mon, Jul 29, 2013 at 2:26 PM Subject: Re: Order in Python documentation search results To: Draic Kin <drekin(a)gmail.com> Hi, The patch was accepted into sphinx. What is missing is a new sphinx release and that this release is installed in docs.python.org. It would be really nice if this functionality is available in docs.python.org (that was the original aim of the patch) but it is outside my reach. Maybe you can e-mail the maintainer of the site. cheers, Hernan On Mon, Jul 29, 2013 at 8:13 AM, Draic Kin <drekin(a)gmail.com> wrote: > Hello, > I have found your nice improvement of Python documentation search > (http://mail.python.org/pipermail/python-ideas/2013-January/018500.html). As > I understand, you have finished the patch of sphinx > (https://bitbucket.org/birkenfeld/sphinx/issue/1067/better-search-results ). > However your improvement doesn't seem to be actually implemented on > docs.python.org. Is there a chance it will be so? It would be very nice if > search on docs.python.org worked like in your improvement > (http://hgrecco.github.io/searchpydocs/). > > Thank you for information, Drekin

2 1

Phyton tutorial als 1 file
by Joseph Melotte Oct. 6, 2013

Oct. 6, 2013

geachte, website http://www.coolpython.nl/tutorials/tut/tut.html is deze tutorial ook te downloade als 1 file ? indien ja, graag dan de website. vriendelijke groeten, Melotte Joseph in B

2 1

possible bug in regular expression documentation
by Bart Aelterman Oct. 6, 2013

Oct. 6, 2013

Dear, While reading the python documentation, chapter 7.2 "Regular expression operations", I noticed a sentence that could be experienced as confusing: " \d When the UNICODE flag is not specified, matches any decimal digit; this is equivalent to the set [0-9]. With UNICODE, it will match whatever is classified as a decimal digit in the Unicode character properties database. " I have a problem with "decimal digit". These patterns match only one character. Therefore, one character can never be decimal, as that would imply the presence of at least one digit and a decimal character (dot). I would propose to delete the word "decimal". \d matches a digit. Unless you want to say that \d+ matches a decimal digit, for instance "2.2". But when I try that in ipython, \d+ only matches "2". I hope my comment was helpful! Thanks for all the great efforts! Bart

2 1

Possible document issue.
by Issaria Peng Oct. 6, 2013

Oct. 6, 2013

2 1

Documention bug
by Owen Johnson Oct. 6, 2013

Oct. 6, 2013

On page: http://docs.python.org/3.0/library/csv.html Under Examples: ---- The simplest example of reading a CSV file: import csv reader = csv.reader(open("some.csv", "rb")) for row in reader: print(row) ---- Code works in python 2, but in python 3, it throws error: ---- Traceback (most recent call last): File "WeeklyDepletionParser.py", line 3, in <module> for row in reader: _csv.Error: iterator should return strings, not bytes (did you open the file in text mode?) ---- Fix was straightforward to change parameter "rb" to "rt". I am running: Python 3.3.2 (v3.3.2:d047928ae3f6, May 13 2013, 13:52:24) [GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin Owen

2 1