From 631f809ce4a14ec6f1af5118b99adc514be7db60 Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Tue, 2 Feb 2021 01:20:49 +0000
Subject:  Prepare for 2.8.0.0; change backtick options and default behaviour

---
 doc/backtick.html | 16 +++++++++-------
 doc/index.html    |  4 ++--
 doc/upgrade.html  |  9 +++++++++
 3 files changed, 20 insertions(+), 9 deletions(-)

(limited to 'doc')

diff --git a/doc/backtick.html b/doc/backtick.html
index 91e963a..e5a889d 100644
--- a/doc/backtick.html
+++ b/doc/backtick.html
@@ -30,7 +30,7 @@ environment variable, then executes another program.
 </p>
 
 <pre>
-     backtick [ -i | -I | -D <em>default</em> ] [ -N | -n ] [ -E | -e ] <em>variable</em> { <em>prog1...</em> } <em>prog2...</em>
+     backtick [ -i | -I | -d | -D <em>default</em> ] [ -N | -n ] [ -E | -e ] <em>variable</em> { <em>prog1...</em> } <em>prog2...</em>
 </pre>
 
 <ul>
@@ -63,15 +63,17 @@ nonzero:
 </p>
 
 <ul>
- <li> <tt>-i</tt>&nbsp;: backtick exits 1. </li>
- <li> <tt>-I</tt>&nbsp;: <em>variable</em> is <strong>removed</strong> from
+ <li> <tt>-i</tt>&nbsp;: backtick exits with an
+<a href="exitcodes.html">approximation</a> of <em>prog1</em>'s exit code,
+or 124 if <em>prog1</em> wrote a null character. This is the default. </li>
+ <li> <tt>-I</tt>: the value of <em>variable</em> is set to whatever
+the start of <em>prog1...</em>'s output is, up to the first null character,
+or to whatever <em>prog1...</em> wrote before crashing; chomping is applied
+if required; then execution proceeds. </li>
+ <li> <tt>-d</tt>&nbsp;: <em>variable</em> is <strong>removed</strong> from
 the environment, and execution proceeds. </li>
  <li> <tt>-D&nbsp;<em>default</em></tt>&nbsp;: the value of <em>variable</em>
 is set to <em>default</em>, and execution proceeds. </li>
- <li> neither of those options: the value of <em>variable</em> is set to whatever
-the start of <em>prog1...</em>'s output is, up to the first null character,
-or to whatever <em>prog1...</em> wrote before crashing;
-then execution proceeds. </li>
 </ul>
 
 </body>
diff --git a/doc/index.html b/doc/index.html
index c708c6d..8222a48 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -51,7 +51,7 @@ shell's syntax, and has no security issues.
  <li> A POSIX-compliant system with a standard C development environment </li>
  <li> GNU make, version 3.81 or later. </li>
  <li> <a href="//skarnet.org/software/skalibs/">skalibs</a> version
-2.10.0.1 or later. It's a build-time requirement. It's also a run-time
+2.10.0.2 or later. It's a build-time requirement. It's also a run-time
 requirement if you link against the shared version of the skalibs
 library. </li>
 </ul>
@@ -77,7 +77,7 @@ want nsswitch-like functionality:
 <h3> Download </h3>
 
 <ul>
- <li> The current released version of execline is <a href="execline-2.7.0.1.tar.gz">2.7.0.1</a>. </li>
+ <li> The current released version of execline is <a href="execline-2.8.0.0.tar.gz">2.8.0.0</a>. </li>
  <li> Alternatively, you can checkout a copy of the
 <a href="//git.skarnet.org/cgi-bin/cgit.cgi/execline/">execline
 git repository</a>:
diff --git a/doc/upgrade.html b/doc/upgrade.html
index eac79a7..b30f6ac 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -18,6 +18,15 @@
 
 <h1> What has changed in execline </h1>
 
+<h2> in 2.8.0.0 </h2>
+
+<ul>
+ <li> <a href="//skarnet.org/software/skalibs/">skalibs</a>
+dependency bumped to 2.10.0.2. </li>
+ <li> <a href="backtick.html">backtick</a> options have changed
+slightly, and now propagates subprocess failure by default. </li>
+</ul>
+
 <h2> in 2.7.0.1 </h2>
 
 <ul>
-- 
cgit v1.2.3