diff --git a/docs/dj.1 b/docs/dj.1 index ea73a75..d4c5053 100644 --- a/docs/dj.1 +++ b/docs/dj.1 @@ -43,6 +43,17 @@ dj .B output offset .R ]) .\" +.SH DESCRIPTION + +Perform precise read and write operations on files. This utility is useful for +reading and writing binary data to and from disks, hence the name. + +This manual page uses the terms \(lqskip\(rq and \(lqseek\(rq to refer to moving +to a specified byte by index in the input and output of the program +respectively. This language is inherited from the +.BR dd (1p) +utility and is used here to decrease ambiguity. +.\" .SH OPTIONS .IP \fB-i\fP @@ -61,7 +72,7 @@ Does the same as .B -b but for the output buffer. .IP \fB-S\fP -Skips a number of bytes through the output before starting to write from +Seeks a number of bytes through the output before starting to write from the input. If the output is a stream, null characters are printed. .IP \fB-a\fP Accepts a single literal byte with which input buffer is padded in the event @@ -86,6 +97,7 @@ Retries failed reads once more before exiting. .IP \fB-q\fP Suppresses error messages which print when a read or write is partial or empty. Each invocation decrements the debug level of the program. +.\" .SH STANDARD INPUT The standard input shall be used as an input if no inputs are specified or if