New submission from Antony Lee:

subprocess.__doc__ currently contains copies for the docstrings of a bunch of 
functions in the module (... but not subprocess.run).  The docs for the Popen 
class should be moved into that class' docstring.  The module's docstring also 
mentions the list2cmdline "method" (actually a function, and the qualifier 
"method"/"function" is missing the second time this function is mentioned ("The 
list2cmdline is designed ...")), but that function doesn't appear in `__all__` 
and thus not in the official HTML docs (yes, I know pydoc 
subprocess.list2cmdline works).

----------
assignee: docs@python
components: Documentation
messages: 259238
nosy: Antony.Lee, docs@python
priority: normal
severity: normal
status: open
title: Docstring of the subprocess module should be cleaned up
versions: Python 3.5

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue26240>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to