Mailman 3 November 2010 - docs

[issue10396] stdin argument to pdb.Pdb doesn't work unless you also set Pdb.use_rawinput = False
by R. David Murray 19 Nov '10

19 Nov '10

R. David Murray <rdmurray(a)bitdance.com> added the comment: The argument against adding this to the pdb docs is that if you pull in that statement from cmd, you really ought to pull in the full description of the __init__ arguments. And whether you do that or just pull in that single statement, you are duplicating the documentation from cmd. This *may* be best, but it does increase the maintenance burden, since any change to cmd will require changes to both the cmd and pdb docs, whereas now someone changing cmd doesn't need to know that they also have to update pdb. If the situation being documented here improves in some way, I'll bet we will forget to update the pdb docs accordingly.... So, I'm -1 on adding this to the pdb docs, but will bow to the wisdom of the doc folks :) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10396> _______________________________________

1 0

[issue9921] os.path.join('x','') behavior
by Éric Araujo 19 Nov '10

19 Nov '10

Éric Araujo <merwok(a)netwok.org> added the comment: Comment in ntpath.isabs: For Windows it is absolute if it starts with a slash or backslash (current volume), or if a pathname after the volume-letter-and-colon or UNC-resource starts with a slash or backslash. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9921> _______________________________________

1 0

[issue9921] os.path.join('x','') behavior
by R. David Murray 19 Nov '10

19 Nov '10

R. David Murray <rdmurray(a)bitdance.com> added the comment: "first part" by itself sounds like there can only be two parts. How about 'inserts a separator between each pair of...' Also, what does 'absolute' mean on Windows? Does it include the drive? If so, the second sentence should probably say 'if a part starts with a separator...' (Assuming, of course, that that's how ntpath.join actually works). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9921> _______________________________________

1 0

[issue10396] stdin argument to pdb.Pdb doesn't work unless you also set Pdb.use_rawinput = False
by Éric Araujo 19 Nov '10

19 Nov '10

Éric Araujo <merwok(a)netwok.org> added the comment: +1 on clarifying the docs. Michael, where in the file do you think it should go? (You can also directly make a diff if you want.) ---------- assignee: -> docs@python components: +Documentation -Library (Lib) keywords: +patch nosy: +docs@python, eric.araujo resolution: duplicate -> stage: committed/rejected -> patch review status: closed -> open superseder: cmd.py always uses raw_input, even when another stdin is specified -> versions: +Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10396> _______________________________________

1 0

[issue9921] os.path.join('x','') behavior
by Éric Araujo 19 Nov '10

19 Nov '10

Éric Araujo <merwok(a)netwok.org> added the comment: I think the comment is fine as is. +1 to adding your wording to the docs. ---------- keywords: +patch nosy: +eric.araujo stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9921> _______________________________________

1 0

[issue9921] os.path.join('x','') behavior
by Éric Araujo 19 Nov '10

19 Nov '10

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- Removed message: http://bugs.python.org/msg118372 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9921> _______________________________________

1 0

[issue8158] Docstring of optparse.OptionParser incomplete
by Éric Araujo 19 Nov '10

19 Nov '10

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- title: documentation of 'optparse' module incomplete -> Docstring of optparse.OptionParser incomplete _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8158> _______________________________________

1 0

[issue9182] document “--” as a way to distinguish option w/ narg='+' from positional argument in argparse
by Éric Araujo 19 Nov '10

19 Nov '10

Éric Araujo <merwok(a)netwok.org> added the comment: You’re right, sorry I was unclear: “a patch for that” referred to the addition of “--” in the generated usage text. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9182> _______________________________________

1 0

[issue9182] document “--” as a way to distinguish option w/ narg='+' from positional argument in argparse
by Steven Bethard 19 Nov '10

19 Nov '10

Steven Bethard <steven.bethard(a)gmail.com> added the comment: The original point is basically a duplicate of issue 9338. It is undesirable behavior, I just don't know how to fix it. Patches to fix it are welcome (on issue 9338). ;-) As to documenting '--', I agree it's hidden too far down in the documentation currently. I'd be happy to approve any documentation patch that makes the '--' workaround more visible. ---------- versions: -Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9182> _______________________________________

1 0

[issue8890] Use tempfile instead of /tmp in examples
by Éric Araujo 19 Nov '10

19 Nov '10

Éric Araujo <merwok(a)netwok.org> added the comment: Patch submission guidelines are found at http://www.python.org/dev/patches/ Since patches are made for the py3k branch, some matches in Henri’s grep won’t get patched: bsddb, compiler, posixfile and rexec have been removed. The person that will commit the patch will have to edit those too when merging into 2.7, unless a kind soul provides one patch per branch (not a requirement). Last remark: tempfile is a false positive; editing old whatsnew is not worth it IMO. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8890> _______________________________________

1 0