summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2024-04-06 17:54:13 +0000
committerLaurent Bercot <ska@appnovation.com>2024-04-06 17:54:13 +0000
commita5b7a319fb558f5df599de286318029d455ed193 (patch)
treeb468c6b2620613aa5f29d793feecb22c94dfedbf /doc
parentdb852ecd93afc9f893886a132ee58b23579fc79d (diff)
downloadexecline-a5b7a319fb558f5df599de286318029d455ed193.tar.xz
Prepare for 2.9.5.0; add ? support in backtick
Signed-off-by: Laurent Bercot <ska@appnovation.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/backtick.html21
-rw-r--r--doc/index.html4
-rw-r--r--doc/upgrade.html6
3 files changed, 23 insertions, 8 deletions
diff --git a/doc/backtick.html b/doc/backtick.html
index 14cc031..38c02a2 100644
--- a/doc/backtick.html
+++ b/doc/backtick.html
@@ -49,10 +49,15 @@ output as a value. </li>
<li> <tt>-N</tt>&nbsp;: store <em>prog1...</em>'s output as is, including the last newline, if any. </li>
<li> <tt>-n</tt>&nbsp;: chomp an ending newline off <em>prog1...</em>'s output. This is the default. </li>
<li> <tt>-e</tt>&nbsp;: no autoimport. This is the default. </li>
- <li> <tt>-E</tt>&nbsp;: autoimport. Instead of exec'ing into
-<em>prog2...</em>, exec into <tt>importas -ui <em>variable</em> <em>variable</em>
-<em>prog2...</em></tt>. This substitutes <em>variable</em> into the command
-line instead of putting it into the environment. </li>
+ <li> <tt>-E</tt>&nbsp;: autoimport. Before exec'ing into
+<em>prog2...</em>, perform a
+<a href="https://skarnet.org/software/execline/el_substitute.html">substitution</a>
+so that <tt>$?</tt> is replaced with <em>prog1...</em>'s exitcode (if
+applicable, see below), and
+<tt>${<em>variable</em>}</tt> is replaced with <em>prog1...</em>'s output,
+instead of keeping the results in the environment. The variables will not
+appear in the environment; if they preexisted in <tt>backtick</tt>'s
+environment, they will be removed. </li>
</ul>
<p>
@@ -76,5 +81,13 @@ the environment, and execution proceeds. </li>
is set to <em>default</em>, and execution proceeds. </li>
</ul>
+<p>
+ If the command line can keep running after <em>prog1</em> crashes or exits
+nonzero, i.e. if one of the <tt>-I</tt>, <tt>-x</tt> -or <tt>-D</tt> has been
+given, then <tt>backtick</tt> also adds the <tt>?</tt> variable to the
+environment; it then contains an <a href="exitcodes.html">approximation</a>
+of <em>prog1</em>'s exit code.
+</p>
+
</body>
</html>
diff --git a/doc/index.html b/doc/index.html
index 0a226ab..73b7867 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.14.1.0 or later. It's a build-time requirement. It's also a run-time
+2.14.1.1 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.9.4.1.tar.gz">2.9.4.1</a>. </li>
+ <li> The current released version of execline is <a href="execline-2.9.5.0.tar.gz">2.9.5.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 6511fe5..262c1e4 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -18,11 +18,13 @@
<h1> What has changed in execline </h1>
-<h2> in 2.9.4.1 </h2>
+<h2> in 2.9.5.0 </h2>
<ul>
<li> <a href="//skarnet.org/software/skalibs/">skalibs</a>
-dependency bumped to 2.14.1.0. </li>
+dependency bumped to 2.14.1.1. </li>
+ <li> <a href="backtick.html">backtick</a> now sets the ?
+environment variable when it can be nonzero. </li>
</ul>
<h2> in 2.9.4.0 </h2>