From: Georg Brandl <georg@python.org>
Date: Wed, 14 Sep 2005 20:42:04 +0000 (+0000)
Subject: backport bug [ 1274828 ] splitunc not documented
X-Git-Tag: v2.4.2c1~32
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d82374d2420cd2935b009590e99f78b3f0e79d96;p=thirdparty%2FPython%2Fcpython.git

backport bug [ 1274828 ] splitunc not documented
---

diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex
index 59944f8849fa..190cf07dc143 100644
--- a/Doc/lib/libposixpath.tex
+++ b/Doc/lib/libposixpath.tex
@@ -234,6 +234,15 @@ and \var{ext} is empty or begins with a period and contains
 at most one period.
 \end{funcdesc}
 
+\begin{funcdesc}{splitunc}{path}
+Split the pathname \var{path} into a pair \code{(\var{unc}, \var{rest})}
+so that \var{unc} is the UNC mount point (such as \code{r'\e\e host\e mount'}),
+if present, and \var{rest} the rest of the path (such as 
+\code{r'\e path\e file.ext'}).  For paths containing drive letters, \var{unc}
+will always be the empty string.
+Availability:  Windows.
+\end{funcdesc}
+
 \begin{funcdesc}{walk}{path, visit, arg}
 Calls the function \var{visit} with arguments
 \code{(\var{arg}, \var{dirname}, \var{names})} for each directory in the
diff --git a/Misc/NEWS b/Misc/NEWS
index f3eaa3a76ea2..45a62ef63896 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -170,6 +170,8 @@ Build
 Documentation
 -------------
 
+- Bug #1274828: Document os.path.splitunc().
+
 - Bug #1190204: Clarify which directories are searched by site.py.
 
 - Bug #1193849: Clarify os.path.expanduser() documentation.