[docs] [issue24420] Documentation regressions from adding subprocess.run()

Martin Panter 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
components: Documentation
files: high-args.patch
keywords: patch
messages: 245111
nosy: docs at python, takluyver, vadmium
priority: normal
severity: normal
status: open
title: Documentation regressions from adding subprocess.run()
type: behavior
versions: Python 3.5, Python 3.6
Added file: http://bugs.python.org/file39671/high-args.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24420>
_______________________________________


More information about the docs mailing list