From f9f49e0e20ea64e99372b77e49b7cd9b84c25acf Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Fri, 12 Jul 2024 06:01:59 -0400
Subject: listbas: code cleanup, add -x and -u opts, fix color bug in strings,
 don't highlight quotes around strings.

---
 listbas.1 | 46 +++++++++++++++++++++++++++++++---------------
 1 file changed, 31 insertions(+), 15 deletions(-)

(limited to 'listbas.1')

diff --git a/listbas.1 b/listbas.1
index 0fc70b4..97ebb9c 100644
--- a/listbas.1
+++ b/listbas.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 "LISTBAS" 1 "2024-07-11" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "LISTBAS" 1 "2024-07-12" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 listbas \- List the source of a tokenized Atari 8-bit BASIC program
 .SH SYNOPSIS
@@ -42,31 +42,46 @@ format.
 By default, output is Unicode in UTF\-8 encoding, with ANSI/VT220
 escape sequences for inverse video and color syntax highlighting.
 .SH OPTIONS
-.SS List options
+.SS Output modes
+.sp
+The default output mode is Unicode/UTF\-8 representations of ATASCII
+characters.
 .INDENT 0.0
 .TP
 .B \fB\-a\fP
 Output raw ATASCII; no translation to the host character set. Must be
 used with redirection; \fBlistbas\fP will not write ATASCII to the terminal.
 .TP
-.B \fB\-b\fP
-Use bold, for color output. This may make it easier to read on
-some terminals. Or, it may hurt your eyes...
-.TP
 .B \fB\-d\fP
 Print dots rather than Unicode/UTF\-8 characters. Color and inverse
 video are still supported in this mode. Use this only if your
 terminal \fIreally\fP doesn\(aqt support Unicode (e.g. \fBrxvt\fP(1)).
 .TP
-.B \fB\-i\fP
-Include the immediate mode command (line 32768) in the output.
-.TP
 .B \fB\-m\fP
 Output "magazine listing". See the \fB\-m\fP option for \fBa8cat\fP for details.
+Color is supported in this mode,
+.TP
+.B \fB\-x\fP
+Output Unicode/UTF\-8 representations of the XL International Character
+Set, rather than ATASCII.
+.UNINDENT
+.SS Other options
+.INDENT 0.0
+.TP
+.B \fB\-b\fP
+Use bold for color output. This may make it easier to read on
+some terminals. Or, it may hurt your eyes...
+.TP
+.B \fB\-i\fP
+Include the immediate mode command (line 32768) in the output.
 .TP
 .B \fB\-n\fP
-No color. Has no effect if \fB\-a\fP or \fB\-m\fP are in effect, since these
-modes don\(aqt support color anyway.
+No color. Has no effect if \fB\-a\fP is in effect, since this
+mode doesn\(aqt support color anyway. Disabling color does not
+disable reverse video.
+.TP
+.B \fB\-u\fP
+Use underlining for inverse video, rather than reverse video output.
 .UNINDENT
 .SS General Options
 .INDENT 0.0
@@ -103,15 +118,16 @@ Functions.
 .TP
 .B \fBred\fP
 Numbers (except line numbers at the start of a line) and string
-constants.
+constants (but not the quotes around the string).
 .TP
 .B \fBcyan\fP
 Line numbers at the start of a line, comments (\fBREM\fP text) and \fBDATA\fP elements.
 .UNINDENT
 .sp
-Variable names and commas between \fBDATA\fP elements are not highlighted,
-so they\(aqll appear in the default foreground color (usually white if the
-terminal has a black background, or black if the background is white).
+Quotes around strings, variable names, and commas between \fBDATA\fP
+elements are not highlighted, so they\(aqll appear in the default
+foreground color (usually white if the terminal has a black
+background, or black if the background is white).
 .sp
 Note that nothing is highlighted in blue. This is because it\(aqs
 difficult to read on many terminals. Also, black and white are not
-- 
cgit v1.2.3