From ac443ed49efc2163485ac27215e8340dba30acee Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Mon, 23 Dec 2024 04:38:57 -0500
Subject: expand -c description in man page

---
 uxd.1   | 39 ++++++++++++++++++++++++++++++++++++---
 uxd.rst | 35 +++++++++++++++++++++++++++++++++--
 2 files changed, 69 insertions(+), 5 deletions(-)

diff --git a/uxd.1 b/uxd.1
index 2c3ffc2..049d649 100644
--- a/uxd.1
+++ b/uxd.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "UXD" 1 "2024-12-22" "0.3.0" "Urchlay's Utilities"
+.TH "UXD" 1 "2024-12-23" "0.3.0" "Urchlay's Utilities"
 .SH NAME
 uxd \- UTF-8 hex dumper
 .SH SYNOPSIS
@@ -94,11 +94,44 @@ terminal and its color settings. Ignored if \fB\-m\fP given.
 .TP
 .BI \-c \ nnnnn
 Set the colors to use. Must be 2 to 5 digits, from 0 to 7. These are
-standard ANSI colors. The first 2 are the alternating colors for
-normal characters, the 3rd and 4th (optional) are the alternating color for non\-printable
+standard ANSI colors:
+.INDENT 7.0
+.TP
+.B 0
+black
+.TP
+.B 1
+red
+.TP
+.B 2
+green
+.TP
+.B 3
+yellow
+.TP
+.B 4
+blue
+.TP
+.B 5
+purple
+.TP
+.B 6
+cyan
+.TP
+.B 7
+white
+.UNINDENT
+.sp
+The first 2 digits are the alternating colors for
+normal characters, the 3rd and 4th (optional) are the alternating colors for non\-printable
 and space characters, and the 5th (optional) is for invalid UTF\-8
 sequences. Default: \fB23561\fP\&. This option also disables a prior \fB\-m\fP
 option.
+.sp
+Note that the default color set doesn\(aqt include white or black:
+usually one of these is the terminal\(aqs background
+color. Also, it avoids blue, because blue text is hard to read on
+many terminals.
 .UNINDENT
 .\" colors (2 to 5 digits, 0 to 7).
 .
diff --git a/uxd.rst b/uxd.rst
index 7fc1800..eddbd4f 100644
--- a/uxd.rst
+++ b/uxd.rst
@@ -77,12 +77,43 @@ as *K*, *M*, and *G* for power-of-10 based (e.g. *1K* is 1000 bytes).
 
 -c nnnnn
   Set the colors to use. Must be 2 to 5 digits, from 0 to 7. These are
-  standard ANSI colors. The first 2 are the alternating colors for
-  normal characters, the 3rd and 4th (optional) are the alternating color for non-printable
+  standard ANSI colors:
+
+  0
+    black
+
+  1
+    red
+
+  2
+    green
+
+  3
+    yellow
+
+  4
+    blue
+
+  5
+    purple
+
+  6
+    cyan
+
+  7
+    white
+
+  The first 2 digits are the alternating colors for
+  normal characters, the 3rd and 4th (optional) are the alternating colors for non-printable
   and space characters, and the 5th (optional) is for invalid UTF-8
   sequences. Default: **23561**. This option also disables a prior **-m**
   option.
 
+  Note that the default color set doesn't include white or black:
+  usually one of these is the terminal's background
+  color. Also, it avoids blue, because blue text is hard to read on
+  many terminals.
+
 .. colors (2 to 5 digits, 0 to 7).
 
 -d data
-- 
cgit v1.2.3