\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}