summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2013-01-06 21:13:51 (GMT)
committerR David Murray <rdmurray@bitdance.com>2013-01-06 21:13:51 (GMT)
commite6dec98e451a9c69eaadacfc34df0daf7d98d789 (patch)
treede5f257bd5644b8c0ae959d97b3c2f5f750afabd
parent61dbb0086952cdc13f3ca89db810ec365a9cf9b7 (diff)
parenta4e700c040ad23a2ad47b6b7b4daeb1f331a5fae (diff)
downloadcpython-e6dec98e451a9c69eaadacfc34df0daf7d98d789.zip
cpython-e6dec98e451a9c69eaadacfc34df0daf7d98d789.tar.gz
cpython-e6dec98e451a9c69eaadacfc34df0daf7d98d789.tar.bz2
merge #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 13bda9b..36a61a5 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