Author terry.reedy
Recipients benjamin.peterson, cvrebert, georg.brandl, ncoghlan, pitrou, terry.reedy
Date 2010-02-01.20:00:43
SpamBayes Score 4.97045e-09
Marked as misclassified No
Message-id <1265054444.9.0.0360346553.issue6760@psf.upfronthosting.co.za>
In-reply-to
Content
The note starts out "Do not (do x) unless you're not (doing y)". This is confusing. I believe this means "If you are (doing y), you may (do x)". If so, please write it so. If not, please write what you do mean.

After thinking about it, "Only (do x) if you are (doing y)" might be a better rewrite. Or "You may (do x) only if you are (doing y)"

Change "be mindful of escaping" to the more direct "escape". Perhaps give a list of possible special characters.

I agree that this seems a bit verbose for reference documentation. Perhaps there should be a separate PyWiki entry or HowTo doc. That could, for instance, list the special characters for various shells if they are not all the same.
History
Date User Action Args
2010-02-01 20:00:45terry.reedysetrecipients: + terry.reedy, georg.brandl, ncoghlan, pitrou, benjamin.peterson, cvrebert
2010-02-01 20:00:44terry.reedysetmessageid: <1265054444.9.0.0360346553.issue6760@psf.upfronthosting.co.za>
2010-02-01 20:00:43terry.reedylinkissue6760 messages
2010-02-01 20:00:43terry.reedycreate