#16877: Add mention that shell-style path expansions are not automatic.

diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index 3e84de0ce8b498a9fe4d0acd3fd1122a0c4e6169..0df15e419b0b38be8116861e45758e84653c0c6f 100644 (file)
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -16,6 +16,11 @@ write files see :func:`open`, and for accessing the filesystem see the
    :func:`splitunc` and :func:`ismount` do handle them correctly.
 
 
+Unlike a unix shell, Python does not do any *automatic* path expansions.
+Functions such as :func:`expanduser` and :func:`expandvars` can be invoked
+explicitly when an application desires shell-like path expansion.  (See also
+the :mod:`glob` module.)
+
 .. note::
 
    Since different operating systems have different path name conventions, there