From e91f7bcc41f6c2345fa55cb7f9b95dde97be1760 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Hugo=20H=C3=B6rnquist?= <hugo@lysator.liu.se>
Date: Wed, 2 Feb 2022 02:36:22 +0100
Subject: Documentation of (hnh util ...)

---
 doc/ref/guile/util-path.texi | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 doc/ref/guile/util-path.texi

(limited to 'doc/ref/guile/util-path.texi')

diff --git a/doc/ref/guile/util-path.texi b/doc/ref/guile/util-path.texi
new file mode 100644
index 00000000..1abef3a6
--- /dev/null
+++ b/doc/ref/guile/util-path.texi
@@ -0,0 +1,32 @@
+@node Path Utilities
+@section Path Utilities
+
+Provided by the module @code{(hnh util path)}.
+
+See also @code{absolute-file-name?} from Guile.
+
+@defun path-append strings ...
+Joins all strings into a path, squeezing duplicated delimiters, but
+ensuring that all delimiters that are needed are there.
+
+Note that delimiters embedded inside the string, which aren't first or
+last in a substring (or are the only thing in a string) are
+kept. Meaning that
+@example
+(path-append "/" "hello") ⇒ "/hello"
+(path-append "/usr/local/bin" "cmd") ⇒ "/usr/local/bin/cmd"
+@end example
+@end defun
+
+
+@defun path-join lst
+@lisp
+(apply path-append lst)
+@end lisp
+@end defun
+
+
+@defun path-split path
+Splits path into a list of components.
+The first component will be @code{""} if path is absolute.
+@end defun
-- 
cgit v1.2.3