Mailman 3 October 2012 - docs

[issue12825] Missing and incorrect link to a command line option.
by Kyle Simpson April 23, 2013

April 23, 2013

New submission from Kyle Simpson <illwhipyou(a)gmail.com>: The documentation for the runpy module has a link to the -m command line option. In version 2.7.2 of the docs, the link doesn't exist. http://docs.python.org/release/2.7/library/runpy.html http://docs.python.org/release/2.7.2/library/runpy.html If you run touch library/runpy.rst make html then the link is created, but with an anchor of "cmdoption-unittest-discover-m" instead of "cmdoption-m". http://docs.python.org/release/2.7.2/using/cmdline.html#cmdoption-unittest-… ---------- assignee: docs@python components: Documentation messages: 142797 nosy: Kyle.Simpson, docs@python priority: normal severity: normal status: open title: Missing and incorrect link to a command line option. versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12825> _______________________________________

2 3

[issue15575] Tutorial is unclear on multiple imports of a module.
by Roy Smith April 21, 2013

April 21, 2013

New submission from Roy Smith: Opening this bug at Ben Finney's request. See https://groups.google.com/forum/?fromgroups#!topic/comp.lang.python/wmDUrpW… for the full thread discussing the problem. Here's a significant excerpt: ------------------------------------------------- The tutorial is misleading on this. It it says plainly: A module can contain executable statements as well as function definitions. […] They are executed only the *first* time the module is imported somewhere. <URL:http://docs.python.org/tutorial/modules.html> but it doesn't make clear that a module can exist in the ‘sys.modules’ list multiple times under different names. ------------------------------------------------- Also note: -------------------------------------------------- The footnote to that is wrong too: > [1] In fact function definitions are also ‘statements’ that are ‘executed’; the execution of a module-level function enters the function name in the module’s global symbol table. I think what it's supposed to say is "... the execution of a module-level def statement ..." --------------------------------------------------- ---------- assignee: docs@python components: Documentation messages: 167628 nosy: docs@python, roysmith priority: normal severity: normal status: open title: Tutorial is unclear on multiple imports of a module. type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15575> _______________________________________

5 5

[issue13510] Clarify that readlines() is not needed to iterate over a file
by Peter Otten April 15, 2013

April 15, 2013

New submission from Peter Otten <__peter__(a)web.de>: I've been looking at code on the tutor mailing list for some time, and for line in file.readlines(): ... is a common idiom there. I suppose this is because the readlines() method is easily discoverable while the proper way (iterate over the file object directly) is not. A note added to the readlines() documentation might help: """ You don't need the readlines() method to loop over the lines of a file. for line in file: process(line) consumes less memory and is often faster. """ ---------- assignee: docs@python components: Documentation messages: 148679 nosy: docs@python, potten priority: normal severity: normal status: open title: Clarify that readlines() is not needed to iterate over a file type: feature request _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13510> _______________________________________

12 21

[issue13050] RLock support the context manager protocol but this is not documented
by Brian Brazil April 14, 2013

April 14, 2013

New submission from Brian Brazil <brian.brazil(a)gmail.com>: This is already documented: http://docs.python.org/library/threading.html#using-locks-conditions-and-se… ---------- nosy: +bbrazil _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13050> _______________________________________

6 5

compileall module: exclusion example is path separator-specific
by Paul A. Giannaros April 14, 2013

April 14, 2013

Hi, The docs for compileall give an example of compiling pyc files in a directory while excluding '.svn' subdirectories: compileall.compile_dir('Lib/', rx=re.compile('/[.]svn'), force=True) Neither this part nor documentation for the 'rx' attribute make clear that the paths searched with the regular expression will have OS specific separators. This example doesn't work on Windows, for example. I think the example should be explicit that the paths will contain the native separators (or it should use pathsep instead of '/', or maybe '[/\\]', to make it clearer in the example). Thanks, Paul

2 1

Bug in the Reference Data Model
by Ted Yin April 14, 2013

April 14, 2013

It's said that : When it would yield a class method object, it is transformed into a bound user-defined method object whose im_class and im_self attributes are both C. in the Reference <http://docs.python.org/reference/datamodel.html> And I did an EX. >>> class C(object) : ... @classmethod ... def cm(cls) : print cls ... >>> C.cm <bound method type.cm of <class '__main__.C'>> >>> C.cm.im_self <class '__main__.C'> >>> C.cm.im_class <type 'type'> It's not hard for me to understand the result. But unfortunately, in the reference, it's told that im_self should be *the same* as im_class. And in my opinion , 'im_self' shold be C, but im_class is 'type' since C's metaclass is type. So they're obviously *not* 'both C'. -- [This information is automatically generated] *ted.sybil* aka. *ymfoi* aka. *Ted Yin*

2 2

Bug Report: Incorrect Abstract Method Requirements in numbers.Integral Documentation
by Lefavor, Matthew (GSFC-582.0)[MICROTEL LLC] April 14, 2013

April 14, 2013

To whom it may concern: The documentation for numbers.Integral reports incorrect abstract method requirements for numbers.Integral. The documentation for numbers.Integral (in both Python 2.7 and Python 3.2) states: Subtypes Rational<http://docs.python.org/library/numbers.html#numbers.Rational> and adds a conversion to int<http://docs.python.org/library/functions.html#int>. Provides defaults for float()<http://docs.python.org/library/functions.html#float>, numerator<http://docs.python.org/library/numbers.html#numbers.Rational.numerator>, and denominator<http://docs.python.org/library/numbers.html#numbers.Rational.denominator>, and bit-string operations: <<, >>, &, ^, |, ~. Defaults for operations <<, >>, &, ^, |, and ~ are not provided, and a look at the source code shows that they are all given as abstract methods. In addition, in Python 2.x, numbers.Integral adds an abstract conversion to long. This is not recorded in the documentation. Originally, I was going to report this as a bug, because PEP 3141<http://www.python.org/dev/peps/pep-3141/> (the PEP that specifies the numbers module) goes so far as to include the <<, >>, &, ^, |, and ~ in the source code for numbers.Integral. It looks like somebody already had reported this years ago, however, to python-dev with Issue 3056<http://bugs.python.org/issue3056>. The issue was never resolved, but has since been closed. Since the development community does not seem interested in adding these features, the features should be removed from documentation. Thank you for your time, Matthew Lefavor NASA GSFC [Microtel, LLC] Mail Code 699.0/Org Code 582.0 matthew.lefavor(a)nasa.gov (301) 614-6818 (Desk) (443) 758-4891 (Cell)

2 1

'Bug' in modules tutorial
by Wenceslao Grillo April 14, 2013

April 14, 2013

Hi, guys, I'm only starting out with Python, and the docs are a great help. Congrats on an excelent work! Found a bug though: in <http://docs.python.org/tutorial/modules.html> there's a footnote that reads: In fact function definitions are also 'statements' that are 'executed'; the execution of a module-level function enters the function name in the module's global symbol table. It seems to me it should be: In fact function definitions are also 'statements' that are 'executed'; the execution of a module-level function *definition* enters the function name in the module's global symbol table. Congrats again! Regards: Wences

2 1

integer leak in refcount docs?
by Daniel Shahaf April 14, 2013

April 14, 2013

In <http://docs.python.org/c-api/intro.html#reference-count-details>, the example code reads: 1 int 2 set_all(PyObject *target, PyObject *item) 3 { 4 int i, n; 5 6 n = PyObject_Length(target); 7 if (n < 0) 8 return -1; 9 for (i = 0; i < n; i++) { 10 PyObject *index = PyInt_FromLong(i); 11 if (!index) 12 return -1; 13 if (PyObject_SetItem(target, index, item) < 0) 14 return -1; 15 Py_DECREF(index); 16 } 17 return 0; 18 } Seems to me that line 14 leaks a reference to 'index'; that is: @@ -13,2 +13,4 @@ - if (PyObject_SetItem(target, index, item) < 0) + if (PyObject_SetItem(target, index, item) < 0) { + Py_DECREF(index); return -1; + } Does that make sense?

2 1

Python 3 doc update (re) symbolic group: name validity.
by Patrice Joulain April 14, 2013

April 14, 2013

Hello, I'd like to report a bug dealing with update from Python 2 to Python 3, in the Python 3.x Documentation. Python Standard Library / Chapter 6.2.1 Regular Expression Syntax - says "Group names must be valid Python identifiers" which is not true for 3.x . (?P<name>...) accepts Python 2 valid identifier only (contrary to named fields of collections.namedtuple). I've checked re-HOWTO and tutorial: no specification about valididity of group name, hence no mistake. >>> re.match(r'(?P<DejaVu>test)','test') <_sre.SRE_Match object at 0x00BF25A0> >>> assert 'DéjàVu'.isidentifier() >>> re.match(r'(?P<DéjàVu>test)','test') Traceback (most recent call last): File "C:\Python32\lib\functools.py", line 176, in wrapper result = cache[key] KeyError: (<class 'str'>, '(?P<DéjàVu>test)', 0) During handling of the above exception, another exception occurred: Traceback (most recent call last): File "<stdin>", line 1, in <module> File "C:\Python32\lib\re.py", line 153, in match return _compile(pattern, flags).match(string) File "C:\Python32\lib\re.py", line 255, in _compile return _compile_typed(type(pattern), pattern, flags) File "C:\Python32\lib\functools.py", line 180, in wrapper result = user_function(*args, **kwds) File "C:\Python32\lib\re.py", line 267, in _compile_typed return sre_compile.compile(pattern, flags) File "C:\Python32\lib\sre_compile.py", line 491, in compile p = sre_parse.parse(p, flags) File "C:\Python32\lib\sre_parse.py", line 692, in parse p = _parse_sub(source, pattern, 0) File "C:\Python32\lib\sre_parse.py", line 315, in _parse_sub itemsappend(_parse(source, state)) File "C:\Python32\lib\sre_parse.py", line 552, in _parse raise error("bad character in group name") sre_constants.error: bad character in group name >>> => From Lib\sre_parse.py: def isident(char): return "a" <= char <= "z" or "A" <= char <= "Z" or char == "_" def isdigit(char): return "0" <= char <= "9" def isname(name): # check that group name is a valid stringEnvoyer if not isident(name[0]): return False for char in name[1:]: if not isident(char) and not isdigit(char): return False return True Thank you for dealing this report (Sorry for my bad english). Waiting for some response: <pat.jln(a)hotmail.fr>

2 1