* sysif.c (mkdir_nothrow_exists): New static function.

(ensure_dir): New function.
(sysif_init): ensure_dir registered as intrinsic.

* txr.1: ensure_dir documented.

1 files changed, 9 insertions, 1 deletions

diff --git a/txr.1 b/txr.1
index 75794618..a8c10b07 100644
--- a/txr.1
+++ b/txr.1
@@ -23989,9 +23989,10 @@ of the system timer.  Actual sleep times may be rounded up to the nearest 10
 millisecond multiple on a system where timed suspensions are triggered by a 100
 Hz tick.
 
-.coNP Function @ mkdir
+.coNP Functions @ mkdir and @ ensure-dir
 .synb
 .mets (mkdir < path <> [ mode ])
+.mets (ensure-dir < path <> [ mode ])
 .syne
 .desc
 .code mkdir
@@ -24015,6 +24016,13 @@ for the newly created directory. If omitted, the requested permissions are
 are subject to the system
 .codn umask .
 
+The function
+.code ensure-dir
+is similar to
+.code mkdir
+except that it attempts to create all the missing parent directories
+as necessary, and does not throw an error if the directory exists.
+
 .coNP Function @ chdir
 .synb
 .mets (chdir << path )