From 9806a4f3bb81f71c46735a2b378cb074fef6e27b Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Mon, 26 Oct 2020 08:59:58 +0000
Subject:  Prepare for 2.9.4.0; add open*coe() functions.

---
 doc/index.html             |  2 +-
 doc/libstddjb/djbunix.html | 51 ++++++++++++++++++++++++++++++++++++++++++++++
 doc/license.html           |  2 +-
 doc/upgrade.html           |  7 +++++++
 4 files changed, 60 insertions(+), 2 deletions(-)

(limited to 'doc')

diff --git a/doc/index.html b/doc/index.html
index 7d86278..c7cb59c 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -60,7 +60,7 @@ with a standard C development environment </li>
 <h3> Download </h3>
 
 <ul>
- <li> The current released version of skalibs is <a href="skalibs-2.9.3.0.tar.gz">2.9.3.0</a>. </li>
+ <li> The current released version of skalibs is <a href="skalibs-2.9.4.0.tar.gz">2.9.4.0</a>. </li>
  <li> Alternatively, you can checkout a copy of the
 <a href="//git.skarnet.org/cgi-bin/cgit.cgi/skalibs/">skalibs
 git repository</a>:
diff --git a/doc/libstddjb/djbunix.html b/doc/libstddjb/djbunix.html
index 2e99dd0..0ac0a2c 100644
--- a/doc/libstddjb/djbunix.html
+++ b/doc/libstddjb/djbunix.html
@@ -253,12 +253,24 @@ Opens <em>file</em> in read-only, non-blocking mode.
 Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
 </p>
 
+<p>
+<code> int open_readcoe (char const *file) </code> <br />
+Opens <em>file</em> in read-only, non-blocking mode, close-on-exec.
+Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
+</p>
+
 <p>
 <code> int openb_read (char const *file) </code> <br />
 Opens <em>file</em> in read-only, blocking mode.
 Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
 </p>
 
+<p>
+<code> int openb_readcoe (char const *file) </code> <br />
+Opens <em>file</em> in read-only, blocking mode, close-on-exec.
+Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
+</p>
+
 <p>
 <code> int open_readb (char const *file) </code> <br />
 Opens <em>file</em> in read-only, blocking mode.
@@ -270,6 +282,11 @@ is set afterwards; this behaviour allows for more transparent interactions
 with FIFOs.
 </p>
 
+<p>
+<code> int open_readbcoe (char const *file) </code> <br />
+Same as above, but the file is opened close-on-exec.
+</p>
+
 <p>
 <code> int open_excl (char const *file) </code> <br />
 Opens <em>file</em> in write-only, non-blocking mode, with the
@@ -277,6 +294,13 @@ additional O_EXCL and O_CREAT flags.
 Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
 </p>
 
+<p>
+<code> int open_exclcoe (char const *file) </code> <br />
+Opens <em>file</em> in write-only, non-blocking mode, close-on-exec, with the
+additional O_EXCL and O_CREAT flags.
+Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
+</p>
+
 <p>
 <code> int open_append (char const *file) </code> <br />
 Opens <em>file</em> in write-only, non-blocking mode, with the
@@ -284,6 +308,13 @@ additional O_APPEND and O_CREAT flags.
 Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
 </p>
 
+<p>
+<code> int open_appendcoe (char const *file) </code> <br />
+Opens <em>file</em> in write-only, non-blocking mode, close-on-exec, with the
+additional O_APPEND and O_CREAT flags.
+Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
+</p>
+
 <p>
 <code> int open_trunc (char const *file) </code> <br />
 Opens <em>file</em> in write-only, non-blocking mode, with the
@@ -291,6 +322,13 @@ additional O_TRUNC and O_CREAT flags.
 Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
 </p>
 
+<p>
+<code> int open_trunccoe (char const *file) </code> <br />
+Opens <em>file</em> in write-only, non-blocking mode, close-on-exec, with the
+additional O_TRUNC and O_CREAT flags.
+Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
+</p>
+
 <p>
 <code> int open_create (char const *file) </code> <br />
 Opens <em>file</em> in write-only, non-blocking mode, with the
@@ -298,12 +336,25 @@ additional O_CREAT flag.
 Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
 </p>
 
+<p>
+<code> int open_createcoe (char const *file) </code> <br />
+Opens <em>file</em> in write-only, non-blocking mode, close-on-exec, with the
+additional O_CREAT flag.
+Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
+</p>
+
 <p>
 <code> int open_write (char const *file) </code> <br />
 Opens <em>file</em> in write-only, non-blocking mode.
 Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
 </p>
 
+<p>
+<code> int open_writecoe (char const *file) </code> <br />
+Opens <em>file</em> in write-only, non-blocking mode, close-on-exec.
+Returns a valid fd number if it succeeds, or -1 (and sets errno) if it fails.
+</p>
+
 <h3> Executable search and execution, and environment </h3>
 
 <p>
diff --git a/doc/license.html b/doc/license.html
index 27bbf9f..9aae77e 100644
--- a/doc/license.html
+++ b/doc/license.html
@@ -74,7 +74,7 @@ color, or different text font. </li>
 <p>
  <em>I am aware that the previous restrictions sound completely
 ridiculous while the official skalibs documentation is incomplete.
-As of 2.9.3.0, I'm not going to enforce those restrictions, but if you're
+As of 2.9.4.0, I'm not going to enforce those restrictions, but if you're
 going to provide documentation for skalibs, don't keep it to yourself,
 please send it to me instead. :-) </em>
 </p>
diff --git a/doc/upgrade.html b/doc/upgrade.html
index e59df35..0f1aee8 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -16,6 +16,13 @@
 <a href="//skarnet.org/">skarnet.org</a>
 </p>
 
+<h2> in 2.9.4.0 </h2>
+
+<ul>
+ <li> New <tt>open*coe</tt> functions, which are O_CLOEXEC versions of the
+<a href="libstddjb/djbunix.html">djbunix.h</a> functions without <tt>coe</tt>. </li>
+</ul>
+
 <h2> in 2.9.3.0 </h2>
 
 <ul>
-- 
cgit v1.2.3