Add s6-rc-set-list

3 files changed, 86 insertions, 7 deletions

diff --git a/doc/index.html b/doc/index.html
index 462dd04..25c47de 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -135,11 +135,12 @@ the previous versions of s6-rc and the current one. </li>
  <li> An <a href="repodefs.html">overview</a> of the <em>repo</em> tools </li>
  <li> <a href="s6-rc-repo-init.html">The <tt>s6-rc-repo-init</tt> program</a> </li>
  <li> <a href="s6-rc-repo-sync.html">The <tt>s6-rc-repo-sync</tt> program</a> </li>
- <li> <a href="s6-rc-repo-set-new.html">The <tt>s6-rc-set-new</tt> program</a> </li>
- <li> <a href="s6-rc-repo-set-copy.html">The <tt>s6-rc-set-copy</tt> program</a> </li>
- <li> <a href="s6-rc-repo-set-delete.html">The <tt>s6-rc-set-delete</tt> program</a> </li>
- <li> <a href="s6-rc-repo-set-change.html">The <tt>s6-rc-set-change</tt> program</a> </li>
- <li> <a href="s6-rc-repo-set-commit.html">The <tt>s6-rc-set-commit</tt> program</a> </li>
+ <li> <a href="s6-rc-set-new.html">The <tt>s6-rc-set-new</tt> program</a> </li>
+ <li> <a href="s6-rc-set-copy.html">The <tt>s6-rc-set-copy</tt> program</a> </li>
+ <li> <a href="s6-rc-set-delete.html">The <tt>s6-rc-set-delete</tt> program</a> </li>
+ <li> <a href="s6-rc-set-change.html">The <tt>s6-rc-set-change</tt> program</a> </li>
+ <li> <a href="s6-rc-set-commit.html">The <tt>s6-rc-set-commit</tt> program</a> </li>
+ <li> <a href="s6-rc-set-install.html">The <tt>s6-rc-set-install</tt> program</a> </li>
 </ul>
 
 <h2> Related resources </h2>
diff --git a/doc/s6-rc-set-list.html b/doc/s6-rc-set-list.html
new file mode 100644
index 0000000..18a04ee
--- /dev/null
+++ b/doc/s6-rc-set-list.html
@@ -0,0 +1,78 @@
+<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-rc: the s6-rc-set-list program</title>
+    <meta name="Description" content="s6-rc: the s6-rc-set-list program" />
+    <meta name="Keywords" content="s6-rc s6-rc-set-list repo set sub list services" />
+    <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> -->
+  </head>
+<body>
+
+<p>
+<a href="index.html">s6-rc</a><br />
+<a href="//skarnet.org/software/">Software</a><br />
+<a href="//skarnet.org/">skarnet.org</a>
+</p>
+
+<h1> The s6-rc-set-list program </h1>
+
+<p>
+ s6-rc-set-list lists all the services of a <a href="repodefs.html#set">set</a>,
+along with the <a href="repodefs.html#sub">sub</a> each service is on.
+</p>
+
+<h2> Interface </h2>
+
+<pre>
+     s6-rc-set-list [ -v <em>verbosity</em> ] [ -r <em>repo</em> ] <em>set</em>
+</pre>
+
+<ul>
+ <li> s6-rc-set-list prints all the services in set <em>set</em> of repository
+<em>repo</em>, one per line, to stdout. Each line contains: 
+  <ul>
+   <li> The name of the service </li>
+   <li> A slash (<tt>/</tt>) character </li>
+   <li> The canonical name for the sub the service is in. </li>
+  </ul> </li>
+ <li> It exits 0. </li>
+</ul>
+
+<h2> Options </h2>
+
+<dl>
+ <dt> -v <em>verbosity</em>, --verbosity=<em>verbosity</em> </dt>
+ <dd> Be more or less verbose. The default is <strong>1</strong>, which means
+that error messages and warnings will be written to stderr. 0 means that only
+error messages will be written, and 2 or more adds informational messages. </dd>
+
+ <dt> -r <em>repo</em>, --repository=<em>repo</em> </dt>
+ <dd> Use the repository in <em>repo</em>, which must exist. Default is
+<strong>/var/lib/s6-rc/repository</strong>.
+ </dd>
+</dl>
+
+<h2> Exit codes </h2>
+
+<dl>
+ <dt> 0 </dt> <dd> Success. </dd>
+ <dt> 3 </dt> <dd> Nonexistent set. </dd>
+ <dt> 100 </dt> <dd> Incorrect usage. </dd>
+ <dt> 102 </dt> <dd> Invalid repository. </dd>
+ <dt> 111 </dt> <dd> System call failed. </dd>
+</dl>
+
+<h2> Notes </h2>
+
+<ul>
+ <li> s6-rc-set-list is meant to be used with automation such as
+<a href="https://pubs.opengroup.org/onlinepubs/9799919799/utilities/cut.html">cut</a>
+or util-linux's <a href="https://man7.org/linux/man-pages/man1/column.1.html">column</a>
+for formatting. A slash is used to separate the service name for the sub because
+slashes cannot appear in service names. </li>
+</ul>
+
+</body>
+</html>
diff --git a/doc/s6-rc-set-new.html b/doc/s6-rc-set-new.html
index 8cdc2f7..4d4642b 100644
--- a/doc/s6-rc-set-new.html
+++ b/doc/s6-rc-set-new.html
@@ -19,14 +19,14 @@
 <h1> The s6-rc-set-new program </h1>
 
 <p>
- s6-rc-set-new creates new <a href="repodefs.html#sets">sets</a>
+ s6-rc-set-new creates new <a href="repodefs.html#set">sets</a>
 in a <a href="repodefs.html#repository">repository</a>.
 </p>
 
 <h2> Interface </h2>
 
 <pre>
-     s6-rc-set-delete [ -v <em>verbosity</em> ] [ -r <em>repo</em> ] <em>setname...</em>
+     s6-rc-set-new [ -v <em>verbosity</em> ] [ -r <em>repo</em> ] <em>setname...</em>
 </pre>
 
 <ul>