Extend runblock functionality (thanks Profpatsch)

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>