diff options
author | B. Watson <urchlay@slackware.uk> | 2024-07-01 17:24:48 -0400 |
---|---|---|
committer | B. Watson <urchlay@slackware.uk> | 2024-07-01 17:24:48 -0400 |
commit | c9fd10afc6c37e58ca8b60e77374ccd88175ea75 (patch) | |
tree | f9a5c31c1e1353499b81115c3c223a930d32531d /a8xd.1 | |
parent | 98398b97b551c1c702ce3d6c145e8527d15c6b3d (diff) | |
download | bw-atari8-tools-c9fd10afc6c37e58ca8b60e77374ccd88175ea75.tar.gz |
a8xd: document color scheme.
Diffstat (limited to 'a8xd.1')
-rw-r--r-- | a8xd.1 | 86 |
1 files changed, 68 insertions, 18 deletions
@@ -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 |