aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2025-12-08 05:56:52 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2025-12-08 05:56:52 +0000
commitecdd92c89a1edc46044b51816eeef160f195466b (patch)
tree15a0c38210643ef9dfb5c5b28acb1c9097d58000
parentcc6e37dbf6e95c394166aca90836eb87fe307ad0 (diff)
downloadexecline-ecdd92c89a1edc46044b51816eeef160f195466b.tar.gz
Document importas -S in multisubstitute
-rw-r--r--doc/multisubstitute.html6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/multisubstitute.html b/doc/multisubstitute.html
index 2cb38ee..3a032be 100644
--- a/doc/multisubstitute.html
+++ b/doc/multisubstitute.html
@@ -34,6 +34,7 @@ its <em>argv</em>, then executes another program.
{
[ <a href="define.html">define</a> [ -N | -n ] [ -s ] [ -C | -c ] [ -d <em>delim</em> ] <em>variable</em> <em>value</em> ]
[ <a href="importas.html">importas</a> [ -i | -D <em>default</em> ] [ -N | -n ] [ -s ] [ -C | -c ] [ -d <em>delim</em> ] <em>variable</em> <em>envvar</em> ]
+ [ <a href="importas.html">importas</a> -S [ -i | -D <em>default</em> ] [ -N | -n ] [ -s ] [ -C | -c ] [ -d <em>delim</em> ] <em>envvar</em> ]
[ <a href="elglob.html">elglob</a> [ -v ] [ -w ] [ -s ] [ -m ] [ -e ] [ -0 ] <em>variable</em> <em>pattern</em> ]
[ <a href="elgetpositionals.html">elgetpositionals</a> [ -P <em>sharp</em> ] ]
[ <a href="multidefine.html">multidefine</a> <em>value</em> { <em>variable...</em> } ]
@@ -57,6 +58,11 @@ to learn about the syntax of each substitution command. </li>
<li> If an <tt>importas</tt> directive was given with the
<tt>-i</tt> option, and the looked up variable is undefined,
<tt>multisubstitute</tt> will exit 100. </li>
+ <li> Like its <a href="importas.html">direct program equivalent</a>,
+<tt>importas</tt> has two modes: the normal one, which takes a <em>variable</em> and an
+<em>envvar</em> envvar as argument and imports <em>envvar</em> under the name <em>variable</em>,
+and the <tt>-S</tt> one, which only takes one argument and imports an environment variable
+under the same name. </li>
</ul>
<h2> Rationale </h2>