From 3d91d9ce645efa020800b85be1ac2727ebcbad19 Mon Sep 17 00:00:00 2001 From: Laurent Bercot 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 --- doc/forstdin.html | 14 ++++++-------- doc/forx.html | 14 +++++--------- doc/index.html | 2 +- doc/upgrade.html | 7 +++++++ 4 files changed, 19 insertions(+), 18 deletions(-) (limited to 'doc') diff --git a/doc/forstdin.html b/doc/forstdin.html index 25f951f..14b9a3b 100644 --- a/doc/forstdin.html +++ b/doc/forstdin.html @@ -50,6 +50,11 @@ and 1 if it hasn't read anything. instance to finish before spawning the next one. forstdin will still wait for all instances of loop to terminate before exiting, though. +
  • -P maxpar : like -p, but only +run up to maxpar instances at a time. Minimum is 1; maximum is +10000. -p is equivalent to -P 10000, i.e. it can +spawn a very large number of loop instances in parallel, but it's +technically not infinite.
  • -o okcodes : okcodes must be a comma-separated list of exit codes. If the -p flag hasn't been given and loop exits with one of the codes in @@ -63,7 +68,7 @@ that will make forstdin break the loop and exit, and the unlisted exit codes will make it keep looping.
  • -e : no autoimport. This is the default.
  • -E : autoimport. Instead of spawning -loop..., spawn importas -ui variable variable +loop..., spawn importas -uSi variable loop.... This substitutes variable into the command line instead of putting it into the environment.
    • @@ -94,12 +99,5 @@ used simultaneously, the rightmost one wins. the input is only split on newlines. -

    Notes

    - -
      -
    • You can start loop... with importas -u variable variable -to perform variable substitution.
      • -
    - 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 @@ 

    -     forx [ -E | -e ] [ -p ] [ -o okcodes | -x breakcodes ] variable { args... } loop...
+     forx [ -E | -e ] [ -p | -P maxpar ] [ -o okcodes | -x breakcodes ] variable { args... } loop...
      @@ -65,16 +65,12 @@ list, else it will exit 1. If the -x option has been given, listed in the breakcodes list, else it will exit 1.
    • -e : no autoimport. This is the default.
    • -E : autoimport. Instead of spawning -loop..., spawn importas -ui variable variable +loop..., spawn importas -uSi variable loop.... This substitutes variable into the command line instead of putting it into the environment.
      • -
    - -

    Notes

    - -
      -
    • You can start loop with "importas -u variable variable" -if you want variable substitution.
      • +
    • -P maxpar : similar to -p, but run +up to maxpar instances in parallel, i.e. never have more than maxpar +children at the same time. Minimum is 1.
    diff --git a/doc/index.html b/doc/index.html index beb61bd..6dbab1c 100644 --- a/doc/index.html +++ b/doc/index.html @@ -77,7 +77,7 @@ want nsswitch-like functionality:

    Download

      -
    • The current released version of execline is 2.9.6.1.
      • +
    • The current released version of execline is 2.9.7.0.
    • Alternatively, you can checkout a copy of the execline git repository: diff --git a/doc/upgrade.html b/doc/upgrade.html index aeaf0ba..31ddf00 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -18,6 +18,13 @@

      What has changed in execline

      +

      in 2.9.7.0

      + + +

      in 2.9.6.1

        -- cgit 1.4.1