From: R David Murray <rdmurray@bitdance.com>
Date: Sun, 6 Jan 2013 21:13:10 +0000 (-0500)
Subject: #16877: Add mention that shell-style path expansions are not automatic.
X-Git-Tag: v3.2.4rc1~247
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a4e700c040ad23a2ad47b6b7b4daeb1f331a5fae;p=thirdparty%2FPython%2Fcpython.git

#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 22272a79d40a..35d5e1602606 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