bonsai/harakit
5
4
Fork 3
Code Issues 41 Pull Requests 7 Projects 1 Releases 30 Activity

dj.1: fixes ambiguity and false information

Browse Source
This commit is contained in:
Emma Tebibyte 2024-07-15 13:04:23 -06:00
parent 789046f694
commit e9496cb4a5
Signed by: emma
GPG Key ID: 06FA419A1698C270
1 changed files with 8 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/dj.1
View File

@ -181,22 +181,22 @@ 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.
Option variants that have uppercase and lowercase forms could be confused for Option variants that have lowercase and uppercase forms could be confused for
each other. The former affects input and the latter affects output. each other. The former affects input and the latter affects output.
The The
.B -B .B -B
option could be mistaken for write size, meaning the count in bytes of data option could be mistaken for write size, meaning the count in bytes of data
placed in the output. This conception is intuitive but incorrect; the amount of placed in the output. This conception is intuitive but incorrect, as the
data read and output is controlled by the
.B -c .B -c
and option controls the number of blocks to read and the
.B -b .B -b
options. The latter sets the size of blocks to be read and the former sets the option sets the size of the blocks. The
number of blocks to be read. The
.B -B .B -B
option is similar to the latter but sets the size of blocks to be written, option is similar to the latter but sets the size of blocks to be written,
regardless of the amount of data that will actually be written. regardless of the amount of data that will actually be written. In practice,
this means the input buffer should be very large to make use of modern hardware
input and output speeds.
The skipped or sought bytes while processing irregular files, such as streams, The skipped or sought bytes while processing irregular files, such as streams,
are reported in the diagnostic output, because they were actually read or are reported in the diagnostic output, because they were actually read or
@ -223,3 +223,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) .BR lseek (3p)
.BR mm (1)