[docs] [issue24420] Documentation regressions from adding subprocess.run()
report at bugs.python.org
Wed Jun 10 06:04:16 CEST 2015
New submission from Martin Panter:
After the documentation was rearranged by Issue 23342 (revision f0a00ee094ff), the “older high-level APIs” lost the paragraphs that said “The arguments shown above are merely the most common ones”. Given the limited signatures of call(), check_call() and check_output(), it is now too easy to assume that these functions do not accept the less-common Popen arguments.
Also, in that issue I discovered an awkward edge case: there is actually no default value for the check_output() input parameter. Without an “input” parameter, the subprocess inherits its parent’s input, but input=None is equivalent to passing an empty string of the correct type.
This patch hopefully fixes both problems.
assignee: docs at python
nosy: docs at python, takluyver, vadmium
title: Documentation regressions from adding subprocess.run()
versions: Python 3.5, Python 3.6
Added file: http://bugs.python.org/file39671/high-args.patch
Python tracker <report at bugs.python.org>
More information about the docs