From 187d9486b762006cbb1efb12a7d8a49ae54ed14a Mon Sep 17 00:00:00 2001
From: emma <emma@tebibyte.media>
Date: Thu, 18 Apr 2024 08:44:44 -0600
Subject: [PATCH] dj.1: debug output clarification

---
 docs/dj.1 | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/dj.1 b/docs/dj.1
index 9bc2d82..175a32c 100644
--- a/docs/dj.1
+++ b/docs/dj.1
@@ -149,9 +149,10 @@ the following format:
 .R {ASCII record separator} {bytes written} {ASCII file separator}
 .RE
 
-If the
+This format for diagnostic output is designed to be machine-parseable for
+convenience. For a more human-readable format, the
 .B -H
-option is specified, the following format is used instead:
+option may be specified. In this event, the following format is used instead:
 
 .RS
 .R {records read} '+' {partial records read} '>' {records written}