Help topic "mkdir()" does not document its returned values. It also does not mention that the function will abort if the dorectory already exists and the "p" argument is not present.
The attached patch addresses both issues. -mike -- -- You received this message from the "vim_dev" maillist. Do not top-post! Type your reply below the text you are replying to. For more information, visit http://www.vim.org/maillist.php --- You received this message because you are subscribed to the Google Groups "vim_dev" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
>From baf9ede5fa2a84098a66e85436f533a93b96afc0 Mon Sep 17 00:00:00 2001 From: msoyka-of-wharton <[email protected]> Date: Sat, 26 Jan 2019 15:36:31 -0500 Subject: [PATCH] document mkdir() returned values --- runtime/doc/eval.txt | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index c41fdcee1..e8a8a7768 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -6515,8 +6515,15 @@ mkdir({name} [, {path} [, {prot}]]) Example: > :call mkdir($HOME . "/tmp/foo/bar", "p", 0700) < This function is not available in the |sandbox|. + There is no error if the directory already exists and the "p" - flag is passed (since patch 8.0.1708). + flag is passed (since patch 8.0.1708). However, without the + "p" option the call will fail. + + The function result is a Number, which is 1 if the call was + successful or 0 if the directory creation failed or partly + failed. + Not available on all systems. To check use: > :if exists("*mkdir") < -- 2.18.0.windows.1
