From 1931c0c96156d44b3fa8717f54132e4835339403 Mon Sep 17 00:00:00 2001
From: Guido van Rossum <guido@python.org>
Date: Wed, 18 Feb 1998 14:00:05 +0000
Subject: Add normpath().  Clarify normcase().  (Note -- this doc section
 probably needs more work, describing new functions and the differences
 between unix/mac/win.

---
 Doc/lib/libppath.tex | 15 ++++++++++++---
 Doc/libppath.tex     | 15 ++++++++++++---
 2 files changed, 24 insertions(+), 6 deletions(-)

diff --git a/Doc/lib/libppath.tex b/Doc/lib/libppath.tex
index d286dcc..5b1f16f 100644
--- a/Doc/lib/libppath.tex
+++ b/Doc/lib/libppath.tex
@@ -90,9 +90,18 @@ between components, unless \var{p} is empty.
 \end{funcdesc}
 
 \begin{funcdesc}{normcase}{p}
-Normalize the case of a pathname.  This returns the path unchanged;
-however, a similar function in \code{macpath} converts upper case to
-lower case.
+Normalize the case of a pathname.  On \UNIX{}, 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.
+\end{funcdesc}
+
+\begin{funcdesc}{normpath}{p}
+Normalize a pathname.  This collapses redundant separators and
+up-level references, e.g. \code{A//B}, \code{A/./B} and
+\code{A/foo/../B} all become \code{A/B}.  It does not normalize the
+case (use \code{normcase()} for that).  On Windows, it does converts
+forward slashes to backward slashes.
 \end{funcdesc}
 
 \begin{funcdesc}{samefile}{p\, q}
diff --git a/Doc/libppath.tex b/Doc/libppath.tex
index d286dcc..5b1f16f 100644
--- a/Doc/libppath.tex
+++ b/Doc/libppath.tex
@@ -90,9 +90,18 @@ between components, unless \var{p} is empty.
 \end{funcdesc}
 
 \begin{funcdesc}{normcase}{p}
-Normalize the case of a pathname.  This returns the path unchanged;
-however, a similar function in \code{macpath} converts upper case to
-lower case.
+Normalize the case of a pathname.  On \UNIX{}, 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.
+\end{funcdesc}
+
+\begin{funcdesc}{normpath}{p}
+Normalize a pathname.  This collapses redundant separators and
+up-level references, e.g. \code{A//B}, \code{A/./B} and
+\code{A/foo/../B} all become \code{A/B}.  It does not normalize the
+case (use \code{normcase()} for that).  On Windows, it does converts
+forward slashes to backward slashes.
 \end{funcdesc}
 
 \begin{funcdesc}{samefile}{p\, q}
-- 
cgit v0.12

