bonsai
/
coreutils
5
4
Fork 2
Code Issues 36 Pull Requests 4 Projects 1 Releases 9 Activity

mm.1: wording, consistency with dj.1

This commit is contained in:
Emma Tebibyte 2024-03-27 00:14:34 -06:00
parent 6158a39a4a
commit 3cb37d830a
Signed by: emma
GPG Key ID: 06FA419A1698C270
1 changed files with 12 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/mm.1
View File

@ -26,12 +26,12 @@ Catenate input files and write them to the start of each output file or stream.
.B -a
.RS
Opens subsequent outputs for appending rather than updating.
Opens outputs for appending rather than updating.
.RE
.B -e
.RS
Set the output to the standard error.
Use the standard error as an output.
.RE
.B -i
@ -56,6 +56,11 @@ Ensures neither input or output will be buffered.
Causes SIGINT signals to be ignored.
.RE
.SH STANDARD INPUT
The standard input shall be used as an input if one or more of the input files
is “-”.
.SH DIAGNOSTICS
If an output can no longer be written mm prints a diagnostic message, ceases
@ -65,15 +70,15 @@ continues, eventually exiting unsuccessfully.
When an error is encountered, diagnostic message is printed and the program
exits with the appropriate sysexits.h(3) status.
.SH BUGS
.SH CAVEATS
Existing files are not truncated, which may lead to unexpected results.
Existing files are not truncated on ouput and are instead overwritten.
.SH RATIONALE
The cat(1p) and tee(1p) programs specified in POSIX provide equivalent
functionality. The separation of the two sets of functionality into separate
APIs seemed unncessary.
The cat(1p) and tee(1p) programs specified in POSIX together provide nearly
equivalent functionality. The separation of the two sets of functionality into
separate APIs seemed unncessary.
.SH COPYRIGHT