trinity/overgrown
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

dj.1: update man page to match behavior

Browse Source
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
1 changed files with 17 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
docs/dj.1
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
start reading or writing.
Seeks and skips aren\(cqt counted in the output statistics because they're
guaranteed to succeed (or the utility will exit unsuccessfully, before it has
written any data).
Seeks aren\(cqt counted in the output statistics because they\(cqre guaranteed
to succeed (or the utility will exit unsuccessfully, before it has written any
data).
.\"
.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.
Many lowercase options have capitalized variants and vice-versa which can be
confusing. Capitalized options tend to affect output or are more intense
versions of lowercase options.
The options
.B -b
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
@ -208,3 +218,4 @@ Copyright \(co 2023 DTB. License AGPLv3+: GNU AGPL version 3 or later
.\"
.SH SEE ALSO
.BR dd (1p)
.BR lseek (3p)