From c9fd10afc6c37e58ca8b60e77374ccd88175ea75 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Mon, 1 Jul 2024 17:24:48 -0400
Subject: a8xd: document color scheme.

---
 a8xd.1 | 86 ++++++++++++++++++++++++++++++++++++++++++++++++++++--------------
 1 file changed, 68 insertions(+), 18 deletions(-)

(limited to 'a8xd.1')

diff --git a/a8xd.1 b/a8xd.1
index 3b67077..74842ce 100644
--- a/a8xd.1
+++ b/a8xd.1
@@ -42,24 +42,8 @@ The ATASCII codes are converted to UTF\-8, in the same way as
 \fBa8cat\fP(1). Codes with the high bit set are displayed in inverse
 video, using ANSI/VT\-100 escape sequences.
 .sp
-By default, the output is colorized:
-.INDENT 0.0
-.INDENT 3.5
-.INDENT 0.0
-.IP \(bu 2
-Normal characters are green. This includes alphanumerics, spaces, and
-punctuation.
-.IP \(bu 2
-Codes \fB$00\fP (null, or ATASCII heart) and \fB$9B\fP (EOL) are red.
-.IP \(bu 2
-Control characters are yellow. This includes codes \fB$01\fP to \fB$1F\fP
-(control + letters/punctuation, escape, and arrow keys), \fB$60\fP, \fB$7B\fP, \fB$7D\fP
-(clear screen), \fB$7E\fP (backspace), and \fB$7F\fP (tab).
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.sp
-The colors and inverse rendering apply to both the ATASCII and hex bytes.
+By default, the output is colorized (see \fBCOLORS\fP, below). The
+colors and inverse rendering apply to both the ATASCII and hex bytes.
 .sp
 Without \fIinfile\fP, or if \fIinfile\fP is \fB\-\fP, \fBa8xd\fP reads from standard input.
 .SH OPTIONS
@@ -127,6 +111,72 @@ Show built\-in help and exit.
 .B \fB\-\-version\fP
 Show version number and exit.
 .UNINDENT
+.SH COLORS
+.sp
+The default color scheme is:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Non\-control characters are green. This includes alphanumerics, spaces, and
+punctuation. These are the characters that ATASCII has in common with
+ASCII.
+.IP \(bu 2
+Graphics characters are yellow. This includes \fB$01\fP to \fB$1a\fP (the
+alphabet, with the Control key held down), \fB$60\fP (the diamond), and
+\fB$7b\fP (the spade).
+.IP \(bu 2
+Codes \fB$00\fP (null, or ATASCII heart) and \fB$9B\fP (EOL) are red. These
+characters are used as delimiters, so it makes sense for them to
+stand out.
+.IP \(bu 2
+Cursor control characters are purple. These are characters that perform
+some action when printed to the \fIE:\fP device. These are:
+.INDENT 2.0
+.INDENT 3.5
+.INDENT 0.0
+.TP
+.B \fB$1b\fP
+Escape.
+.TP
+.B \fB$1c\fP through \fB$1f\fP
+Cursor movement (up/down/left/right arrows).
+.TP
+.B \fB$7d\fP
+Clear screen.
+.TP
+.B \fB$7e\fP
+Backspace.
+.TP
+.B \fB$7f\fP
+Tab.
+.TP
+.B \fB$9c\fP
+Delete line.
+.TP
+.B \fB$9d\fP
+Insert line.
+.TP
+.B \fB$9e\fP
+Clear tab stop.
+.TP
+.B \fB$9f\fP
+Set tab stop.
+.TP
+.B \fB$fd\fP
+Bell.
+.TP
+.B \fB$fe\fP
+Delete character.
+.TP
+.B \fB$ff\fP
+Insert character.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
 .SH NOTES
 .sp
 \fBa8xd\fP requires the terminal emulator to support UTF\-8 and use a
-- 
cgit v1.2.3