From 1bfba3b0be32306b078f5ee527b864e758b2c77b Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Fri, 26 Apr 2019 15:52:54 +0000 Subject: Make a single hpr. Full doc, first draft. --- doc/s6-linux-init-echo.html | 69 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 doc/s6-linux-init-echo.html (limited to 'doc/s6-linux-init-echo.html') diff --git a/doc/s6-linux-init-echo.html b/doc/s6-linux-init-echo.html new file mode 100644 index 0000000..837eab0 --- /dev/null +++ b/doc/s6-linux-init-echo.html @@ -0,0 +1,69 @@ + + + + + + s6-linux-init: the s6-linux-init-echo program + + + + + + +

+ +

The `s6-linux-init-echo` program

+ +

+ s6-linux-init-echo writes its arguments to stdout. +

+ +

Interface

+ +

+     s6-linux-init-echo [ -n ] [ -s sep ] args...
+

+ +

+ s6-linux-init-echo writes its arguments args to stdout, separated with spaces. +

+ +

Options

+ +

-n : do not output a trailing newline.
-s sep : separate arguments with the sep +character instead of a space.

+ +

Notes

+ +

Strange, and appalling, as it may seem for such a simple task, there is +no way to ensure that the echo program will behave consistently from +Unix system to Unix system - and even from Linux distribution to Linux +distribution. Despite there being a +standard +for it, the echo commands in GNU coreutils, busybox, toybox, sbase, and +other implementations basically all exhibit different behaviours. Every shell has +a built-in echo command, that fails to follow the POSIX standard. echo +is the prime example of the consequences of the blatant disregard of early Unices +for cross-system compatibility, and its followup as a turf war between GNU and the +rest of the Linux world. As a distribution-agnostic software developer, it is ironically +impossible to rely on a definite behaviour of the echo command on every +supported system, and that is why s6-linux-init provides its own implementation. +Fortunately, it is very easy to do so, with minimal overhead.
This command is an exact duplicate of the +s6-echo command +provided in the s6-portable-utils +package. It was decided not to have a dependency from s6-linux-init to +s6-portable-utils: that dependency would arguably be a higher cost than the small +amount of code duplication.

+ + + -- cgit v1.2.3

The s6-linux-init-echo program

Interface

Options

Notes

The `s6-linux-init-echo` program