Hmm, I dislike "Normally, *args* should be a sequence."
From my perspective better to say something like:
*args* should be a sequence if *shell* is *False* or string of *shell* is *True* 
or something like this.
I would to directly recommend reader to follow that schema, see also http://bugs.python.org/issue7839