- 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

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 844704b059174048c1284929a22e1923d455f09f..07762c6097377dd9f4beb52f096f4abaa1fe2265 100644 (file)
--- 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}