Mailman 3 August 2012 - docs

Layout problems at http://docs.python.org/library/re.html
by keith.briggs＠bt.com 05 Aug '12

05 Aug '12

At section 7.2.5.2, everything goes black to the end of the document. Tried on several different browsers and OSs. Keith [cid:image001.png@01CD6BEE.7B3016B0]

2 1

Typo
by Gaston Fiore 04 Aug '12

04 Aug '12

Hello, There's a typo in the 3.2.3 Documentation, The Python Tutorial, 6.2. Standard Modules. In line 3 of that section, there's a . missing right after the word "platform". The tutorial currently reads: "The set of such modules is a configuration option which also depends on the underlying platform For example, the winreg module is only provided on Windows systems." It should read: "The set of such modules is a configuration option which also depends on the underlying platform. For example, the winreg module is only provided on Windows systems." Best, -Gaston

2 1

index directives for section text
by Chris Jerdonek 02 Aug '12

02 Aug '12

When marking section text for inclusion in the index, is there a preference for whether the index directive should occur immediately before or after the section header? For example, "generator, function" in the index links here: http://docs.python.org/dev/reference/datamodel.html#index-36 But the "Generator functions" header is not visible after clicking the link without scrolling (at least for me) because the directive appears after the header in reference/datamodel.rst: Generator functions .. index:: single: generator; function single: generator; iterator This seems like common practice in some areas of the documentation, but it seems like the result might be less desirable. Thanks, --Chris

1 1

[issue15521] Dev Guide should say how to run tests in 2.7
by Chris Jerdonek 02 Aug '12

02 Aug '12

New submission from Chris Jerdonek: The Dev Guide should say the preferred way (or even a way) to run tests using the Python 2.7 build: http://docs.python.org/devguide/runtests.html This will help submitters who want to check that their patch works with 2.7. In Python 2.7, this did not work (for obvious reasons): $ ./python.exe -m test .../python.exe: No module named test.__main__; 'test' is a package and cannot be directly executed But this did: $ ./python.exe -m test.regrtest Is the latter the preferred way? ---------- assignee: docs@python components: Devguide, Documentation keywords: easy messages: 167099 nosy: cjerdonek, docs@python, ezio.melotti priority: normal severity: normal stage: needs patch status: open title: Dev Guide should say how to run tests in 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15521> _______________________________________

3 7

docs August 2012