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 35d5e16..7a17d23 100644
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -214,13 +214,11 @@
.. 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)