diff options
author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2019-05-13 19:21:25 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-05-13 19:21:25 -0700 |
commit | da86bf7396c6509534a94407fe83e7106c9d5959 (patch) | |
tree | e3376d7d95df44aa9b31679b9b2c2515e850e4a2 /Doc/library | |
parent | c0abd0c8e9b62bc008fc74cfbfbbab36ef7d7617 (diff) | |
download | cpython-git-da86bf7396c6509534a94407fe83e7106c9d5959.tar.gz |
Changes to the documentation of normcase (GH-4725)
(cherry picked from commit 32d1458b2e2e00eeb29022179eeb04b83fb7f3c4)
Co-authored-by: Kexuan Sun <me@kianasun.com>
Diffstat (limited to 'Doc/library')
-rw-r--r-- | Doc/library/os.path.rst | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst index d78ab068a3..ef0e35d998 100644 --- a/Doc/library/os.path.rst +++ b/Doc/library/os.path.rst @@ -81,7 +81,7 @@ the :mod:`glob` module.) .. function:: commonpath(paths) Return the longest common sub-path of each pathname in the sequence - *paths*. Raise ValueError if *paths* contains both absolute and relative + *paths*. Raise :exc:`ValueError` if *paths* contains both absolute and relative pathnames, or if *paths* is empty. Unlike :func:`commonprefix`, this returns a valid path. @@ -315,9 +315,9 @@ the :mod:`glob` module.) .. function:: normcase(path) - Normalize the case of a pathname. On Unix and Mac OS X, this returns the - path unchanged; on case-insensitive filesystems, it converts the path to - lowercase. On Windows, it also converts forward slashes to backward slashes. + Normalize the case of a pathname. On Windows, convert all characters in the + pathname to lowercase, and also convert forward slashes to backward slashes. + On other operating systems, return the path unchanged. Raise a :exc:`TypeError` if the type of *path* is not ``str`` or ``bytes`` (directly or indirectly through the :class:`os.PathLike` interface). |