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/foreground.html | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 doc/foreground.html (limited to 'doc/foreground.html') diff --git a/doc/foreground.html b/doc/foreground.html new file mode 100644 index 0000000..a2a465f --- /dev/null +++ b/doc/foreground.html @@ -0,0 +1,57 @@ + + + + + execline: the foreground command + + + + + + +

+execline
+Software
+skarnet.org +

+ +

The `foreground` program

+ +

+foreground executes a sequence of commands. +

+ +

Interface

+ +

+ In an execlineb script: +

+ +

+     foreground { prog1... } prog2...
+

+ +

foreground reads prog1 in a +block. It forks and +executes it, then waits for it to complete.
foreground sets the ? environment +variable to the exit code of prog1. If prog1... +did not exit normally, the ? value is 111.
foreground then execs into prog2....

+ +

Notes

+ +

foreground is the basic sequence operator: it takes two +commands and executes them one by one. execline scripts require it to +wrap external commands that exit instead of natively supporting the +"perform some action, then execute some other program" model.
foreground prog1... "" prog2... is +equivalent to sh -c 'prog1... ; exec prog2...'. +

+ + + -- cgit v1.3.1

The foreground program

Interface

Notes

The `foreground` program