dj.1: update man page to match behavior

This commit is contained in:
dtb 2024-07-04 21:05:15 -06:00
parent 9e8b82c4bb
commit 571796fe0d
Signed by: trinity
GPG Key ID: 34C0543BBB6AF81B

View File

@ -42,9 +42,9 @@ byte onwards. A programmer may think of a file as a zero-indexed array of
bytes; in this analogy, the offset given is the index of the byte at which to bytes; in this analogy, the offset given is the index of the byte at which to
start reading or writing. start reading or writing.
Seeks and skips aren\(cqt counted in the output statistics because they're Seeks aren\(cqt counted in the output statistics because they\(cqre guaranteed
guaranteed to succeed (or the utility will exit unsuccessfully, before it has to succeed (or the utility will exit unsuccessfully, before it has written any
written any data). data).
.\" .\"
.SH OPTIONS .SH OPTIONS
@ -185,9 +185,19 @@ option is specified, this could make written data nonsensical.
Existing files are not truncated on ouput and are instead overwritten. Existing files are not truncated on ouput and are instead overwritten.
Many lowercase options have capitalized variants and vice-versa which can be The options
confusing. Capitalized options tend to affect output or are more intense .B -b
versions of lowercase options. and
.B -B
could be confused for each other, and so could
.B -s
and
.BR -S .
The lowercase option affects input and the capitalized option affects output.
The discarded but read bytes skipped while processing irregular files, such as
streams, are reported in the diagnostic output. Bytes skipped while processing
regular files are not reported, as the bytes weren\(cqt read.
.\" .\"
.SH RATIONALE .SH RATIONALE
@ -208,3 +218,4 @@ Copyright \(co 2023 DTB. License AGPLv3+: GNU AGPL version 3 or later
.\" .\"
.SH SEE ALSO .SH SEE ALSO
.BR dd (1p) .BR dd (1p)
.BR lseek (3p)