From 3d91d9ce645efa020800b85be1ac2727ebcbad19 Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Wed, 6 Nov 2024 08:05:33 +0000
Subject:  Prepare for 2.9.7.0 ; rework forx/forstdin -p, add -P maxpar

 Also refactor several things to keep global footprint low

Signed-off-by: Laurent Bercot <ska@appnovation.com>
---
 doc/forx.html | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

(limited to 'doc/forx.html')

diff --git a/doc/forx.html b/doc/forx.html
index 8f1d558..b20ab65 100644
--- a/doc/forx.html
+++ b/doc/forx.html
@@ -29,7 +29,7 @@
 </p>
 
 <pre>
-     forx [ -E | -e ] [ -p ] [ -o <em>okcodes</em> | -x <em>breakcodes</em> ] <em>variable</em> { <em>args...</em> } <em>loop...</em>
+     forx [ -E | -e ] [ -p | -P <em>maxpar</em> ] [ -o <em>okcodes</em> | -x <em>breakcodes</em> ] <em>variable</em> { <em>args...</em> } <em>loop...</em>
 </pre>
 
 <ul>
@@ -65,16 +65,12 @@ list, else it will exit 1. If the <tt>-x</tt> option has been given,
 listed in the <em>breakcodes</em> list, else it will exit 1. </li>
  <li> <tt>-e</tt>&nbsp;: no autoimport. This is the default. </li>
  <li> <tt>-E</tt>&nbsp;: autoimport. Instead of spawning
-<em>loop...</em>, spawn <tt>importas -ui <em>variable</em> <em>variable</em>
+<em>loop...</em>, spawn <tt>importas -uSi <em>variable</em>
 <em>loop...</em></tt>. This substitutes <em>variable</em> into the command
 line instead of putting it into the environment. </li>
-</ul>
-
-<h2> Notes </h2>
-
-<ul>
- <li> You can start <em>loop</em> with "importas -u <em>variable</em> <em>variable</em>"
-if you want variable substitution. </li>
+ <li> <tt>-P</tt>&nbsp;<em>maxpar</em>&nbsp;: similar to <tt>-p</tt>, but run
+up to <em>maxpar</em> instances in parallel, i.e. never have more than <em>maxpar</em>
+children at the same time. Minimum is 1. </li>
 </ul>
 
 </body>
-- 
cgit v1.3.1