[docs] [issue20344] subprocess.check_output() docs misrepresent what shell=True does

Martin Panter report at bugs.python.org
Sat Jun 20 08:25:51 CEST 2015

Martin Panter added the comment:

I think it might be better to leave the platform-specific details in the full Popen description, not under Frequently Used Arguments. I suggest to use 20344_4.patch:

* Move existing pointer to Popen constructor details up to top of section
* Explain the escaping and quoting of a sequence only applies to Windows
* Remove claim that a string simply names a program without arguments; appears to be only half true under Windows
* Clarify shell=True command is normally a string, not a sequence
* Drop new description of Unix shell argument sequence in favour of existing description under Popen
* Move warning about Windows shell argument sequence under Popen

stage: needs patch -> patch review
versions: +Python 3.5, Python 3.6 -Python 3.3
Added file: http://bugs.python.org/file39747/20344_4.patch

Python tracker <report at bugs.python.org>

More information about the docs mailing list