diff options
| author | Laurent Bercot <ska-skaware@skarnet.org> | 2024-04-06 17:54:13 +0000 |
|---|---|---|
| committer | Laurent Bercot <ska@appnovation.com> | 2024-04-06 17:54:13 +0000 |
| commit | a5b7a319fb558f5df599de286318029d455ed193 (patch) | |
| tree | b468c6b2620613aa5f29d793feecb22c94dfedbf /doc | |
| parent | db852ecd93afc9f893886a132ee58b23579fc79d (diff) | |
| download | execline-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.html | 21 | ||||
| -rw-r--r-- | doc/index.html | 4 | ||||
| -rw-r--r-- | doc/upgrade.html | 6 |
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> : store <em>prog1...</em>'s output as is, including the last newline, if any. </li> <li> <tt>-n</tt> : chomp an ending newline off <em>prog1...</em>'s output. This is the default. </li> <li> <tt>-e</tt> : no autoimport. This is the default. </li> - <li> <tt>-E</tt> : 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> : 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> |