Message146472
I think Éric is referring to the foo(bar, *, baz=None) syntax. In 2.7 you can drop the '*' and still leave only the keyword arguments that you think are more useful.
I also see that you converted a few examples to use shell=True, but afaiu that should be avoided (even if the input is trusted, it can be a bad example and lead to escaping issues).
For the 'exit 1' example you could add a note saying that the example is run with shell=True because 'exit' requires a shell, or just keep the more verbose Python version.
My concern is that many people just go trough the examples and copy/paste what they see without reading the text around unless it's necessary to make the command work, so, if many examples use shell=True, they might end up picking one of those. |
|
Date |
User |
Action |
Args |
2011-10-27 03:51:09 | ezio.melotti | set | recipients:
+ ezio.melotti, rhettinger, ncoghlan, eric.araujo, flox, docs@python, python-dev |
2011-10-27 03:51:08 | ezio.melotti | set | messageid: <1319687468.97.0.364363368029.issue13237@psf.upfronthosting.co.za> |
2011-10-27 03:51:08 | ezio.melotti | link | issue13237 messages |
2011-10-27 03:51:07 | ezio.melotti | create | |
|