diff --git a/docs/dj.1 b/docs/dj.1 index 175a32c..429b7fc 100644 --- a/docs/dj.1 +++ b/docs/dj.1 @@ -47,11 +47,27 @@ dj .SH OPTIONS -.B -A +.B -i .RS -If the output is a stream, null bytes are printed. In other words, it does what -.B -a -does but with null bytes instead. +Takes a file path as an argument to open and use as an input. +.RE + +.B -b +.RS +Takes a numeric argument as the size in bytes of the input buffer, with the +default being 1024 bytes or one kibibyte (KiB). +.RE + +.B -s +.RS +Takes a numeric argument as the number of bytes to skip into the input +before starting to read. If the standard input is used, bytes read to this point +are discarded. +.RE + +.B -o +.RS +Takes a file path as an argument to open and use as an output. .RE .B -B @@ -61,12 +77,6 @@ Does the same as but for the output buffer. .RE -.B -H -.RS -Prints diagnostics messages in a human-readable manner as described in the -DIAGNOSTICS section below. -.RE - .B -S .RS Skips a number of bytes through the output before starting to write from @@ -79,18 +89,20 @@ Accepts a single literal byte with which input buffer is padded in the event of an incomplete read from the input file. .RE -.B -b -.RS -Takes a numeric argument as the size in bytes of the input buffer, with the -default being 1024 bytes or one kibibyte (KiB). -.RE - .B -c .RS Specifies a number of reads to make. If set to zero (the default), reading will continue until a partial or empty read is encountered. .RE +.B -A +.RS +If the output is a stream, null bytes are printed. This option is equivalent to +specifying +.B -a +with a null byte instead of a character. +.RE + .B -d .RS Prints invocation information before program execution as described in the @@ -98,9 +110,10 @@ DIAGNOSTICS section below. Each invocation increments the debug level of the program. .RE -.B -i +.B -H .RS -Takes a file path as an argument to open and use as an input. +Prints diagnostics messages in a human-readable manner as described in the +DIAGNOSTICS section below. .RE .B -n @@ -108,18 +121,6 @@ Takes a file path as an argument to open and use as an input. Retries failed reads once more before exiting. .RE -.B -o -.RS -Takes a file path as an argument to open and use as an output. -.RE - -.B -s -.RS -Takes a numeric argument as the number of bytes to skip into the input -before starting to read. If the standard input is used, bytes read to this point -are discarded. -.RE - .B -q .RS Suppresses error messages which print when a read or write is partial or