intcmp.1: compares integers to each other

docs/dj.1

@@ -49,7 +49,7 @@ dj
 
 .B -A
 .RS
-If the output is a stream, nul bytes are printed. In other words, it does what
+If the output is a stream, null bytes are printed. In other words, it does what
 .B -a
 does but with null bytes instead.
 .RE
@@ -71,7 +71,7 @@ DIAGNOSTICS section below.
 .RS
 Skips a number of bytes through the output before starting to write from
 the input. If the input is a stream the bytes are read and discarded. If the
-output is a stream, nul characters are printed.
+output is a stream, null characters are printed.
 .RE
 
 .B -a
@@ -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
@@ -128,14 +129,14 @@ empty. Each invocation decrements the debug level of the program.
 
 .SH STANDARD INPUT
 
-The standard input shall be used as an input if one or more of the input files
-is “-”.
+The standard input shall be used as an input if no inputs are specified one or
+more of the input files 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=<stdin>      ibs=1024        skip=0  align=ff       count=0
+.R out=<stdout>    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.

docs/intcmp.1

@@ -19,7 +19,7 @@ intcmp
 
 .SH DESCRIPTION
 
-Compare integers.
+Compare integers to each other.
 
 .SH USAGE