diff -r 7fa6336e9864 Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst	Tue Aug 28 00:24:52 2012 +0200
+++ b/Doc/library/subprocess.rst	Tue Aug 28 01:56:37 2012 -0700
@@ -307,10 +307,14 @@
       :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`).
 
    .. versionchanged:: 3.3
       When *universal_newlines* is ``True``, the class uses the encoding