diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 1c3a584bf82..85355a5ee9c 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -634,7 +634,8 @@ Recursive directory creation function.  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).
+is \code{0777} (octal).  This function does not properly handle UNC
+paths (only relevant on Windows systems).
 \versionadded{1.5.2}
 \end{funcdesc}
 
diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex
index 9cd1a58fd73..bc26ddd850d 100644
--- a/Doc/lib/libposixpath.tex
+++ b/Doc/lib/libposixpath.tex
@@ -7,6 +7,10 @@
 This module implements some useful functions on pathnames.
 \index{path!operations}
 
+\strong{Warning:}  On Windows, many of these functions do not properly
+support UNC pathnames.  \function{splitunc()} and \function{ismount()}
+do handle them correctly.
+
 
 \begin{funcdesc}{abspath}{path}
 Return a normalized absolutized version of the pathname \var{path}.