summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2003-03-20 17:39:38 (GMT)
committerFred Drake <fdrake@acm.org>2003-03-20 17:39:38 (GMT)
commit5c7b2487cd5cb89118c4cb60a09d38ece1552c68 (patch)
tree4ec77abc3d229499c48f3dc1d221b4b1eac5e23a
parent26f42f68211d320307a771c075bcabe18f7c62b9 (diff)
downloadcpython-5c7b2487cd5cb89118c4cb60a09d38ece1552c68.zip
cpython-5c7b2487cd5cb89118c4cb60a09d38ece1552c68.tar.gz
cpython-5c7b2487cd5cb89118c4cb60a09d38ece1552c68.tar.bz2
- 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
-rw-r--r--Doc/lib/libos.tex14
1 files 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}