diff -r 5b0595339c9d Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst	Sun Aug 26 07:33:10 2012 +0300
+++ b/Doc/library/subprocess.rst	Mon Aug 27 00:13:56 2012 -0700
@@ -309,8 +309,11 @@
    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` and :mod:`fnmatch`, :func:`os.path.expandvars`,
+   and :func:`os.path.expanduser`).
 
    .. versionchanged:: 3.3
       When *universal_newlines* is ``True``, the class uses the encoding