From 3d9f4c786ee1bce0ded8871f405b11e7eb62df13 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Tue, 12 Feb 2019 15:10:40 +0000 Subject: Add envfile; prepare for 2.5.1.0 --- doc/envfile.html | 95 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ doc/index.html | 5 +-- doc/upgrade.html | 7 +++++ 3 files changed, 105 insertions(+), 2 deletions(-) create mode 100644 doc/envfile.html (limited to 'doc') diff --git a/doc/envfile.html b/doc/envfile.html new file mode 100644 index 0000000..49b88f9 --- /dev/null +++ b/doc/envfile.html @@ -0,0 +1,95 @@ + + + + + + execline: the envfile program + + + + + + +

+execline
+Software
+skarnet.org +

+ +

The envfile program

+ +

+envfile reads a file containing variable assignments, +adds the variables to the environment, then executes a program. +

+ +

Interface

+ +
+     envfile file prog...
+
+ +

+envfile reads file and adds the key-value pairs +defined in file to the environment. Then it +execs into prog..., i.e. the rest of its command line, +with the modified environment. +

+ +

Exit codes

+ + + +

+ 0 is not listed because on success, envfile does not exit: +it execs into prog. +

+ +

File syntax

+ +

+ file is a text file containing lines of the form key = value. +Whitespace is permitted before and after key, and before or after value, +but key or value can never contain whitespace. No quoting +is possible. +

+ +

+ Empty lines, or lines containing only whitespace, are ignored. +Lines beginning with # (possibly after some whitespace) +are ignored (and typically used for comments). +Comments are also possible at the end of lines: +key = value # comment is a valid line. Note that there +must be whitespace between value and # +in this case (else # is just read as a part of value). +

+ +

+ If value is empty, key is still +added to the environment, with an empty value. If you do not want +key to be added to the environment at all, comment out the line. +envfile does not offer a way to remove variables from +the environment. +

+ +

Notes

+ + + + + diff --git a/doc/index.html b/doc/index.html index 9a68d5f..3efad3a 100644 --- a/doc/index.html +++ b/doc/index.html @@ -51,7 +51,7 @@ shell's syntax, and has no security issues.
  • A POSIX-compliant system with a standard C development environment
  • GNU make, version 3.81 or later.
  • skalibs version -2.7.0.0 or later. It's a build-time requirement. It's also a run-time +2.8.0.0 or later. It's a build-time requirement. It's also a run-time requirement if you link against the shared version of the skalibs library.
    • @@ -66,7 +66,7 @@ library.

    Download