From: Terry Jan Reedy <tjreedy@udel.edu>
Date: Sun, 17 Mar 2013 19:21:26 +0000 (-0400)
Subject: Issue #17415: Clarify 'this' referent by moving containing sentence just after
X-Git-Tag: v2.7.4rc1~31
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=3e50fb3f697ddecd966bb37e6a205a820addd652;p=python

Issue #17415: Clarify 'this' referent by moving containing sentence just after
the sentence referred to. Make other minor edits to improve flow.
---

diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index 0df15e419b..dac479a0b7 100644
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -219,13 +219,11 @@ the :mod:`glob` module.)
 
 .. function:: normpath(path)
 
-   Normalize a pathname.  This collapses redundant separators and up-level
-   references so that ``A//B``, ``A/B/``, ``A/./B`` and ``A/foo/../B`` all become
-   ``A/B``.
-
-   It does not normalize the case (use :func:`normcase` for that).  On Windows, it
-   converts forward slashes to backward slashes. It should be understood that this
-   may change the meaning of the path if it contains symbolic links!
+   Normalize a pathname by collapsing redundant separators and up-level
+   references so that ``A//B``, ``A/B/``, ``A/./B`` and ``A/foo/../B`` all
+   become ``A/B``.  This string manipulation may change the meaning of a path
+   that contains symbolic links.  On Windows, it converts forward slashes to
+   backward slashes. To normalize case, use :func:`normcase`.  
 
 
 .. function:: realpath(path)