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

dj.1: grammar & formatting

Browse Source
This commit is contained in:
Emma Tebibyte 2024-05-24 10:21:06 -06:00
parent 922ee71283
commit b7f52902b6
Signed by: emma
GPG Key ID: 06FA419A1698C270
1 changed files with 18 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
docs/dj.1
View File

@ -138,9 +138,9 @@ On a partial or empty read, a diagnostic message is printed (unless the
.B -q
option is specified) and the program exits (unless the
.B -n
option is specified.
option is specified).
By default statistics are printed for input and output to the standard error in
By default, statistics are printed for input and output to the standard error in
the following format:
.RS
@ -163,9 +163,9 @@ option may be specified. In this event, the following format is used instead:
If the
.B -d
option is specified, debug output will be printed at the beginning of execution.
This debug information contains information regarding how the program was
invoked. The following example is the result of running the program with
option is specified, debug output will be printed at the beginning of
execution. This debug information contains information regarding how the program
was invoked. The following example is the result of running the program with
.B -d
as the only argument:
@ -183,29 +183,31 @@ sysexits.h(3) status.
If
.B -n
is specified along with a specified count, actual byte output may be lower than
expected (the product of the count multiplied by the input block size). If the
is specified along with the
.B -c
option and a count, actual byte output may be lower than expected (the product
of the count and the input block size). If the
.B -a
or
.B -A
options are used this could make data written nonsensical.
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.
options are used, this could make data written nonsensical.
.SH CAVEATS
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.
.SH RATIONALE
This program was based on the dd(1p) utility as specified in POSIX. While
character conversion may have been the original intent of dd(1p), it is
irrelevant to its modern use. Because of this, it eschews character conversion
and adds typical option formatting, allowing seeks to be specified in bytes
rather than in blocks, allowing arbitrary bytes as padding, and printing in a
format that’s easy to parse for machines.
irrelevant to its modern use. Because of this, this program eschews character
conversion and adds typical option formatting, allowing seeks to be specified
in bytes rather than in blocks, allowing arbitrary bytes as padding, and
printing in a format that’s easy for machines to parse.
.SH COPYRIGHT