#15789: mention shell-like parts of the stdlib in the subprocess docs. Patch by Chris Rebert.

This commit is contained in:
Ezio Melotti 2012-09-15 08:33:12 +03:00
parent a733d814be
commit eab4df5830

View file

@ -227,11 +227,15 @@ default values. The arguments that are most commonly needed are:
``True`` then all line endings will be converted to ``'\n'`` as described ``True`` then all line endings will be converted to ``'\n'`` as described
for the :term:`universal newlines` `'U'`` mode argument to :func:`open`. for the :term:`universal newlines` `'U'`` mode argument to :func:`open`.
If *shell* is :const:`True`, the specified command will be executed through If *shell* is ``True``, the specified command will be executed through
the shell. This can be useful if you are using Python primarily for the the shell. This can be useful if you are using Python primarily for the
enhanced control flow it offers over most system shells and still want enhanced control flow it offers over most system shells and still want
access to other shell features such as filename wildcards, shell pipes and convenient access to other shell features such as shell pipes, filename
environment variable expansion. wildcards, environment variable expansion, and expansion of ``~`` to a
user's home directory. However, note that Python itself offers
implementations of many shell-like features (in particular, :mod:`glob`,
:mod:`fnmatch`, :func:`os.walk`, :func:`os.path.expandvars`,
:func:`os.path.expanduser`, and :mod:`shutil`).
.. warning:: .. warning::