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

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 46764b2bb6da957d9fc318229a599659a1725b0a..3cda22626fd37c89b01357196d500103b3d54983 100644 (file)
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -751,6 +751,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}