This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ezio.melotti
Recipients docs@python, eric.araujo, ezio.melotti, flox, ncoghlan, python-dev, rhettinger
Date 2011-10-27.03:51:07
SpamBayes Score 4.7589057e-07
Marked as misclassified No
Message-id <1319687468.97.0.364363368029.issue13237@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2011-10-27 03:51:09ezio.melottisetrecipients: + ezio.melotti, rhettinger, ncoghlan, eric.araujo, flox, docs@python, python-dev
2011-10-27 03:51:08ezio.melottisetmessageid: <1319687468.97.0.364363368029.issue13237@psf.upfronthosting.co.za>
2011-10-27 03:51:08ezio.melottilinkissue13237 messages
2011-10-27 03:51:07ezio.melotticreate