diff options
| -rw-r--r-- | a8xd.1 | 86 | ||||
| -rw-r--r-- | a8xd.rst | 70 |
2 files changed, 126 insertions, 30 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 @@ -23,18 +23,8 @@ The ATASCII codes are converted to UTF-8, in the same way as **a8cat**\(1). Codes with the high bit set are displayed in inverse video, using ANSI/VT-100 escape sequences. -By default, the output is colorized: - - - Normal characters are green. This includes alphanumerics, spaces, and - punctuation. - - - Codes **$00** (null, or ATASCII heart) and **$9B** (EOL) are red. - - - Control characters are yellow. This includes codes **$01** to **$1F** - (control + letters/punctuation, escape, and arrow keys), **$60**, **$7B**, **$7D** - (clear screen), **$7E** (backspace), and **$7F** (tab). - -The colors and inverse rendering apply to both the ATASCII and hex bytes. +By default, the output is colorized (see **COLORS**, below). The +colors and inverse rendering apply to both the ATASCII and hex bytes. Without *infile*, or if *infile* is **-**, **a8xd** reads from standard input. @@ -93,6 +83,62 @@ OPTIONS **--version** Show version number and exit. +COLORS +====== + +The default color scheme is: + + - Non-control characters are green. This includes alphanumerics, spaces, and + punctuation. These are the characters that ATASCII has in common with + ASCII. + + - Graphics characters are yellow. This includes **$01** to **$1a** (the + alphabet, with the Control key held down), **$60** (the diamond), and + **$7b** (the spade). + + - Codes **$00** (null, or ATASCII heart) and **$9B** (EOL) are red. These + characters are used as delimiters, so it makes sense for them to + stand out. + + - Cursor control characters are purple. These are characters that perform + some action when printed to the *E:* device. These are: + + **$1b** + Escape. + + **$1c** through **$1f** + Cursor movement (up/down/left/right arrows). + + **$7d** + Clear screen. + + **$7e** + Backspace. + + **$7f** + Tab. + + **$9c** + Delete line. + + **$9d** + Insert line. + + **$9e** + Clear tab stop. + + **$9f** + Set tab stop. + + **$fd** + Bell. + + **$fe** + Delete character. + + **$ff** + Insert character. + NOTES ===== |