Mailman 3 September 2010 - docs

2.6 documentation
by michael weaser 17 Oct '10

17 Oct '10

i cant download the 2.6 documentation from docs.python.org/release/2.6

2 1

logging.Formatter processName added in 2.7
by Marvin Greenberg 17 Oct '10

17 Oct '10

But the documentation does not say that, although it does say that funcName was added in 2.5

2 1

Example values for dict()
by Nate Vack 17 Oct '10

17 Oct '10

Hi all, The docs on creating new dicts found here: http://docs.python.org/library/stdtypes.html#dict just warped my mind a little bit. They all create the dict {'one': 2, 'two', 3} -- creating {'one': 1, 'two': 2} would make a little more sense. Cheers, -Nate

2 1

Algorithm error
by eric.takada＠embraer.com.br 17 Oct '10

17 Oct '10

Hi, in section "4.4 break and continue Statements, and else Clauses on Loops" there is an error in the example code. The "range" in "for x in range(2, n): " shall be changed to "range(1,n):" in order to produce the output described in the example, since "range[2,2]" produces a null result. Regards, Eric Takada This message is intended solely for the use of its addressee and may contain privileged or confidential information. All information contained herein shall be treated as confidential and shall not be disclosed to any third party without Embraer?s prior written approval. If you are not the addressee you should not distribute, copy or file this message. In this case, please notify the sender and destroy its contents immediately. Esta mensagem é para uso exclusivo de seu destinatário e pode conter informações privilegiadas e confidenciais. Todas as informações aqui contidas devem ser tratadas como confidenciais e não devem ser divulgadas a terceiros sem o prévio consentimento por escrito da Embraer. Se você não é o destinatário não deve distribuir, copiar ou arquivar a mensagem. Neste caso, por favor, notifique o remetente da mesma e destrua imediatamente a mensagem.

2 1

Missing links on page http://docs.python.org/release/2.6/download
by OPITZ Christian (D3S) 17 Oct '10

17 Oct '10

Missing links on page http://docs.python.org/release/2.6/download. All links are missing the version number 2.6 inside the file names. Mailto link is not working. Tested with Mozilla/5.0 (Windows; U; Windows NT 5.1; de; rv:1.9.1.3) Gecko/20090824 Firefox/3.5.3 -- Mit freundlichen Grüßen/Best regards Dipl.-Ing. Christian Opitz Systemplanungsingenieur TB/EII - Rail Signalling Solutions Thales Deutschland - Ground Transportation Solutions Phone: +49(0)30-688 306-430 Fax: +49(0)30-688 306-302 E-Mail: Christian.Opitz(a)thalesgroup.com -------------------------------------------------------------- Thales Rail Signalling Solutions GmbH Colditzstrasse 34-36 - 12099 Berlin - Germany --------------------------------------------------------------

2 1

Bug ?
by Antoine Dechaume 17 Oct '10

17 Oct '10

Hi, HERE It seems __setstate__ requires an argument, like in the examples, but the method doc do not mention it at all. Antoine.

2 1

[issue9237] Add sys.call_tracing to on-line sys module documentation
by rocky bernstein 17 Oct '10

17 Oct '10

New submission from rocky bernstein <rocky(a)gnu.org>: sys.call_tracing doesn't appear in Python documents and I think it should. For a start, one could use the docstring from sysmodule.c: call_tracing(func, args) -> object Call func(*args), while tracing is enabled. The tracing state is saved, and restored afterwards. This is intended to be called from a debugger from a checkpoint, to recursively debug some other code. Thanks. ---------- assignee: docs@python components: Documentation messages: 110145 nosy: docs@python, rocky priority: normal severity: normal status: open title: Add sys.call_tracing to on-line sys module documentation type: feature request versions: Python 2.5, Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9237> _______________________________________

3 2

[issue9204] The documentation of PyType_Type in py3k mentions types.TypeType
by Daniel Urban 17 Oct '10

17 Oct '10

New submission from Daniel Urban <urban.dani+py(a)gmail.com>: The documentation of PyType_Type (http://docs.python.org/dev/py3k/c-api/type.html#PyType_Type) is this: "This is the type object for type objects; it is the same object as type and types.TypeType in the Python layer." But in py3k there is no types.TypeType object. ---------- assignee: docs@python components: Documentation messages: 109560 nosy: docs@python, durban priority: normal severity: normal status: open title: The documentation of PyType_Type in py3k mentions types.TypeType versions: Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9204> _______________________________________

3 2

[issue9195] Link in docs from "String Formatting Operations" to "Template Strings"
by Craig McQueen 17 Oct '10

17 Oct '10

New submission from Craig McQueen <python(a)craig.mcqueen.id.au>: I stumbled across "Template Strings" of PEP 292 by accident recently. I'd never heard of it before. I'm familiar with the "string interpolation" aka "String Formatting Operations", and I know to find that in the docs under "Standard Types", i.e. http://docs.python.org/library/stdtypes.html#string-formatting-operations http://docs.python.org/py3k/library/stdtypes.html#old-string-formatting-ope… It would be good for that documentation to mention "Template Strings", and include a cross-reference to the docs for it, since it was created as an alternative string formatting. I.e. cross-reference to http://docs.python.org/library/string.html#template-strings http://docs.python.org/py3k/library/string.html#template-strings ---------- assignee: docs@python components: Documentation messages: 109515 nosy: cmcqueen1975, docs@python priority: normal severity: normal status: open title: Link in docs from "String Formatting Operations" to "Template Strings" versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9195> _______________________________________

4 3

[issue9138] Tutorial: classes intro paragraph icky
by Aahz 17 Oct '10

17 Oct '10

New submission from Aahz <aahz(a)pythoncraft.com>: http://docs.python.org/dev/tutorial/classes.html Chapter 9 of the Tutorial contains this intro paragraph: Python's class mechanism adds classes to the language with a minimum of new syntax and semantics. It is a mixture of the class mechanisms found in C++ and Modula-3. As is true for modules, classes in Python do not put an absolute barrier between definition and user, but rather rely on the politeness of the user not to "break into the definition." The most important features of classes are retained with full power, however: the class inheritance mechanism allows multiple base classes, a derived class can override any methods of its base class or classes, and a method can call the method of a base class with the same name. Objects can contain an arbitrary amount of data. A coworker found particularly the third sentence incomprehensible, and even with ten years of Python under my belt, I can't say that it makes much more sense to me. I know what it must be trying to say and therefore proffer this suggested rewrite: Compared with other programming languages, Python's class mechanism adds classes with a minimum of new syntax and semantics. It is a mixture of the class mechanisms found in C++ and Modula-3. Python classes provide all the standard features of Object Oriented Programming: the class inheritance mechanism allows multiple base classes, a derived class can override any methods of its base class or classes, and a method can call the method of a base class with the same name. Objects can contain arbitrary amounts and kinds of data. As is true for modules, classes partake of the dynamic nature of Python; users of a class can modify or break the class definition even without changing the source code. ---------- assignee: docs@python components: Documentation messages: 109080 nosy: aahz, docs@python priority: critical severity: normal stage: patch review status: open title: Tutorial: classes intro paragraph icky type: behavior versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9138> _______________________________________

4 4