[Python-checkins] cpython (2.7): #15789: mention shell-like parts of the stdlib in the subprocess docs. Patch

ezio.melotti python-checkins at python.org
Sat Sep 15 07:35:02 CEST 2012


http://hg.python.org/cpython/rev/820032281f49
changeset:   79032:820032281f49
branch:      2.7
parent:      79029:ade667076c14
user:        Ezio Melotti <ezio.melotti at gmail.com>
date:        Sat Sep 15 08:33:12 2012 +0300
summary:
  #15789: mention shell-like parts of the stdlib in the subprocess docs.  Patch by Chris Rebert.

files:
  Doc/library/subprocess.rst |  12 ++++++++----
  1 files changed, 8 insertions(+), 4 deletions(-)


diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -227,11 +227,15 @@
    ``True`` then all line endings will be converted to ``'\n'`` as described
    for the :term:`universal newlines` `'U'`` mode argument to :func:`open`.
 
-   If *shell* is :const:`True`, the specified command will be executed through
-   the shell. This can be useful if you are using Python primarily for the
+   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
    enhanced control flow it offers over most system shells and still want
-   access to other shell features such as filename wildcards, shell pipes and
-   environment variable expansion.
+   convenient access to other shell features such as shell pipes, filename
+   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::
 

-- 
Repository URL: http://hg.python.org/cpython


More information about the Python-checkins mailing list