backport bug [ 1274828 ] splitunc not documented

diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex
index 59944f8849fad0a38c3ec47e14acde91ae284802..190cf07dc143d4edcbc387d64bdf8e65337da4a0 100644 (file)
--- 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 f3eaa3a76ea25c164713e9b04d616dfd9ac6e04a..45a62ef63896112e99d744c9441be524e40b5838 100644 (file)
--- 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.