dj.1: update man page to match behavior
This commit is contained in:
parent
9e8b82c4bb
commit
571796fe0d
23
docs/dj.1
23
docs/dj.1
@ -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)
|
||||||
|
Loading…
Reference in New Issue
Block a user