trinity/src
1
0
Fork 0
Code

update man page

Browse Source
This commit is contained in:
dtb 2024-01-09 23:25:38 -07:00
parent cb7e71989b
commit 8c65fec8f5
1 changed files with 15 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
dj/dj.1
View File

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