summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2023-02-12 02:34:48 +0000
committerLaurent Bercot <ska@appnovation.com>2023-02-12 02:34:48 +0000
commit5b57f7249b84b3bdeab7b6827544c0844e7f6e5f (patch)
tree4ccc7c7549c583b6d8719b94472e4b607e085aca
parent2a2c6e81937c137c336b6c7a2c95d7e02e7595d5 (diff)
downloads6-portable-utils-5b57f7249b84b3bdeab7b6827544c0844e7f6e5f.tar.xz
Doc fix
Signed-off-by: Laurent Bercot <ska@appnovation.com>
-rw-r--r--INSTALL23
-rw-r--r--NEWS1
-rw-r--r--doc/s6-portable-utils.html2
-rw-r--r--doc/upgrade.html2
4 files changed, 27 insertions, 1 deletions
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.
<p>
s6-portable-utils will run the <em>subcommand</em> will its arguments. For
instance, <tt>s6-portable-utils s6-seq 1 10</tt> will run the equivalent of the
-<a href="s6-seq.html">program</a>, so this command will list natural numbers
+<a href="s6-seq.html">s6-seq</a> program, so this command will list natural numbers
from 1 to 10.
</p>
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. </li>
<li> <tt>s6-test</tt> removed. Use
<a href="//skarnet.org/software/execline/eltest.html">eltest</a>
instead. </li>
+ <li> New <a href="s6-portable-utils.html">s6-portable-utils</a>
+multicall binary. </li>
</ul>
<h2> in 2.2.5.1 </h2>