~nabijaczleweli/voreutils

fd00cdf0b2777b2a68a240d38cd7cd24d3681fcd — наб autouploader 3 months ago 21a2b12
Manpage update by job 676543
M man1/factor.1 => man1/factor.1 +8 -4
@@ 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

M man1/factor.1.html => man1/factor.1.html +9 -8
@@ 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>

M man1/link.1 => man1/link.1 +8 -4
@@ 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.

M man1/link.1.html => man1/link.1.html +7 -4
@@ 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>

M man1/nproc.1 => man1/nproc.1 +2 -2
@@ 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 .
.

M man1/nproc.1.html => man1/nproc.1.html +2 -2
@@ 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>

M man1/printenv.1 => man1/printenv.1 +6 -3
@@ 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.

M man1/printenv.1.html => man1/printenv.1.html +5 -3
@@ 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>

M man1/shred.1 => man1/shred.1 +8 -7
@@ 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

M man1/shred.1.html => man1/shred.1.html +11 -10
@@ 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>

M man1/sync.1 => man1/sync.1 +1 -0
@@ 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?

M man1/tty.1 => man1/tty.1 +3 -3
@@ 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.

M man1/tty.1.html => man1/tty.1.html +5 -4
@@ 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>

M man1/unlink.1 => man1/unlink.1 +25 -4
@@ 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.

M man1/unlink.1.html => man1/unlink.1.html +23 -8
@@ 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>