From 70b0c2f9243385cb79d912aaf26372cbe4d88784 Mon Sep 17 00:00:00 2001
From: emma <emma@tebibyte.media>
Date: Fri, 29 Mar 2024 16:14:27 -0600
Subject: [PATCH] dj.1: fixed -d description

---
 docs/dj.1 | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

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=<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.