From 571796fe0d6ae440ff849f6a6ccbbba5e7760dd0 Mon Sep 17 00:00:00 2001 From: DTB Date: Thu, 4 Jul 2024 21:05:15 -0600 Subject: [PATCH] dj.1: update man page to match behavior --- docs/dj.1 | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/docs/dj.1 b/docs/dj.1 index 09f40c9..4c60ff7 100644 --- a/docs/dj.1 +++ b/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 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)