summaryrefslogtreecommitdiffstats
path: root/Doc/library/os.path.rst
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2013-01-06 21:14:22 (GMT)
committerR David Murray <rdmurray@bitdance.com>2013-01-06 21:14:22 (GMT)
commit4e62033b574e9699412ffca5541393f6dc8165fb (patch)
tree1dad98022706a4ffa9dd6518b4289782c10230bf /Doc/library/os.path.rst
parent05aba6ce39160c487cb41e474bbe306839c340a9 (diff)
parente6dec98e451a9c69eaadacfc34df0daf7d98d789 (diff)
downloadcpython-4e62033b574e9699412ffca5541393f6dc8165fb.zip
cpython-4e62033b574e9699412ffca5541393f6dc8165fb.tar.gz
cpython-4e62033b574e9699412ffca5541393f6dc8165fb.tar.bz2
merge #16877: Add mention that shell-style path expansions are not automatic.
Diffstat (limited to 'Doc/library/os.path.rst')
-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 d1725bd..0f63849 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