From 3cb37d830a84710fc5493a953cc1a3b853e21f82 Mon Sep 17 00:00:00 2001 From: emma Date: Wed, 27 Mar 2024 00:14:34 -0600 Subject: [PATCH] mm.1: wording, consistency with dj.1 --- docs/mm.1 | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/docs/mm.1 b/docs/mm.1 index c8cc5dc..42a3e74 100644 --- a/docs/mm.1 +++ b/docs/mm.1 @@ -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