From f1cc42ff92f561f6cb768b4b4aa9a5ec71ccb6e3 Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Thu, 18 Dec 2025 06:07:03 +0000
Subject:  buffer doc: some adjustments. Credit Hoël.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/libstddjb/buffer.html | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

(limited to 'doc/libstddjb')

diff --git a/doc/libstddjb/buffer.html b/doc/libstddjb/buffer.html
index 000e0e3..eac7003 100644
--- a/doc/libstddjb/buffer.html
+++ b/doc/libstddjb/buffer.html
@@ -29,8 +29,9 @@ and implemented in the <tt>libskarnet.a</tt> or <tt>libskarnet.so</tt> library.
 
 <p>
  skalibs provides convenience structures and functions to perform buffered I/O.
-These structures and functions abstract and replace, from a programer’s point
-of vue, direct calls to fd_read or fd_write for instance.
+These structures and functions abstract direct calls to <tt>read</tt> or <tt>write</tt>;
+they're meant to be used in place of <tt>stdio.h</tt> primitives. Unlike <tt>stdio</tt>,
+they can be used with non-blocking file descriptors.
 </p>
 
 <p>
@@ -84,7 +85,7 @@ fails.
 <p>
  The above are the most important and fundamental functions for buffering.
 Other functions can be found in the same header and their prototypes are
-self-explaining.
+self-explaining. More may be documented here later.
 </p>
 
 </body>
-- 
cgit v1.3.1