summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2013-01-06 21:13:10 (GMT)
committerR David Murray <rdmurray@bitdance.com>2013-01-06 21:13:10 (GMT)
commita4e700c040ad23a2ad47b6b7b4daeb1f331a5fae (patch)
tree6be0b81f8918d498abc6f8cf3777946f6a88ef68
parent7449231eca9867dcee73c8456a35764bd97127fc (diff)
downloadcpython-a4e700c040ad23a2ad47b6b7b4daeb1f331a5fae.zip
cpython-a4e700c040ad23a2ad47b6b7b4daeb1f331a5fae.tar.gz
cpython-a4e700c040ad23a2ad47b6b7b4daeb1f331a5fae.tar.bz2
#16877: Add mention that shell-style path expansions are not automatic.
-rw-r--r--Doc/library/os.path.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index 22272a7..35d5e16 100644
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -17,6 +17,11 @@ path names. Vice versa, using bytes objects cannot represent all file
names on Windows (in the standard ``mbcs`` encoding), hence Windows
applications should use string objects to access all files.
+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::
All of these functions accept either only bytes or only string objects as