1
0
forked from bonsai/harakit

all: formatting; mm(1): fixes speed, simplicity; docs/dj.1: grammar, typos, etc.

This commit is contained in:
2025-10-26 16:58:13 -06:00
parent 8eece4cf84
commit 8d8df711d9
47 changed files with 719 additions and 272 deletions

View File

@@ -1,4 +1,5 @@
.\" Copyright (c) 2024 DTB <trinity@trinity.moe>
.\" Copyright (c) 20242025 Emma Tebibyte <emma@tebibyte.media>
.\"
.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license,
.\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.
@@ -10,7 +11,7 @@ mm \(en middleman
.SH SYNOPSIS
mm
.RB [ -aetu ]
.RB [ -aet ]
.RB [ -i\ input ]
.RB [ -o\ output ]
.\"
@@ -26,16 +27,14 @@ Opens outputs for appending rather than updating.
Use the standard error as an output.
.IP \fB-t\fP
Causes outputs to be overwritten instead of being truncated.
.IP \fB-u\fP
Ensures neither input or output will be buffered.
.IP \fB-i\fP\ \fIinput\fP
Opens a path as an input. If one or more of the input files is \(lq-\(rq or if
no inputs are specified, the standard input shall be used. If specified as the
last option and if there are trailing arguments to the program, they shall be
appended to the list of files to use as inputs.
.IP \fB-o\fP\ \fIoutput\fP
Opens a path as an output. If one or more of the output files is \(lq-\(rq or if
no outputs are specified and the
Opens a path as an output. If one or more of the output files is \(lq-\(rq or
if no outputs are specified and the
.B -e
option is not specified, the standard output shall be used. If specified as the
last option and if there are trailing arguments to the program, they shall be
@@ -43,7 +42,7 @@ appended to the list of files to use as outputs.
.\"
.SH DIAGNOSTICS
If an output cannot be written to, an error occurs; however, exiting will be
If an output cannot be written to, an error occurs; however, exiting will be
deferred until writing to any other specified outputs completes.
When an error is encountered, a diagnostic message is printed and the program
@@ -57,10 +56,30 @@ The
.BR cat (1p)
and
.BR tee (1p)
programs specified in POSIX together provide similar functionality. The
programs specified in \*(Px together provide similar functionality. The
separation of the two sets of functionality into separate APIs seemed
unncessary.
.\"
.SH HISTORY
This utility originally had a \fB-u\fP option for compatibility with cat(1p),
but this option is almost always default behavior in practice; therefore, it
was dropped both for simplicity and to expand the
.BR dj (1)
utility\(cqs niche.
.\"
.SH AUTHOR
Written by DTB
.MT trinity@trinity.moe
.ME .
.\"
.SH COPYRIGHT
Copyright © 2023 DTB. License AGPLv3+: GNU AGPL version 3 or later
<https://gnu.org/licenses/agpl.html>.
.\"
.\"
.SH COPYRIGHT
Copyright \(co 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later