15 files changed, 123 insertions(+), 66 deletions(-)

M man1/factor.1
M man1/factor.1.html
M man1/link.1
M man1/link.1.html
M man1/nproc.1
M man1/nproc.1.html
M man1/printenv.1
M man1/printenv.1.html
M man1/shred.1
M man1/shred.1.html
M man1/sync.1
M man1/tty.1
M man1/tty.1.html
M man1/unlink.1
M man1/unlink.1.html

@@ 1,6 1,6 @@
 .\" SPDX-License-Identifier: 0BSD
 .\"
-.Dd December 31, 2021
+.Dd January 20, 2022
 .ds doc-volume-operating-system
 .Dt FACTOR 1
 .Os voreutils pre-v0.0.0-latest


@@ 11,7 11,8 @@
 .Sh SYNOPSIS
 .Nm
 .Ar number Ns …
-.Nm cat Ar numbers Li \&| Nm
+.Nm
+.Li < Pa numbers
 .
 .Sh DESCRIPTION
 Prints factors of all


@@ 37,7 38,7 @@ wasn't actually, or was out of range.
 1410: 2 3 5 47
 1981: 7 283
 
-.Li $ Nm tr Fl cd Li '0-9\en \et' < /dev/urandom \&| Nm dd Li bs=60 count=1 \&| Nm
+.Li $ Nm tr Fl cd Li '0-9 \et\en' < Pa /dev/urandom Li \&| Nm dd Li bs=60 count=1 \&| Nm
 11: 11
 41615: 5 7 29 41
 0:


@@ 70,5 71,8 @@ to parse one number per line, as opposed to just separating them by whitespace, 
 .Sh BUGS
 .Ar number Ns s
 are 64-bit integers
-.Pq Bq Sy 0 , 18446744073709551616 .
+.Pq Bq Sy 0 , 18446744073709551615 .
 .\" TODO: should be arbitrary-width, like NetBSD
+.Pp
+This implementation uses a simplistic wheel factorisation algorithm, which isn't going to win any awards soon.
+.\" TODO: should be stronger; I gave up on 18446744073709551557 (largest 64-bit prime) after 11 minutes

@@ 33,9 33,8 @@
 </table>
 <table class="Nm">
   <tr>
-    <td><code class="Nm">cat <var class="Ar">numbers</var>
-      <code class="Li">|</code> <code class="Nm">factor</code></code></td>
-    <td></td>
+    <td><code class="Nm">factor</code></td>
+    <td><code class="Li">&lt;</code> <span class="Pa">numbers</span></td>
   </tr>
 </table>
 </section>


@@ 66,9 65,9 @@ factor <var class="Ar">1410 1981</var>
 1981: 7 283
 
 <code class="Li">$</code> <code class="Nm">tr</code> <code class="Fl">-cd</code>
-  <code class="Li">'0-9\n \t' &lt; /dev/urandom |</code>
-  <code class="Nm">dd</code> <code class="Li">bs=60 count=1 |</code>
-  <code class="Nm"></code>factor
+  <code class="Li">'0-9 \t\n' &lt;</code> <span class="Pa">/dev/urandom</span>
+  <code class="Li">|</code> <code class="Nm">dd</code> <code class="Li">bs=60
+  count=1 |</code> <code class="Nm"></code>factor
 11: 11
 41615: 5 7 29 41
 0:


@@ 99,12 98,14 @@ factor <var class="Ar">1410 1981</var>
 <h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
 <p class="Pp"><var class="Ar">number</var>s are 64-bit integers
     ([<a class="permalink" href="#0"><b class="Sy" id="0">0</b></a>,
-    <a class="permalink" href="#18446744073709551616"><b class="Sy" id="18446744073709551616">18446744073709551616</b></a>]).</p>
+    <a class="permalink" href="#18446744073709551615"><b class="Sy" id="18446744073709551615">18446744073709551615</b></a>]).</p>
+<p class="Pp">This implementation uses a simplistic wheel factorisation
+    algorithm, which isn't going to win any awards soon.</p>
 </section>
 </div>
 <table class="foot">
   <tr>
-    <td class="foot-date">December 31, 2021</td>
+    <td class="foot-date">January 20, 2022</td>
     <td class="foot-os">voreutils pre-v0.0.0-latest</td>
   </tr>
 </table>

@@ 1,6 1,6 @@
 .\" SPDX-License-Identifier: 0BSD
 .\"
-.Dd July  4, 2021
+.Dd January  6, 2022
 .ds doc-volume-operating-system
 .Dt LINK 1
 .Os voreutils pre-v0.0.0-latest


@@ 29,11 29,15 @@ if
 failed.
 .
 .Sh SEE ALSO
+.Xr ln 1 ,
 .Xr unlink 1 ,
 .Xr link 2
 .
 .Sh STANDARDS
 Conforms to
-.St -p1003.1-2008 ,
-invented by
-.St -susv2 .
+.St -p1003.1-2008 .
+Created in
+.St -susv2
+as an
+.St -xcu5
+extension, with no further comments.

@@ 49,20 49,23 @@
 <section class="Sh">
 <h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
   ALSO</a></h1>
-<p class="Pp"><a class="Xr" href="../man1/unlink.1.html">unlink(1)</a>,
+<p class="Pp"><a class="Xr" href="../man1/ln.1.html">ln(1)</a>,
+    <a class="Xr" href="../man1/unlink.1.html">unlink(1)</a>,
     <a class="Xr" href="../man2/link.2.html">link(2)</a></p>
 </section>
 <section class="Sh">
 <h1 class="Sh" id="STANDARDS"><a class="permalink" href="#STANDARDS">STANDARDS</a></h1>
 <p class="Pp">Conforms to <span class="St">IEEE Std 1003.1-2008
-    (&#x201C;POSIX.1&#x201D;)</span>, invented by
+    (&#x201C;POSIX.1&#x201D;)</span>. Created in
     <span class="St">Version&#x00A0;2 of the Single UNIX Specification
-    (&#x201C;SUSv2&#x201D;)</span>.</p>
+    (&#x201C;SUSv2&#x201D;)</span> as an <span class="St">X/Open Commands and
+    Utilities Issue&#x00A0;5 (&#x201C;XCU5&#x201D;)</span> extension, with no
+    further comments.</p>
 </section>
 </div>
 <table class="foot">
   <tr>
-    <td class="foot-date">July 4, 2021</td>
+    <td class="foot-date">January 6, 2022</td>
     <td class="foot-os">voreutils pre-v0.0.0-latest</td>
   </tr>
 </table>

@@ 1,6 1,6 @@
 .\" SPDX-License-Identifier: 0BSD
 .\"
-.Dd December 30, 2021
+.Dd January 20, 2022
 .ds doc-volume-operating-system
 .Dt NPROC 1
 .Os voreutils pre-v0.0.0-latest


@@ 14,7 14,7 @@
 .Op Fl i Ar IGN
 .
 .Sh DESCRIPTION
-Prints the amount of available CPUs, followed by a newline, to the standard output stream.
+Prints the number of available CPUs, followed by a newline, to the standard output stream.
 This can be modeled as
 .Sy max Ns Pq Sy sysconf Ns Po Dv _SC_NPROCESSORS_ONLN Pc No - Ar IGN , Sy 1 .
 .

@@ 35,7 35,7 @@
 </section>
 <section class="Sh">
 <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
-<p class="Pp">Prints the amount of available CPUs, followed by a newline, to the
+<p class="Pp">Prints the number of available CPUs, followed by a newline, to the
     standard output stream. This can be modeled as
     <a class="permalink" href="#max"><b class="Sy" id="max">max</b></a>(<a class="permalink" href="#sysconf"><b class="Sy" id="sysconf">sysconf</b></a>(<code class="Dv">_SC_NPROCESSORS_ONLN</code>)
     <span class="No">-</span> <var class="Ar">IGN</var>,


@@ 69,7 69,7 @@
 </div>
 <table class="foot">
   <tr>
-    <td class="foot-date">December 30, 2021</td>
+    <td class="foot-date">January 20, 2022</td>
     <td class="foot-os">voreutils pre-v0.0.0-latest</td>
   </tr>
 </table>

@@ 1,6 1,6 @@
 .\" SPDX-License-Identifier: 0BSD
 .\"
-.Dd December 30, 2021
+.Dd January 20, 2022
 .ds doc-volume-operating-system
 .Dt PRINTENV 1
 .Os voreutils pre-v0.0.0-latest


@@ 15,7 15,7 @@
 .
 .Sh DESCRIPTION
 Prints all variables in the environment in their original format
-.Pq Ar KEY Ns Sy = Ns Ar VALUE
+.Pq Ev KEY Ns Sy = Ns Ev VALUE
 and order, separated by newlines.
 .Pp
 If


@@ 40,8 40,11 @@ specified didn't exist.
 .
 .Sh HISTORY
 .\" Do NOT add formatting here: this is copied from the raw 2BSD manpage
-Appeared, fully formed, in
+Appeared fully formed in
 .Bx 2
 as
 .Xr printenv UCB :
 .Dl Sy printenv No "[ name ]"
+.Pp
+.Fl 0
+is an extension, originating from the GNU system.

@@ 36,7 36,7 @@
 <section class="Sh">
 <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
 <p class="Pp">Prints all variables in the environment in their original format
-    (<var class="Ar">KEY</var><a class="permalink" href="#="><b class="Sy" id="=">=</b></a><var class="Ar">VALUE</var>)
+    (<code class="Ev">KEY</code><a class="permalink" href="#="><b class="Sy" id="=">=</b></a><code class="Ev">VALUE</code>)
     and order, separated by newlines.</p>
 <p class="Pp">If <var class="Ar">variable</var>s are specified, print their
     values, in the order specified, separated by newlines, instead.</p>


@@ 63,16 63,18 @@
 </section>
 <section class="Sh">
 <h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
-<p class="Pp">Appeared, fully formed, in <span class="Ux">2BSD</span> as
+<p class="Pp">Appeared fully formed in <span class="Ux">2BSD</span> as
     <a class="Xr" href="../manUCB/printenv.UCB.html">printenv(UCB)</a>:</p>
 <div class="Bd
   Bd-indent"><code class="Li"><a class="permalink" href="#printenv"><b class="Sy" id="printenv">printenv</b></a>
   <span class="No">[ name ]</span></code></div>
+<p class="Pp"><code class="Fl">-0</code> is an extension, originating from the
+    GNU system.</p>
 </section>
 </div>
 <table class="foot">
   <tr>
-    <td class="foot-date">December 30, 2021</td>
+    <td class="foot-date">January 20, 2022</td>
     <td class="foot-os">voreutils pre-v0.0.0-latest</td>
   </tr>
 </table>

@@ 1,6 1,6 @@
 .\" SPDX-License-Identifier: 0BSD
 .\"
-.Dd December 30, 2021
+.Dd January 20, 2022
 .ds doc-volume-operating-system
 .Dt SHRED 1
 .Os voreutils pre-v0.0.0-latest


@@ 12,9 12,9 @@
 .Nm
 .Op Fl fvzx
 .Op Fl s Ar size
-.Op Fl -random-source Ns = Ns Ar path
-.Op Fl u Ns | Ns Fl -remove Ns Op Ns = Ns Ar how
 .Op Fl n Ar iterations
+.Op Fl u Ns | Ns Fl -remove Ns Op Ns = Ns Ar how
+.Op Fl -random-source Ns = Ns Ar path
 .Ar file Ns …
 .
 .Sh DESCRIPTION


@@ 35,7 35,7 @@ You may be tempted to use this on regular files: don't.
 Just remove them instead of making more copies by overwriting them again.
 .
 .Sh OPTIONS
-.Bl -tag -compact -width ".Fl s , -size Ns = Ns Ar size"
+.Bl -tag -compact -width ".Fl n , -iterations Ns = Ns Ar count"
 .It Fl f , -force
 Change mode to
 .Li 0200 Pq write for owner


@@ 43,8 43,7 @@ if opening
 .Ar file
 failed with
 .Er EACCESS .
-.It Fl u
-.It Fl -remove Ns Op = Ns Ar how
+.It Fl u , -remove Ns Op = Ns Ar how
 Remove
 .Ar file
 after writing to it.


@@ 56,11 55,13 @@ Write
 NULs instead of the file length.
 Same format as
 .Xr stdbuf 1 .
+.Pp
+.
 .It Fl z , -zero
+All below ignored.
 .It Fl -random-source Ns = Ns Ar path
 .It Fl n , -iterations Ns = Ns Ar count
 .It Fl x , -exact
-Ignored.
 .El
 .
 .Sh HISTORY

@@ 29,10 29,10 @@
   <tr>
     <td><code class="Nm">shred</code></td>
     <td>[<code class="Fl">-fvzx</code>] [<code class="Fl">-s</code>
-      <var class="Ar">size</var>]
-      [<code class="Fl">--random-source</code>=<var class="Ar">path</var>]
+      <var class="Ar">size</var>] [<code class="Fl">-n</code>
+      <var class="Ar">iterations</var>]
       [<code class="Fl">-u</code>|<code class="Fl">--remove</code>[=<var class="Ar">how</var>]]
-      [<code class="Fl">-n</code> <var class="Ar">iterations</var>]
+      [<code class="Fl">--random-source</code>=<var class="Ar">path</var>]
       <var class="Ar">file</var>&#x2026;</td>
   </tr>
 </table>


@@ 58,9 58,8 @@
   <dd>Change mode to <code class="Li">0200</code> (write for owner) if opening
       <var class="Ar">file</var> failed with
     <code class="Er">EACCESS</code>.</dd>
-  <dt id="u"><a class="permalink" href="#u"><code class="Fl">-u</code></a></dt>
-  <dd style="width: auto;">&#x00A0;</dd>
-  <dt id="remove"><a class="permalink" href="#remove"><code class="Fl">--remove</code></a>[=<var class="Ar">how</var>]</dt>
+  <dt id="u"><a class="permalink" href="#u"><code class="Fl">-u</code></a>,
+    <code class="Fl">--remove</code>[=<var class="Ar">how</var>]</dt>
   <dd>Remove <var class="Ar">file</var> after writing to it.</dd>
   <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a>,
     <code class="Fl">--verbose</code></dt>


@@ 68,10 67,12 @@
   <dt id="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a>,
     <code class="Fl">--size</code>=<var class="Ar">size</var></dt>
   <dd>Write <var class="Ar">size</var> NULs instead of the file length. Same
-      format as <a class="Xr" href="../man1/stdbuf.1.html">stdbuf(1)</a>.</dd>
+      format as <a class="Xr" href="../man1/stdbuf.1.html">stdbuf(1)</a>.
+    <p class="Pp"></p>
+  </dd>
   <dt id="z"><a class="permalink" href="#z"><code class="Fl">-z</code></a>,
     <code class="Fl">--zero</code></dt>
-  <dd style="width: auto;">&#x00A0;</dd>
+  <dd>All below ignored.</dd>
   <dt id="random-source"><a class="permalink" href="#random-source"><code class="Fl">--random-source</code></a>=<var class="Ar">path</var></dt>
   <dd style="width: auto;">&#x00A0;</dd>
   <dt id="n"><a class="permalink" href="#n"><code class="Fl">-n</code></a>,


@@ 79,7 80,7 @@
   <dd style="width: auto;">&#x00A0;</dd>
   <dt id="x"><a class="permalink" href="#x"><code class="Fl">-x</code></a>,
     <code class="Fl">--exact</code></dt>
-  <dd>Ignored.</dd>
+  <dd style="width: auto;">&#x00A0;</dd>
 </dl>
 </section>
 <section class="Sh">


@@ 93,7 94,7 @@ This is laughable, of course.
 </div>
 <table class="foot">
   <tr>
-    <td class="foot-date">December 30, 2021</td>
+    <td class="foot-date">January 20, 2022</td>
     <td class="foot-os">voreutils pre-v0.0.0-latest</td>
   </tr>
 </table>

@@ 162,3 162,4 @@ This is not necessarily entirely unlike the user-space flushing daemons
 as found in Linux 1.1.3 through 2.5.12, though with a different scope
 .Pq Xr bdflush 2 is in some configurations an entire kernel-side flushing daemon
 and for a different reason (Linux being single-threaded).
+.\" TODO: the bdflush linux rag article?

@@ 1,6 1,6 @@
 .\" SPDX-License-Identifier: 0BSD
 .\"
-.Dd December 30, 2021
+.Dd January 20, 2022
 .ds doc-volume-operating-system
 .Dt TTY 1
 .Os voreutils pre-v0.0.0-latest


@@ 38,6 38,7 @@ otherwise.
 .Sh STANDARDS
 Conforms to
 .St -p1003.1-2008 .
+The long flags are an extension, originating from the GNU system.
 .Pp
 .St -p1003.2-92
 specifies


@@ 47,7 48,6 @@ but notes it as obsolescent, pointing toward the use of
 instead.
 .St -p1003.1-2001
 removes it.
-Don't use it.
 .
 .Sh HISTORY
 .\" Don't format, carefully copied from the UNIX Programmer's Manual


@@ 67,6 67,6 @@ introduced
 .Fl s ,
 initially undocumented, and switched to the new
 .Xr ttyname 3
-function, essentially making it into the
+function, arriving at the
 .Nm
 of today.

@@ 68,13 68,14 @@
 <section class="Sh">
 <h1 class="Sh" id="STANDARDS"><a class="permalink" href="#STANDARDS">STANDARDS</a></h1>
 <p class="Pp">Conforms to <span class="St">IEEE Std 1003.1-2008
-    (&#x201C;POSIX.1&#x201D;)</span>.</p>
+    (&#x201C;POSIX.1&#x201D;)</span>. The long flags are an extension,
+    originating from the GNU system.</p>
 <p class="Pp"><span class="St">IEEE Std 1003.2-1992
     (&#x201C;POSIX.2&#x201D;)</span> specifies <code class="Fl">-s</code>, but
     notes it as obsolescent, pointing toward the use of
     <code class="Nm">test</code> <code class="Fl">-t</code>
     <var class="Ar">0</var> instead. <span class="St">IEEE Std 1003.1-2001
-    (&#x201C;POSIX.1&#x201D;)</span> removes it. Don't use it.</p>
+    (&#x201C;POSIX.1&#x201D;)</span> removes it.</p>
 </section>
 <section class="Sh">
 <h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>


@@ 87,12 88,12 @@ writing &quot;<code class="Li">tty</code><var class="Ar">n</var>&quot; or
 <p class="Pp"><span class="Ux">Version&#x00A0;7 AT&amp;T UNIX</span> introduced
     <code class="Fl">-s</code>, initially undocumented, and switched to the new
     <a class="Xr" href="../man3/ttyname.3.html">ttyname(3)</a> function,
-    essentially making it into the <code class="Nm">tty</code> of today.</p>
+    arriving at the <code class="Nm">tty</code> of today.</p>
 </section>
 </div>
 <table class="foot">
   <tr>
-    <td class="foot-date">December 30, 2021</td>
+    <td class="foot-date">January 20, 2022</td>
     <td class="foot-os">voreutils pre-v0.0.0-latest</td>
   </tr>
 </table>

@@ 1,6 1,6 @@
 .\" SPDX-License-Identifier: 0BSD
 .\"
-.Dd December 30, 2021
+.Dd January 20, 2022
 .ds doc-volume-operating-system
 .Dt UNLINK 1
 .Os voreutils pre-v0.0.0-latest


@@ 10,15 10,36 @@
 .Nd remove file link
 .Sh SYNOPSIS
 .Nm
-.Ar file
-.Nm
-.Fl -
+.Op Fl -
 .Ar file
 .
 .Sh DESCRIPTION
 Removes
 .Ar file .
+.Pp
+Equivalent to running
+.Fn unlink file .
+.
+.Sh EXIT STATUS
+.Sy 1
+if
+.Xr unlink 2
+failed.
 .
 .Sh SEE ALSO
 .Xr rm 1 ,
 .Xr unlink 2
+.
+.Sh STANDARDS
+Conforms to
+.St -p1003.1-2008 ;
+.Fl -
+is an extension, originating from
+.Fx .
+.
+.Sh HISTORY
+Created in
+.St -susv2
+as an
+.St -xcu5
+extension, with no further comments.

@@ 28,19 28,21 @@
 <table class="Nm">
   <tr>
     <td><code class="Nm">unlink</code></td>
-    <td><var class="Ar">file</var></td>
-  </tr>
-</table>
-<table class="Nm">
-  <tr>
-    <td><code class="Nm">unlink</code></td>
-    <td><code class="Fl">--</code> <var class="Ar">file</var></td>
+    <td>[<code class="Fl">--</code>] <var class="Ar">file</var></td>
   </tr>
 </table>
 </section>
 <section class="Sh">
 <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
 <p class="Pp">Removes <var class="Ar">file</var>.</p>
+<p class="Pp" id="unlink">Equivalent to running
+    <a class="permalink" href="#unlink"><code class="Fn">unlink</code></a>(<var class="Fa">file</var>).</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
+  STATUS</a></h1>
+<p class="Pp"><a class="permalink" href="#1"><b class="Sy" id="1">1</b></a> if
+    <a class="Xr" href="../man2/unlink.2.html">unlink(2)</a> failed.</p>
 </section>
 <section class="Sh">
 <h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE


@@ 48,10 50,23 @@
 <p class="Pp"><a class="Xr" href="../man1/rm.1.html">rm(1)</a>,
     <a class="Xr" href="../man2/unlink.2.html">unlink(2)</a></p>
 </section>
+<section class="Sh">
+<h1 class="Sh" id="STANDARDS"><a class="permalink" href="#STANDARDS">STANDARDS</a></h1>
+<p class="Pp">Conforms to <span class="St">IEEE Std 1003.1-2008
+    (&#x201C;POSIX.1&#x201D;)</span>; <code class="Fl">--</code> is an
+    extension, originating from <span class="Ux">FreeBSD</span>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<p class="Pp">Created in <span class="St">Version&#x00A0;2 of the Single UNIX
+    Specification (&#x201C;SUSv2&#x201D;)</span> as an <span class="St">X/Open
+    Commands and Utilities Issue&#x00A0;5 (&#x201C;XCU5&#x201D;)</span>
+    extension, with no further comments.</p>
+</section>
 </div>
 <table class="foot">
   <tr>
-    <td class="foot-date">December 30, 2021</td>
+    <td class="foot-date">January 20, 2022</td>
     <td class="foot-os">voreutils pre-v0.0.0-latest</td>
   </tr>
 </table>