From f316a2ed52195135a35e32d7096e876357c48c69 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Thu, 18 Sep 2014 20:03:23 +0000 Subject: initial commit: rc for execline-2.0.0.0 --- doc/backtick.html | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 doc/backtick.html (limited to 'doc/backtick.html') diff --git a/doc/backtick.html b/doc/backtick.html new file mode 100644 index 0000000..7bdc037 --- /dev/null +++ b/doc/backtick.html @@ -0,0 +1,66 @@ + + + + + execline: the backtick command + + + + + + +

+execline
+Software
+skarnet.org +

+ +

The `backtick` program

+ +

+backtick runs a program and uses its output as the argument of +another program. +

+ +

Interface

+ +

+ In an execlineb script: +

+ +

+     backtick [ -i ] [ -n ] variable { prog1... } prog2...
+

+ +

backtick reads prog1... in a +block and unquotes it.
It runs prog1... as a child process and saves its +output in memory. This output must not contain a null character.
backtick execs into the modified prog2..., with +variable added to the environment with prog1...'s +output as a value.

+ +

Options

+ +

-i : insist. If prog1 exits non-zero, +backtick exits with the same exit code (or 111 if prog1 +crashed for some reason). Without this option, backtick execs into +prog2... no matter what prog1 does, with the null word as +variable's value if prog1 didn't write anything before +dying.
-n : chomp an ending newline off prog1...'s +output.

+ +

Notes

+ +

You can start prog2... with "import variable unexport variable" +to perform variable substitution.

+ + + -- cgit v1.2.3

The backtick program

Interface

Options

Notes

The `backtick` program