diff --git a/docs/dj.1 b/docs/dj.1 index 7e4b40b..631fa7b 100644 --- a/docs/dj.1 +++ b/docs/dj.1 @@ -94,8 +94,9 @@ continue reading until a partial or empty read. .B -d .RS -Prints all debug information, user-specified or otherwise, before program -execution. Each invocation increments the debug level of the program. +Prints invocation information before program execution as described in the +DIAGNOSTICS section below. Each invocation increments the debug level of the +program. .RE .B -i @@ -133,9 +134,9 @@ is “-”. .SH DIAGNOSTICS -On a partial or empty read, dj prints a diagnostic message (unless the +On a partial or empty read, a diagnostic message is printed (unless the .B -q -option is specified) and exits (unless the +option is specified) and the program exits (unless the .B -n option is specified. @@ -159,6 +160,20 @@ option is specified, the following format is used instead: .R {ASCII line feed} .RE +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 +.B -d +as the only argument: + +.RS +.R argv0=dj +.R in= ibs=1024 skip=0 align=ff count=0 +.R out= obs=1024 seek=0 debug= 3 noerror=0 +.RE + In non-recoverable errors that don’t pertain to the read-write cycle, a diagnostic message is printed and the program exits with the appropriate sysexits.h(3) status.