Mailman 3 May 2011 - docs

[issue8158] Docstring of optparse.OptionParser incomplete
by Bryce Verdier 04 May '11

04 May '11

Bryce Verdier <bryceverdier(a)gmail.com> added the comment: Applied patch cleanly. Also the description reads clearly and makes sense. ---------- nosy: +louiscipher _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8158> _______________________________________

1 0

[issue11985] Document that platform.python_implementation supports PyPy
by Éric Araujo 04 May '11

04 May '11

New submission from Éric Araujo <merwok(a)netwok.org>: The docstring and reST doc of platform.python_implementation mention possible return values of CPython, IronPython and Jython, but if I understand the code correctly, PyPy is supported too. ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 135050 nosy: docs@python, eric.araujo, lemburg priority: normal severity: normal status: open title: Document that platform.python_implementation supports PyPy versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11985> _______________________________________

4 6

[issue11834] wrong module installation dir on Windows
by anatoly techtonik 04 May '11

04 May '11

New submission from anatoly techtonik <techtonik(a)gmail.com>: http://docs.python.org/install/index.html#how-installation-works Correct standard installation location for third-party modules on Windows for Python 2.x is prefix/Lib/site-packages ---------- assignee: docs@python components: Documentation messages: 133571 nosy: docs@python, techtonik priority: normal severity: normal status: open title: wrong module installation dir on Windows versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11834> _______________________________________

8 18

[issue11988] special method lookup docs don't address some important details
by R. David Murray 03 May '11

03 May '11

New submission from R. David Murray <rdmurray(a)bitdance.com>: The following code: -------------------------------- class X(list): def __contains__(self, key): print('X contains:', key) class Y(): def __init__(self, x): self.x = x def __getattr__(self, key): return getattr(self.x, key) def __iter__(self): print('Y iter') return iter([1,2]) x = X() y = Y(x) print('res:', 1 in y) ----------------------------- prints True. It has been explained to me that this is because of: http://docs.python.org/reference/datamodel.html#special-method-lookup-for-n… However, there is no way in the world that I would guess the behavior above from the documentation provided (and I find it surprising...I expected x's __contains__ to get called because Y (a class, not an instance) doesn't have a __contains__ method). Can anyone explain it more clearly and update the documentation? ---------- assignee: docs@python components: Documentation messages: 135068 nosy: docs@python, r.david.murray priority: normal severity: normal stage: needs patch status: open title: special method lookup docs don't address some important details type: behavior versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11988> _______________________________________

5 6

[issue4966] Improving Lib Doc Sequence Types Section
by Ezio Melotti 02 May '11

02 May '11

Ezio Melotti <ezio.melotti(a)gmail.com> added the comment: See also #11975 and #11976. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue4966> _______________________________________

1 0

[issue11974] Class definition gotcha.. should this be documented somewhere?
by Ezio Melotti 02 May '11

02 May '11

Ezio Melotti <ezio.melotti(a)gmail.com> added the comment: A good place where to add it would be http://docs.python.org/tutorial/classes.html. It might even get a small "Differences between class and instance attribute" section. ---------- nosy: +ezio.melotti _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11974> _______________________________________

1 0

[issue11974] Class definition gotcha.. should this be documented somewhere?
by Georg Brandl 01 May '11

01 May '11

Georg Brandl <georg(a)python.org> added the comment: Reclassifying as documentation issue. I was certain we had something about this in the tutorial, but couldn't find it with a quick look. It is in the FAQ ("how do I create static class data"), but that's not an obvious place to look. ---------- assignee: -> docs@python components: +Documentation -Interpreter Core nosy: +docs@python, georg.brandl _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11974> _______________________________________

1 0

[issue11976] Provide proper documentation for list data type
by Jonas H. 01 May '11

01 May '11

New submission from Jonas H. <jonas(a)lophus.org>: Provide a proper `list` method reference (like the one for `dict`, http://docs.python.org/library/stdtypes.html#dict). Right now, documentation about lists is spread over multiple topics (.rst files) and methods are documented in footnotes. Also, intersphinx-ing and list methods is not possible -- :meth:`list.foo` does not create any links due to missing documentation. This is also related to #11975. ---------- assignee: docs@python components: Documentation messages: 134924 nosy: docs@python, jonash priority: normal severity: normal status: open title: Provide proper documentation for list data type _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11976> _______________________________________

2 1

[issue11971] Wrong parameter -O0 instead of -OO in manpage
by Lars Michelsen 01 May '11

01 May '11

New submission from Lars Michelsen <lm(a)larsmichelsen.com>: Hello Devs, digging around in the python manpage and playing with the parameters I found a wrong parameter specification in the python manpage. The -OO parameter for discarding docstrings is written as -O0 (the 2nd is a zero). A patch is attached. Regards ---------- assignee: docs@python components: Documentation files: fix-OO-param.patch keywords: patch messages: 134909 nosy: docs@python, lm priority: normal severity: normal status: open title: Wrong parameter -O0 instead of -OO in manpage versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4 Added file: http://bugs.python.org/file21846/fix-OO-param.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11971> _______________________________________

3 2