clarify the docs of existsOrCreateDir a bit (#17182)

* remove unnecessary when statement

* remove outdated codes

* clarify the docs a bit
This commit is contained in:
flywind 2021-02-25 06:58:31 -06:00 • committed by GitHub
commit f07bdbe945
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -2436,11 +2436,10 @@ proc rawCreateDir(dir: string): bool {.noWeirdTarget.} =
proc existsOrCreateDir*(dir: string): bool {.rtl, extern: "nos$1", proc existsOrCreateDir*(dir: string): bool {.rtl, extern: "nos$1",
tags: [WriteDirEffect, ReadDirEffect], noWeirdTarget.} = tags: [WriteDirEffect, ReadDirEffect], noWeirdTarget.} =
## Check if a `directory`:idx: `dir` exists, and create it otherwise. ## Checks if a `directory`:idx: `dir` exists, and creates it otherwise.
## ##
## Does not create parent directories (fails if parent does not exist). ## Does not create parent directories (raises `OSError` if parent directories do not exist).
## Returns `true` if the directory already exists, and `false` ## Returns `true` if the directory already exists, and `false` otherwise.
## otherwise.
## ##
## See also: ## See also:
## * `removeDir proc <#removeDir,string>`_ ## * `removeDir proc <#removeDir,string>`_