From d0996a25bd4030875fbc98cabea815dd6741dd0d Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Fri, 14 Aug 2015 23:29:04 +0000 Subject: Add withstdinas --- doc/withstdinas.html | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 doc/withstdinas.html (limited to 'doc/withstdinas.html') diff --git a/doc/withstdinas.html b/doc/withstdinas.html new file mode 100644 index 0000000..29ad1b6 --- /dev/null +++ b/doc/withstdinas.html @@ -0,0 +1,67 @@ + + + + + + execline: the withstdinas command + + + + + + +

+execline
+Software
+skarnet.org +

+ +

The `withstdinas` program

+ +

+withstdinas reads the entirety of its standard input in an +environment variable, and runs another program with that additional +environment variable. +

+ +

Interface

+ +

+ In an execlineb script: +

+ +

+     withstdinas [ -i | -D default ] [ -n ] variable prog...
+

+ +

withstdinas reads its stdin until EOF.
It then execs into prog..., with +variable added to the environment; the value of +variable is what was read on stdin.

+ +

Options

+ +

-i : insist. If the data on stdin is invalid as +an environment variable, for instance if it contains a null +character, withstdinas exits 1.
-D default : default value. +If the data on stdin is invalid, default is used as +variable's value. If neither the -i nor the -D +option have been given, withstdinas execs into +prog... with variable containing whatever value could be read on stdin, +cut before the first null character.
-n : chomp an ending newline off stdin.

+ +

Notes

+ +

You can start prog... with "import -u variable" +to perform variable substitution.

+ + + -- cgit v1.2.3

The withstdinas program

Interface

Options

Notes

The `withstdinas` program