[ 755617 ] os module: Need a better description of "mode"

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index e5b5962d99b8c76ec9ebc350d3e89549093d79bd..3d9056dad225f073bbf0543ab86d7a198e2c6381 100644 (file)
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -764,6 +764,11 @@ Change the mode of \var{path} to the numeric \var{mode}.
   \item \code{S_IXOTH}
 \end{itemize}
 Availability: Macintosh, \UNIX, Windows.
+
+\note{Although Windows supports \function{chmod()}, you can only 
+set the file's read-only flag with it (via the \code{S_IWRITE} 
+and \code{S_IREAD} constants or a corresponding integer value). 
+All other bits are ignored.}
 \end{funcdesc}
 
 \begin{funcdesc}{chown}{path, uid, gid}