[New-bugs-announce] [issue13237] subprocess docs should use emphasise convenience functions
report at bugs.python.org
Fri Oct 21 07:25:02 CEST 2011
New submission from Nick Coghlan <ncoghlan at gmail.com>:
Many typical subprocess use cases can now be handled simply via the convenience functions:
However, readers of the documentation could be forgiven for not realising that, since the docs dive right in with Popen() and will scare most readers away in search of more user friendly APIs (or even other languages).
The module documentation should be reordered to introduce the helper function first, then Popen afterwards.
The "subprocess replacements"  section would ideally help address this, but it hasn't been updated to use the convenience function, instead using confusing direct calls to Popen.
assignee: docs at python
nosy: docs at python, ncoghlan
stage: needs patch
title: subprocess docs should use emphasise convenience functions
versions: Python 2.7, Python 3.2, Python 3.3
Python tracker <report at bugs.python.org>
More information about the New-bugs-announce