From a10514072f27ff9f4a6ab308b3bccfd4628ef2aa Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Thu, 9 Feb 2023 15:03:45 +0000
Subject:  Add sals, several refactors

Signed-off-by: Laurent Bercot <ska@appnovation.com>
---
 doc/libstddjb/djbunix.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

(limited to 'doc/libstddjb/djbunix.html')

diff --git a/doc/libstddjb/djbunix.html b/doc/libstddjb/djbunix.html
index 8232209..a48a57f 100644
--- a/doc/libstddjb/djbunix.html
+++ b/doc/libstddjb/djbunix.html
@@ -670,6 +670,17 @@ Same as above, using the <tt>satmp</tt> global stralloc as
 heap-allocated temporary space.
 </p>
 
+<h3> Directory listing </h3>
+
+<p>
+<code> int sals (char const *dir, stralloc *sa, size_t *maxlen) </code> <br />
+Appends the base names of all the files (save <tt>.</tt> and <tt>..</tt>) in
+<em>dir</em> to the stralloc <em>*sa</em>; each name is null-terminated.
+On error, returns -1 and sets errno. On success, returns the number of files
+it found, and writes to <em>*maxlen</em> the size of the largest file name
+it found (0 for an empty directory).
+</p>
+
 <h3> Variable length wrappers around Single Unix calls </h3>
 
 <p>
-- 
cgit v1.2.3