Mailman 3 December 2010 - docs

2.1. Invoking the Interpreter
by Suzen, Mehmet 28 Dec '10

28 Dec '10

Hi, There is a bug or an ambiguity on http://docs.python.org/tutorial/interpreter.html It says "Note that there is a difference between 'python file' and 'python <file'. In the latter case, input requests from the program,..." Must read as follows; Execute statements from a file (inputs requested from stdin) $ python file.py Execute statements from a file (inputs requested from file) $ python file.py < input While python <input does not work in my case using Python 2.6.5 (r265:79063, Apr 16 2010, 13:09:56) [GCC 4.4.3] on linux2. Best Wishes, Mehmet Suzen Execute statements from a file (inputs requested from stdin) $ python file.py Execute statements from a file (inputs requested from file) $ python file.py < input

2 1

sys.maxint in Python 3.2 range() documentation
by Christian Taylor 28 Dec '10

28 Dec '10

Hello everyone, just a minor nitpick: The documentation for Python 3.2 (beta) refers to sys.maxint when describing the range function at http://docs.python.org/dev/library/functions.html#range: "Ranges containing absolute values larger than sys.maxint are permitted but some features (such as len()) will raise OverflowError." If I'm not mistaken, this should refer to sys.maxsize. Kind regards, Christian

2 1

[issue10781] minidom Node.writexml method doesn't manage encoding parameter correctly
by Goffi 27 Dec '10

27 Dec '10

Goffi <goffi(a)goffi.org> added the comment: Thanks for your quick reply The last sentence has nothing to do with the report, it was just a general remark that it would be nice if minidom could support unicode string directly. Should I send a mail to docs(a)python.org to report the doc issue, or this one is sufficient ? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10781> _______________________________________

2 1

[issue10781] minidom Node.writexml method doesn't manage encoding parameter correctly
by Martin v. Löwis 27 Dec '10

27 Dec '10

Martin v. Löwis <martin(a)v.loewis.de> added the comment: The documentation is incorrect; writexml does not support an encoding parameter. Only Document nodes support the encoding parameter in writexml, and it is intentional that its only effect is to fill out the XML declaration. I don't understand the last sentence in your report: what is it that you want to see supported, and how is that related to this issue? ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, loewis _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10781> _______________________________________

1 0

[issue7436] Define 'object with assignable attributes'
by Daniel Urban 26 Dec '10

26 Dec '10

Changes by Daniel Urban <urban.dani+py(a)gmail.com>: ---------- nosy: +durban _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7436> _______________________________________

1 0

[issue3216] Scarce msilib documentation
by Éric Araujo 26 Dec '10

26 Dec '10

Éric Araujo <merwok(a)netwok.org> added the comment: Nonexistent parameter removed from the doc in r87489 and following. ---------- nosy: +eric.araujo _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue3216> _______________________________________

1 0

[issue9891] Minor doc typo at datamodel.rst: "list" -> "alist"
by Rodrigo Bernardo Pimentel 26 Dec '10

26 Dec '10

New submission from Rodrigo Bernardo Pimentel <rbp(a)isnomore.net>: The "Built-in methods" item of the "The standard type hierarchy" section of Doc/reference/datamodels.rst uses a list instance called "alist" as an example, and it says "__self__ is set to the object denoted by *list*." It should read "the object denoted by *alist*" This affects all releases, so I've marked them all. But I suppose we don't care about 2.5 anymore. All the others are listed on docs.python.org (or are "trunk"), and I think should be fixed. It's a trivial fix, and a single patch works 2.x and another for 3.x. ---------- assignee: docs@python components: Documentation files: alist_doc-2.x.patch keywords: patch messages: 116757 nosy: docs@python, rbp priority: normal severity: normal status: open title: Minor doc typo at datamodel.rst: "list" -> "alist" versions: Python 2.5, Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3 Added file: http://bugs.python.org/file18914/alist_doc-2.x.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9891> _______________________________________

2 3

[issue8648] The UTF-7 codec functions are undocumented
by Daniel Stutzbach 26 Dec '10

26 Dec '10

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: The UTF-7 codec functions are undocumented: PyUnicode_DecodeUTF7Stateful PyUnicode_DecodeUTF7 PyUnicode_EncodeUTF7 ---------- assignee: docs@python components: Documentation messages: 105207 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: The UTF-7 codec functions are undocumented versions: Python 2.6, Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8648> _______________________________________

4 4

[issue7678] subprocess.Popen pipeline example code in the documentation is lacking
by Éric Araujo 26 Dec '10

26 Dec '10

Éric Araujo <merwok(a)netwok.org> added the comment: As a non-expert user of subprocess, calling close before communicate seems strange to me. Does the example code with a bug work if close is called after communicate? In the 3.2 docs, we could update the example to use a with statement, unless it is deemed a distraction for this simple introductory section. ---------- nosy: +eric.araujo, gregory.p.smith -georg.brandl stage: -> needs patch type: -> behavior versions: +Python 2.7, Python 3.1, Python 3.2 -Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7678> _______________________________________

1 0

[issue7436] Define 'object with assignable attributes'
by Éric Araujo 26 Dec '10

26 Dec '10

Éric Araujo <merwok(a)netwok.org> added the comment: We’d have to be careful to distinguish attributes defined to be not assignable and CPython implementation details. In the absence of a definition in the doc, there is a chicken-and-egg problem, so I think a patch would have to be discussed on python-dev to get answers from the language designers. ---------- nosy: +eric.araujo versions: +Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7436> _______________________________________

1 0