1
0

update man page

This commit is contained in:
dtb 2024-01-09 23:25:38 -07:00
parent cb7e71989b
commit 8c65fec8f5

33
dj/dj.1
View File

@ -7,7 +7,7 @@ dj \(en disk jockey
.SH SYNOPSIS
dj
.RB ( -AfHqQ )
.RB ( -AdHnq )
.RB ( -a
.RB [ byte ])
.RB ( -c
@ -79,20 +79,23 @@ continue reading until a partial or empty read.
.PP
On a partial or empty read, dj prints a diagnostic message (unless the
.B -q
or
.B -Q
options are specified) and exits (unless the
.B -f
option is specified) and exits (unless the
.B -n
option is specified, in which case only two consecutive empty reads will cause
dj to exit).
At exit, usage statistics are printed unless the option
.B -Q
is specified. The
.B -q
is specified a second time. The
.B -H
option will make these diagnostics human-readable.
.SH DIAGNOSTICS
The
.B -d
option prints all information, user-specified or otherwise, before program
execution.
.PP
When dj exits, by default statistics are printed for input and output to
standard error in the following format:
.PP
@ -105,20 +108,14 @@ If the
.B -H
option is specified dj instead uses this following format:
.PP
.R {records read} + {partial records read} > {records written}
.R + {partial records written} ; {bytes read} > {bytes written}
.R {records read} '+' {partial records read} '>' {records written}
.R '+' {partial records written} ';' {bytes read} '>' {bytes written}
.R {ASCII line feed}
.PP
The
.B -Q
option suppresses this output entirely.
.PP
The
.B -q
and
.B -Q
options suppress error messages which print when a read or write is partial or
empty.
option suppresses error messages which print when a read or write is partial or
empty and when used twice suppresses diagnostic output entirely.
.PP
In non-recoverable errors that don't pertain to dj's read-write cycle, a
diagnostic message is printed and dj exits with the appropriate sysexits(3)
@ -127,7 +124,7 @@ status.
.SH BUGS
If
.B -f
.B -n
is specified along with a specified count, actual byte output may be lower than
expected (the product of the count multiplied by the input block size). If the
.B -a