From ea714e771e8964114285915acacf80707cc17bdd Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Wed, 26 Mar 2025 04:27:39 +0000 Subject: Add export-array; update deps Signed-off-by: Laurent Bercot --- doc/export-array.html | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/index.html | 5 ++-- doc/upgrade.html | 4 ++++ 3 files changed, 71 insertions(+), 2 deletions(-) create mode 100644 doc/export-array.html (limited to 'doc') diff --git a/doc/export-array.html b/doc/export-array.html new file mode 100644 index 0000000..bc3d611 --- /dev/null +++ b/doc/export-array.html @@ -0,0 +1,64 @@ + + + + + + execline: the export program + + + + + + +

+execline
+Software
+skarnet.org +

+ +

The `export-array` program

+ +

+export-array encodes a set of values into an environment variable, +then executes a program. +

+ +

Interface

+ +

+ In an execline script: +

+ +

+     export-array [ -d delim ] var { value1 value2 ... } prog...
+

+ +

export-array reads a (possibly empty) block +of values, and encodes them into the var environment variable. +
It then execs into prog.

+ +

Options

+ +

-d delim : encode the list of values using the +first character of delim as a terminator. Only use this when you know +the character does not appear in any of the values! By default, no terminator +character is specified, and the values are encoded as netstrings.

+ +

Notes

+ +

var must be given without a dollar!
var must not contain the character = .
A list of values encoded via export-array VAR { value1 value2 ... } +can be retrieved via importas -Ssd "" VAR. +Then ${VAR} will be split into as many words as there are values.
A list encoded via export-array -d delim VAR { value1 value2 ... } +can similarly be retrieved via importas -Ssd delim VAR.

+ + + diff --git a/doc/index.html b/doc/index.html index 6dbab1c..324f259 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.14.3.0 or later. It's a build-time requirement. It's also a run-time +2.14.4.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.

@@ -64,7 +64,7 @@ library.

If you're using musl and want nsswitch-like functionality: nsss version -0.2.0.5 or later (build-time and boot-time)

+0.2.0.6 or later (build-time and boot-time)