summaryrefslogtreecommitdiff
path: root/doc/s6-test.html
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2023-03-19 23:28:36 +0000
committerLaurent Bercot <ska@appnovation.com>2023-03-19 23:28:36 +0000
commitce05fac9edeabb841e8ec807e0f96bc1a7a90155 (patch)
tree52ac6aff5a1640913bdba885b9be489be682ff20 /doc/s6-test.html
parent0dd8d249a5f8714d893095a4d03680cb8678ecce (diff)
downloads6-portable-utils-ce05fac9edeabb841e8ec807e0f96bc1a7a90155.tar.xz
Delete s6-test doc page
Signed-off-by: Laurent Bercot <ska@appnovation.com>
Diffstat (limited to 'doc/s6-test.html')
-rw-r--r--doc/s6-test.html86
1 files changed, 0 insertions, 86 deletions
diff --git a/doc/s6-test.html b/doc/s6-test.html
deleted file mode 100644
index 9c756b6..0000000
--- a/doc/s6-test.html
+++ /dev/null
@@ -1,86 +0,0 @@
-<html>
- <head>
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <meta http-equiv="Content-Language" content="en" />
- <title>s6-portable-utils: the s6-test program</title>
- <meta name="Description" content="s6-portable-utils: the s6-test program" />
- <meta name="Keywords" content="s6-portable-utils command s6-test test" />
- <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> -->
- </head>
-<body>
-
-<p>
-<a href="index.html">s6-portable-utils</a><br />
-<a href="//skarnet.org/software/">Software</a><br />
-<a href="//skarnet.org/">skarnet.org</a>
-</p>
-
-<h1> The <tt>s6-test</tt> program </h1>
-
-<p>
- s6-test evaluates an expression and indicates the result via its
-exit status.
-</p>
-
-<h2> Interface </h2>
-
-<pre>
- s6-test <em>expression...</em>
-</pre>
-
-<p>
- s6-test acts as the generic
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/utilities/test.html">test</a> utility,
-but it diverges from the specification on one point: if an argument starts with a backslash,
-this backslash is ignored (and the argument cannot be an operation). This is a simple
-disambiguation technique that has unfortunately not been chosen by the standard.
-</p>
-
-<p>
- s6-test accepts an arbitrary number of arguments.
-</p>
-
-<h2> Exit codes </h2>
-
-<ul>
- <li> 0: the test is true </li>
- <li> 1: the test is false </li>
- <li> 100: wrong usage </li>
- <li> 101: internal error (should never happen, warrants a bug-report) </li>
- <li> 111: system call failure </li>
-</ul>
-
-<h2> Posixness </h2>
-
-<p>
- s6-test <strong>is not</strong> suitable as a Single Unix
-<a href="https://pubs.opengroup.org/onlinepubs/9699919799/utilities/test.html">test</a>
-program; however, if your arguments never start with a backslash, it exhibits the
-exact same behaviour.
-</p>
-
-<h2> Non-standard expressions </h2>
-
-<ul>
- <li> <tt>-v&nbsp;<em>VAR</em></tt>&nbsp;: tests whether the
-<em>VAR</em> variable is defined in the current environment. </li>
- <li> <tt><em>string</em>&nbsp;=~&nbsp;<em>pattern</em></tt>&nbsp;:
-tries to match <em>string</em> against extended regular expression
-<em>pattern</em>. True if any part of <em>string</em> matches <em>pattern</em>;
-in order to match whole strings, you must anchor <em>pattern</em> with
-<tt>^</tt> and <tt>$</tt> markers. </li>
-</ul>
-
-<h2> Notes </h2>
-
-<ul>
- <li> <strong>This program is deprecated.</strong> It will disappear in a
-near future version of s6-portable-utils. You are encouraged to use
-<a href="https://skarnet.org/software/execline/eltest.html">eltest</a>
-instead, which has the same interface and functionality, and is a part of the
-<a href="https://skarnet.org/software/execline/">execline</a> package. </li>
-</ul>
-
-</body>
-</html>