From 5c7b2487cd5cb89118c4cb60a09d38ece1552c68 Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Thu, 20 Mar 2003 17:39:38 +0000
Subject: - explain what a UNC path is in the makedirs() description, since  
 they're actually mentioned there - remove some extraneous paragraph
 separations - \versionadded --> \versionchanged in one place

---
 Doc/lib/libos.tex | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 844704b..07762c6 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -711,7 +711,7 @@ entries \code{'.'} and \code{'..'} even if they are present in the
 directory.
 Availability: Macintosh, \UNIX, Windows.
 
-\versionadded[On Windows NT/2k/XP and Unix, if \var{path} is a Unicode
+\versionchanged[On Windows NT/2k/XP and Unix, if \var{path} is a Unicode
 object, the result will be a list of Unicode objects.]{2.3}
 \end{funcdesc}
 
@@ -742,25 +742,21 @@ of S_IFREG, S_IFCHR, S_IFBLK, and S_IFIFO (those constants are
 available in \module{stat}). For S_IFCHR and S_IFBLK, \var{device}
 defines the newly created device special file (probably using
 \function{os.makedev()}), otherwise it is ignored.
-
 \versionadded{2.3}
 \end{funcdesc}
 
 \begin{funcdesc}{major}{device}
 Extracts a device major number from a raw device number.
-
 \versionadded{2.3}
 \end{funcdesc}
 
 \begin{funcdesc}{minor}{device}
 Extracts a device minor number from a raw device number.
-
 \versionadded{2.3}
 \end{funcdesc}
 
 \begin{funcdesc}{makedev}{major, minor}
 Composes a raw device number from the major and minor device numbers.
-
 \versionadded{2.3}
 \end{funcdesc}
 
@@ -773,13 +769,15 @@ Availability: Macintosh, \UNIX, Windows.
 \end{funcdesc}
 
 \begin{funcdesc}{makedirs}{path\optional{, mode}}
-\index{directory!creating}
-Recursive directory creation function.  Like \function{mkdir()},
+Recursive directory creation function.\index{directory!creating}
+\index{UNC paths!and \function{os.makedirs()}}
+Like \function{mkdir()},
 but makes all intermediate-level directories needed to contain the
 leaf directory.  Throws an \exception{error} exception if the leaf
 directory already exists or cannot be created.  The default \var{mode}
 is \code{0777} (octal).  This function does not properly handle UNC
-paths (only relevant on Windows systems).
+paths (only relevant on Windows systems; Universal Naming Convention
+paths are those that use the `\code{\e\e host\e path}' syntax).
 \versionadded{1.5.2}
 \end{funcdesc}
 
-- 
cgit v0.12

