From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 14 May 2019 02:21:25 +0000 (-0700)
Subject: Changes to the documentation of normcase (GH-4725)
X-Git-Tag: v3.7.4rc1~155
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=da86bf7396c6509534a94407fe83e7106c9d5959;p=thirdparty%2FPython%2Fcpython.git

Changes to the documentation of normcase (GH-4725)

(cherry picked from commit 32d1458b2e2e00eeb29022179eeb04b83fb7f3c4)

Co-authored-by: Kexuan Sun <me@kianasun.com>
---

diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index d78ab068a31e..ef0e35d99867 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).