[docs] [issue13826] Having a shlex example in the subprocess.Popen docs is confusing
R. David Murray
report at bugs.python.org
Thu Jan 19 15:36:48 CET 2012
R. David Murray <rdmurray at bitdance.com> added the comment:
It is not particularly intuitive what goes in to a Popen non-shell argument list, unless you are an experienced programmer. The real purpose of the note is to convey a lot of information about how tokenization works in a short example, and it also demonstrates how to investigate other complex cases the user may have to deal with. Because of the first part of that (showing tokenization quirks) I don't think it should be relegated to a footnote.
That said, the example could perhaps be reworded slightly to make its expositional purpose clearer. Suggestions welcome.
Python tracker <report at bugs.python.org>
More information about the docs