Mailman 3 November 2010 - docs

[issue10149] Data truncation in expat parser
by Éric Araujo Nov. 12, 2010

Nov. 12, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Thanks for the patch. There are a few typos (pices, recive) and markup glitches, which you can fix if you’d like to learn more about the markup, or else leave to someone else. Those glitches are: bad indentation, missing blank line to make a new paragraph, text in backquotes without a :role: (or double backquotes for False). From a checkout, run “make html” to see the result. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10149> _______________________________________

1 0

[issue7186] Document specialness of __doc__, and possibly other "special" attributes
by Éric Araujo Nov. 12, 2010

Nov. 12, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Is this obsoleted by #9451? ---------- nosy: +eric.araujo versions: -Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7186> _______________________________________

1 0

[issue7950] subprocess.Popen documentation should contain a good warning about the security implications when using shell=True
by R. David Murray Nov. 12, 2010

Nov. 12, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: Committed (as a warning) in r86419. Thanks, Chris. ---------- stage: patch review -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7950> _______________________________________

1 0

[issue10379] locale.format() input regression
by R. David Murray Nov. 12, 2010

Nov. 12, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: Well, the distinction is that, before the bug fix that caused your issue, the 'format_string' method would use a regex to extract the % specifiers from the input string, and call 'format' to replace that % specifier with a properly localized result string. That is, 'format' was designed to handle a single % specifier with no extra text, basically as a helper method for format_string. The fact that it didn't reject extra text was, according to an internal comment, a defect of the implementation. (Passing any extra text would cause the implementation to fail to do the internationalization that was the entire reason for calling it.) When I fixed the bug I extracted the 'replace a single % specifier' code into an internal method, and made the format method live up to what I perceived to be its documented interface by rejecting extra input characters so that it could safely call the new internal substitution routine. Now, from the perspective of a *user* of the locale module, I fail to see the point in having both 'format' and 'format_string' exposed. If you want to format a single % specifier, just pass it to format_string. Thus my suggestion to make them both do the same thing (to cater to other code that may be calling format incorrectly) and then deprecate one of them (presumably format). To bad I didn't think of that when I fixed the original bug. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10379> _______________________________________

2 1

[issue7950] subprocess.Popen documentation should contain a good warning about the security implications when using shell=True
by Chris Rebert Nov. 11, 2010

Nov. 11, 2010

Chris Rebert <pybugs(a)rebertia.com> added the comment: "the above Note" mentioned in those last two lines demonstrates shlex.split() and correct tokenization. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7950> _______________________________________

1 0

[issue7950] subprocess.Popen documentation should contain a good warning about the security implications when using shell=True
by Éric Araujo Nov. 11, 2010

Nov. 11, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Looks good to me, except the last two lines which I would reword or just remove. I wonder how many people use shell=True merely for the convenience of passing a string instead of a list. What do you think about adding a mention of str.split and shlex.split? ---------- nosy: +eric.araujo type: security -> behavior versions: -Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7950> _______________________________________

1 0

[issue10389] Document rules for use of case in section titles
by Alexander Belopolsky Nov. 11, 2010

Nov. 11, 2010

Alexander Belopolsky <belopolsky(a)users.sourceforge.net> added the comment: Committed in revision 86417. ---------- status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10389> _______________________________________

1 0

[issue10379] locale.format() input regression
by Barry A. Warsaw Nov. 11, 2010

Nov. 11, 2010

Barry A. Warsaw <barry(a)python.org> added the comment: The bug has been fixed upstream by replacing .format() with .format_string(). I'm not sure I understand why there are two different methods - .format() seems kind of pointless to me, but then I don't use the locale module enough to say what's useful. For Python 2.7 I think the only thing we can do is to update the docs so that the distinction and restrictions are clear. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10379> _______________________________________

1 0

[issue10389] Document rules for use of case in section titles
by Éric Araujo Nov. 11, 2010

Nov. 11, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Looks good. I wouldn’t say reST is WYSIWYG, since it’s transformed, contrary to word processors where you make text bold to get it bold. (If you’re looking for other things to fix in that file, look at the entry for Unicode ;) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10389> _______________________________________

1 0

[issue10389] Document rules for use of case in section titles
by Alexander Belopolsky Nov. 11, 2010

Nov. 11, 2010

Alexander Belopolsky <belopolsky(a)users.sourceforge.net> added the comment: The new patch, issue10389.diff, addresses Éric's comments and adds an entry for "reST". ---------- Added file: http://bugs.python.org/file19571/issue10389.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10389> _______________________________________

1 0