From 5b57f7249b84b3bdeab7b6827544c0844e7f6e5f Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Sun, 12 Feb 2023 02:34:48 +0000 Subject: Doc fix Signed-off-by: Laurent Bercot --- INSTALL | 23 +++++++++++++++++++++++ NEWS | 1 + doc/s6-portable-utils.html | 2 +- doc/upgrade.html | 2 ++ 4 files changed, 27 insertions(+), 1 deletion(-) diff --git a/INSTALL b/INSTALL index fa3c008..db35774 100644 --- a/INSTALL +++ b/INSTALL @@ -151,3 +151,26 @@ without relying on a PATH search. skarnet.org packages do not support out-of-tree builds. They are small, so it does not cost much to duplicate the entire source tree if parallel builds are needed. + + +* Multicall binary + ---------------- + + Starting with version 2.3.0.0, the s6-portable-utils package comes +with an alternative build in the form of a multicall binary, simply +called "s6-portable-utils", that includes the functionality of *all* +the other binaries; it switches functionalities depending on the name +it is called with, or the subcommand it is given: +"s6-portable-utils s6-seq 1 10" will print the natural numbers from +1 to 10, same as "s6-seq 1 10" if s6-seq is a link to the +s6-portable-utils program. + + To use this, use the --enable-multicall option to configure. Only +the s6-portable-utils binary will be built, and other programs will be +created as symbolic links to s6-portable-utils at installation time. + + The multicall setup saves a lot of disk space, at the price of +am unnoticeable amount of CPU usage. RAM usage is about equivalent +and difficult to assess. The setup is meant for embedded devices +or small distributions with a focus on saving disk space. + diff --git a/NEWS b/NEWS index 6d47066..670a895 100644 --- a/NEWS +++ b/NEWS @@ -4,6 +4,7 @@ In 2.3.0.0 ---------- - s6-test removed. + - New multicall binary: s6-portable-utils. In 2.2.5.1 diff --git a/doc/s6-portable-utils.html b/doc/s6-portable-utils.html index 5700f38..959f4ac 100644 --- a/doc/s6-portable-utils.html +++ b/doc/s6-portable-utils.html @@ -37,7 +37,7 @@ s6-portable-utils binary.

s6-portable-utils will run the subcommand will its arguments. For instance, s6-portable-utils s6-seq 1 10 will run the equivalent of the -program, so this command will list natural numbers +s6-seq program, so this command will list natural numbers from 1 to 10.

diff --git a/doc/upgrade.html b/doc/upgrade.html index 30b2ebd..41b0abd 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -26,6 +26,8 @@ dependency bumped to 2.13.1.0.
  • s6-test removed. Use eltest instead.
    • +
  • New s6-portable-utils +multicall binary.

    • in 2.2.5.1

    -- cgit 1.4.1