From 186d5238eaa2edfa97b1a160ee218400ebe6ff47 Mon Sep 17 00:00:00 2001 From: Ezio Melotti Date: Sat, 15 Sep 2012 08:34:08 +0300 Subject: [PATCH] #15789: mention shell-like parts of the stdlib in the subprocess docs. Patch by Chris Rebert. --- Doc/library/subprocess.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index 00b72fb6e75..9c03e06ec66 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -245,10 +245,14 @@ default values. The arguments that are most commonly needed are: :meth:`Popen.communicate` method. 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 - 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::