Commit 5c7b2487 authored by Fred Drake's avatar Fred Drake

- 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
parent 26f42f68
...@@ -711,7 +711,7 @@ entries \code{'.'} and \code{'..'} even if they are present in the ...@@ -711,7 +711,7 @@ entries \code{'.'} and \code{'..'} even if they are present in the
directory. directory.
Availability: Macintosh, \UNIX, Windows. 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} object, the result will be a list of Unicode objects.]{2.3}
\end{funcdesc} \end{funcdesc}
...@@ -742,25 +742,21 @@ of S_IFREG, S_IFCHR, S_IFBLK, and S_IFIFO (those constants are ...@@ -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} available in \module{stat}). For S_IFCHR and S_IFBLK, \var{device}
defines the newly created device special file (probably using defines the newly created device special file (probably using
\function{os.makedev()}), otherwise it is ignored. \function{os.makedev()}), otherwise it is ignored.
\versionadded{2.3} \versionadded{2.3}
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{major}{device} \begin{funcdesc}{major}{device}
Extracts a device major number from a raw device number. Extracts a device major number from a raw device number.
\versionadded{2.3} \versionadded{2.3}
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{minor}{device} \begin{funcdesc}{minor}{device}
Extracts a device minor number from a raw device number. Extracts a device minor number from a raw device number.
\versionadded{2.3} \versionadded{2.3}
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{makedev}{major, minor} \begin{funcdesc}{makedev}{major, minor}
Composes a raw device number from the major and minor device numbers. Composes a raw device number from the major and minor device numbers.
\versionadded{2.3} \versionadded{2.3}
\end{funcdesc} \end{funcdesc}
...@@ -773,13 +769,15 @@ Availability: Macintosh, \UNIX, Windows. ...@@ -773,13 +769,15 @@ Availability: Macintosh, \UNIX, Windows.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{makedirs}{path\optional{, mode}} \begin{funcdesc}{makedirs}{path\optional{, mode}}
\index{directory!creating} Recursive directory creation function.\index{directory!creating}
Recursive directory creation function. Like \function{mkdir()}, \index{UNC paths!and \function{os.makedirs()}}
Like \function{mkdir()},
but makes all intermediate-level directories needed to contain the but makes all intermediate-level directories needed to contain the
leaf directory. Throws an \exception{error} exception if the leaf leaf directory. Throws an \exception{error} exception if the leaf
directory already exists or cannot be created. The default \var{mode} directory already exists or cannot be created. The default \var{mode}
is \code{0777} (octal). This function does not properly handle UNC 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} \versionadded{1.5.2}
\end{funcdesc} \end{funcdesc}
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment