aboutsummaryrefslogtreecommitdiff
path: root/listbas.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-07-12 06:01:59 -0400
committerB. Watson <urchlay@slackware.uk>2024-07-12 06:01:59 -0400
commitf9f49e0e20ea64e99372b77e49b7cd9b84c25acf (patch)
tree82a26b2facc19bbb4f76e3fd2de37dd3b98cc862 /listbas.rst
parentd3f053d40f01aa807c10f0699ed9ff4349150adc (diff)
downloadbw-atari8-tools-f9f49e0e20ea64e99372b77e49b7cd9b84c25acf.tar.gz
listbas: code cleanup, add -x and -u opts, fix color bug in strings, don't highlight quotes around strings.
Diffstat (limited to 'listbas.rst')
-rw-r--r--listbas.rst44
1 files changed, 30 insertions, 14 deletions
diff --git a/listbas.rst b/listbas.rst
index d0c6e61..8321ab1 100644
--- a/listbas.rst
+++ b/listbas.rst
@@ -26,31 +26,46 @@ escape sequences for inverse video and color syntax highlighting.
OPTIONS
=======
-List options
+Output modes
------------
+The default output mode is Unicode/UTF-8 representations of ATASCII
+characters.
+
**-a**
Output raw ATASCII; no translation to the host character set. Must be
used with redirection; **listbas** will not write ATASCII to the terminal.
-**-b**
- Use bold, for color output. This may make it easier to read on
- some terminals. Or, it may hurt your eyes...
-
**-d**
Print dots rather than Unicode/UTF-8 characters. Color and inverse
video are still supported in this mode. Use this only if your
terminal *really* doesn't support Unicode (e.g. **rxvt**\(1)).
-**-i**
- Include the immediate mode command (line 32768) in the output.
-
**-m**
Output "magazine listing". See the **-m** option for **a8cat** for details.
+ Color is supported in this mode,
+
+**-x**
+ Output Unicode/UTF-8 representations of the XL International Character
+ Set, rather than ATASCII.
+
+Other options
+-------------
+
+**-b**
+ Use bold for color output. This may make it easier to read on
+ some terminals. Or, it may hurt your eyes...
+
+**-i**
+ Include the immediate mode command (line 32768) in the output.
**-n**
- No color. Has no effect if **-a** or **-m** are in effect, since these
- modes don't support color anyway.
+ No color. Has no effect if **-a** is in effect, since this
+ mode doesn't support color anyway. Disabling color does not
+ disable reverse video.
+
+**-u**
+ Use underlining for inverse video, rather than reverse video output.
.. include:: genopts.rst
@@ -76,14 +91,15 @@ The color scheme is:
**red**
Numbers (except line numbers at the start of a line) and string
- constants.
+ constants (but not the quotes around the string).
**cyan**
Line numbers at the start of a line, comments (**REM** text) and **DATA** elements.
-Variable names and commas between **DATA** elements are not highlighted,
-so they'll 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 **DATA**
+elements are not highlighted, so they'll appear in the default
+foreground color (usually white if the terminal has a black
+background, or black if the background is white).
Note that nothing is highlighted in blue. This is because it's
difficult to read on many terminals. Also, black and white are not