summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/runblock.html7
-rw-r--r--doc/upgrade.html2
2 files changed, 8 insertions, 1 deletions
diff --git a/doc/runblock.html b/doc/runblock.html
index 476f801..f090f85 100644
--- a/doc/runblock.html
+++ b/doc/runblock.html
@@ -23,12 +23,14 @@
in the execline language. It can only be used inside an execline
script. If the script has been given blocks as arguments, <tt>runblock</tt>
allows you to execute one of the blocks individually.
+It also allows you to give those blocks as a set of arguments to
+another command.
</p>
<h2> Interface </h2>
<pre>
- runblock [ -P ] [ -n <em>argshift</em> ] [ -r ] <em>n</em>
+ runblock [ -P ] [ -n <em>argshift</em> ] [ -r ] <em>n</em> <em>cmd...</em>
</pre>
<ul>
@@ -41,6 +43,9 @@ arguments <em>and</em> blocks. </li>
<em>n</em> blocks and execs into the remaining arguments. </li>
<li> Else it skips <em>n</em>-1 blocks and execs into the <em>n</em>th
one. </li>
+ <li> If <em>cmd...<em> is not empty, then instead of directly executing the
+block or the remainder, <tt>runblock</tt> <em>appends</em> the selected
+set of arguments to the <em>cmd...</em> command line. </li>
<li> Normally <tt>runblock</tt> <a href="el_pushenv.html#pop">pops</a>
its environment frame before executing. If the <tt>-P</tt> option has
been given, it <em>does not</em> pop. </li>
diff --git a/doc/upgrade.html b/doc/upgrade.html
index e286098..e049628 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -23,6 +23,8 @@
<ul>
<li> <a href="dollarat.html">dollarat</a> now has its <tt>-0</tt> and <tt>-d</tt>
priority unified. (Rightmost priority.) </li>
+ <li> <a href="runblock.html">runblock</a> now accepts a command line prefix,
+given as runblock's own command line. </li>
<li> New binary: <a href="posix-umask.html">posix-umask</a>. </li>
<li> <tt>cd</tt> has been renamed <a href="execline-cd.html">execline-cd</a>. </li>
<li> <tt>umask</tt> has been renamed <a href="execline-umask.html">execline-umask</a>. </li>