aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-12-23 04:38:57 -0500
committerB. Watson <urchlay@slackware.uk>2024-12-23 04:38:57 -0500
commitac443ed49efc2163485ac27215e8340dba30acee (patch)
treed77159171b5518dcb5bab9fd3ee0f94d370d250e
parentaea3a3ec017ea0032a7debb04092c6e423e16fcb (diff)
downloaduxd-ac443ed49efc2163485ac27215e8340dba30acee.tar.gz
expand -c description in man page
-rw-r--r--uxd.139
-rw-r--r--uxd.rst35
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