Mailman 3 May 2010 - docs

Bug in Python xml document
by WANG Yanchao 12 May '10

12 May '10

http://docs.python.org/library/xml.dom.html#attr-objects Attr.value should be added here. I know this may be a common knowledge, but for a new learner, it may be confusing. Thanks! Yanchao WANG

2 1

Typo in io.rst and meta-question about patches workflow
by Éric Araujo 10 May '10

10 May '10

Hello everyone In trunk’s Doc/library/io.rst, a change from IOError to ValueError has left a stray “an”: --- Doc/library/io.rst Sat May 01 14:16:39 2010 +0200 +++ Doc/library/io.rst Sat May 01 15:26:32 2010 +0200 @@ -246,7 +246,7 @@ - (e.g. reading or writing) will raise an :exc:`ValueError`. + (e.g. reading or writing) will raise a :exc:`ValueError`. Is it ok to use the mailing list instead of the bug tracker for such tiny patches? Apart from Georg, are there people with commit power on the list? Do they prefer emails or bug reports? Should we wait until we’ve collected a bunch of typo before reporting them instead of doing it one message per found typo? Regards

2 1

ftplib nit
by Larry Tjoelker 10 May '10

10 May '10

in ftplib docs, http://docs.python.org/library/ftplib.html?highlight=ftplib#module-ftplib, description of ftplib.all_errors 3rd line: "errors made by the caller). This set includes the four exceptions listed below as" It should be: "errors made by the caller). This set includes the four exceptions listed above as"

2 1

minor bugs in doc of python 3.1.2
by Heiner Marxen 10 May '10

10 May '10

Hello, I think I have found a small bug in the python manual. URL: http://docs.python.org/py3k/reference/lexical_analysis.html chapter: 2.4.1. String and Bytes literals, Notes 4.: replace "exactly two hex digits" by "exactly four hex digits". An additional note from a python newbie, reading the doc the first time: At the very end of the above URL, there is clearly stated, that the characters $ and ? are immediate errors (outside strings and comments). But what about the backtick character ` (\x60)? I do not find it mentioned anywhere, definitely not inside that URL. Shouldn't that char then be mentioned in the bottom section? Otherwise: many thanks for the really good documentation! Regards, -- Heiner Marxen http://www.drb.insel.de/~heiner/

2 1

Dead Link
by Ralf Ganswindt 10 May '10

10 May '10

Hello, The following link: ------------------------ See also http://www.pysqlite.orgThe pysqlite web page – sqlite3 is developed externally under the name “pysqlite”.------------------------in the Python Library documentation, section 11.13.sqlite3, " http://docs.python.org/library/sqlite3.html," appears to be a dead link. Is "http://code.google.com/p/pysqlite/" the correct new location? Ralf Ganswindt RalfGanswindt(a)gmail.com

2 1

[issue8642] json.loads description
by MATSUI Tetsushi 10 May '10

10 May '10

New submission from MATSUI Tetsushi <mft(a)users.sourceforge.net>: At the end of description of json.loads, dump() should be load(). ---------- assignee: docs@python components: Documentation messages: 105187 nosy: docs@python, mft priority: normal severity: normal status: open title: json.loads description versions: Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8642> _______________________________________

3 4

[issue8676] Py3k Built-in Exceptions documentation mentions the raise statement of 2.x
by Daniel Urban 10 May '10

10 May '10

New submission from Daniel Urban <urban.dani+py(a)gmail.com>: In the documentation of the exceptions (http://docs.python.org/dev/py3k/library/exceptions) there is a sentence: "The associated value is the second argument to the raise statement." But in py3k there is a different raise statement than in 2.x. ---------- assignee: docs@python components: Documentation messages: 105457 nosy: docs@python, durban priority: normal severity: normal status: open title: Py3k Built-in Exceptions documentation mentions the raise statement of 2.x versions: Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8676> _______________________________________

2 1

doc bug: undocumented fields in tarfile.TarInfo
by Ravi Pinjala 10 May '10

10 May '10

Hi, In the tarfile.TarInfo class, the devmajor and devminor fields are undocumented. tarfile supports character and block devices, but the undocumented fields are the only way to access the major/minor device numbers and actually make use of this support. These fields are only set for character and block devices. --Ravi Pinjala

1 0

Currently there is no warning in the python doc that using open() on user or other controlled filenames is dangerous.
by dave b 10 May '10

10 May '10

Currently there is no warning in the python doc that using open() on user or other controlled filenames is dangerous. I think that a warning should be in the documentation to say that if you are using open() and you do not have a set file parameter (hard-coded) then you *SHOULD* check the filename will not escape or point to places that are not desired. Personally I feel that python should have an open() argument to say "do not go out side FOO directory".

1 0

[issue8671] A small erorr on http://docs.python.org/library/re.html
by bones7456 09 May '10

09 May '10

New submission from bones7456 <bones7456(a)gmail.com>: In section \b , original text is: Matches the empty string, but only at the beginning or end of a word. A word is defined as a sequence of alphanumeric or underscore characters, so the end of a word is indicated by whitespace or a non-alphanumeric, non-underscore character. Note that \b is defined as the boundary between \w and \ W, so the precise set of characters deemed to be alphanumeric depends on the values of the UNICODE and LOCALE flags. Inside a character range, \b represents the backspace character, for compatibility with Python’s string literals. NOTE: there is space between "\" and "W", I think it is not needed. ---------- assignee: docs@python components: Documentation messages: 105391 nosy: bones7456, docs@python priority: normal severity: normal status: open title: A small erorr on http://docs.python.org/library/re.html versions: Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8671> _______________________________________

2 1