Mailman 3 July 2012 - docs

[issue15265] random.sample() docs unclear on k < len(population)
by Roy Smith 09 Jul '12

09 Jul '12

New submission from Roy Smith <roy(a)panix.com>: The docs don't say what happens if you call random.sample() with a population smaller than k. Experimentally, it raises ValueError, but this should be documented. I would have guessed it would return IndexError, by analogy to random.choice(). ---------- assignee: docs@python components: Documentation messages: 164742 nosy: docs@python, roysmith priority: normal severity: normal status: open title: random.sample() docs unclear on k < len(population) type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15265> _______________________________________

5 7

[issue13557] exec of list comprehension fails on NameError
by Roundup Robot 09 Jul '12

09 Jul '12

Roundup Robot <devnull(a)psf.upfronthosting.co.za> added the comment: New changeset ab22ffa6fb2e by Terry Jan Reedy in branch '2.7': Issue #13557: Clarify effect of giving two different namespaces to exec or http://hg.python.org/cpython/rev/ab22ffa6fb2e New changeset ea670d71a36d by Terry Jan Reedy in branch '3.2': Issue #13557: Clarify effect of giving two different namespaces to exec or http://hg.python.org/cpython/rev/ea670d71a36d New changeset b47ae7a9e685 by Terry Jan Reedy in branch 'default': Merge 3.2 closes issue 13557 http://hg.python.org/cpython/rev/b47ae7a9e685 ---------- nosy: +python-dev resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13557> _______________________________________

1 0

[issue15270] "Economy of Expression" section outdated
by Raymond Hettinger 08 Jul '12

08 Jul '12

Raymond Hettinger <raymond.hettinger(a)gmail.com> added the comment: The point was that the docs shouldn't "write a book" where briefer explanations suffice. The mention of super() may not be the best example because many "experts" still don't get what it is all about regardless of how much or how little much is written. FWIW, the original two short paragraphs led to a good deal of confusion resulting in people declaring super() to be either inscrutable, unusable, or both. ---------- assignee: docs@python -> rhettinger priority: normal -> low _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15270> _______________________________________

1 0

A bug in documentation in argparse
by Xan 07 Jul '12

07 Jul '12

Hi, Just a comment, please put in argparse documentation that in add_argument we could not combine with success type and nargs='?'. For example: parser.add_argument("-m", "--mostrar", nargs='+', type=int) does not check if all elements in list (1 or more) are integers or not. I don't know if it's a bug in argparse or if this behaviour is intentionally this way. In last case, please upgrade the documentation. Thanks in advance, Xan.

1 0

[issue13557] exec of list comprehension fails on NameError
by Florent Xicluna 07 Jul '12

07 Jul '12

Florent Xicluna <florent.xicluna(a)gmail.com> added the comment: Issue #11796 marked as duplicate of this one. However the issue described in #11796 does not involve exec/execfile. It is about scopes for list comprehension like this one. Another doc patch should probably be written to cover the case described in #11796 too. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13557> _______________________________________

1 0

[issue13557] exec of list comprehension fails on NameError
by Florent Xicluna 07 Jul '12

07 Jul '12

Changes by Florent Xicluna <florent.xicluna(a)gmail.com>: ---------- nosy: +Trundle, anikom15, daniel.urban, flox, jonathan.hartley, josmiley, michael.foord, mjs0, rhettinger _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13557> _______________________________________

1 0

[issue11796] Comprehensions in a class definition mostly cannot access class variable
by Florent Xicluna 07 Jul '12

07 Jul '12

Florent Xicluna <florent.xicluna(a)gmail.com> added the comment: It looks as a duplicate of issue 13557. I close this one, because a doc patch is attached on the other. ---------- resolution: -> duplicate status: open -> closed superseder: -> exec of list comprehension fails on NameError _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11796> _______________________________________

1 0

[issue11786] ConfigParser.[Raw]ConfigParser optionxform()
by Adam Groszer 07 Jul '12

07 Jul '12

New submission from Adam Groszer <agroszer(a)gmail.com>: The documentation http://docs.python.org/library/configparser.html states that optionxform() is used only beginning ConfigParser.ConfigParser, whereas it is ALSO in effect for ConfigParser.RawConfigParser. (As I checked in the source) ---------- assignee: docs@python components: Documentation messages: 133148 nosy: Adam.Groszer, docs@python priority: normal severity: normal status: open title: ConfigParser.[Raw]ConfigParser optionxform() type: behavior versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11786> _______________________________________

5 10

[issue14879] invalid docs for subprocess exceptions with shell=True
by anatoly techtonik 07 Jul '12

07 Jul '12

New submission from anatoly techtonik <techtonik(a)gmail.com>: http://docs.python.org/library/subprocess.html#exceptions documentation is wrong at least for the case when shell=True on Linux. An attempt to execute a non-existent file with: process = subprocess.Popen("sdfsdf", shell=True, stdout=subprocess.PIPE, stderr=errpipe) out, err = process.communicate() print out Results in a message "/bin/sh: sfs: command not found" with no exceptions. Other statements may be invalid too. ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 161329 nosy: docs@python, techtonik priority: normal severity: normal status: open title: invalid docs for subprocess exceptions with shell=True versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14879> _______________________________________

5 6

What BUGS me
by Joshua Lawless 07 Jul '12

07 Jul '12

Hi im Josh, I really want to learn your programming language but the tutorial just confuses me the more I know the more I realise I dont know. I feel that it doesnt explain everything clearly as if the person who wrote it had so much on his mind to put on the paper he skipped crucial parts which would make the whole thing make sense. I dont like giving greif or bad comments or even constructive critisism especially when someone has gone out of their way to make something for a bunch of peope free of charge but to learn your language this I feel this really needs to be addressed so that everybody can earn your programming language. Please read this and hopefully even do something about it, it will benefit a whole bunch of people other than me to try learning your programming language, I know it sounds selfish it kind of is but wouldn't it benefit you more aswell if more people could use your programming language? thanks for reading this i hope it helps kind regards Josh

2 1