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 35d5e16026064491e781f0d0b6544feeae710aa4..7a17d23845356f7d5a75c36fff9e7711910a28d5 100644 (file)
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -214,13 +214,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)