runtime(doc): clarify that a umask is applied to mkdir()

fixes: #16849

Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index 80b8a9cc4ae36199192ac41c92040f104270c10e..ec1088933e922ee26f02c19787c5c3c90addf7f3 100644 (file)
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt*  For Vim version 9.1.  Last change: 2025 Feb 23
+*builtin.txt*  For Vim version 9.1.  Last change: 2025 Mar 11
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -7587,9 +7587,8 @@ mkdir({name} [, {flags} [, {prot}]])                      *mkdir()* *E739*
                If {prot} is given it is used to set the protection bits of
                the new directory.  The default is 0o755 (rwxr-xr-x: r/w for
                the user, readable for others).  Use 0o700 to make it
-               unreadable for others.  This is only used for the last part of
-               {name}.  Thus if you create /tmp/foo/bar then /tmp/foo will be
-               created with 0o755.
+               unreadable for others.  This is used for the newly created
+               directories.  Note an umask is applied to {prot} (on Unix).
                Example: >
                        :call mkdir($HOME .. "/tmp/foo/bar", "p", 0o700)