aboutsummaryrefslogtreecommitdiff
path: root/listbas.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-07-14 01:03:50 -0400
committerB. Watson <urchlay@slackware.uk>2024-07-14 01:04:44 -0400
commitdfc8edb273235c2494bad0d119990b2981978cbb (patch)
tree0db55d3ee004dfff4edd5b4858c91b9d3a7a0d09 /listbas.rst
parent9a50a4df8790a2bcc749e7b178c7cc725ac50691 (diff)
downloadbw-atari8-tools-dfc8edb273235c2494bad0d119990b2981978cbb.tar.gz
listbas: tweak doc.
Diffstat (limited to 'listbas.rst')
-rw-r--r--listbas.rst58
1 files changed, 13 insertions, 45 deletions
diff --git a/listbas.rst b/listbas.rst
index 855238a..46a44a4 100644
--- a/listbas.rst
+++ b/listbas.rst
@@ -98,44 +98,9 @@ COLORS
Color output only works on terminal emulators (or real terminals)
that support ANSI/VT220 style escape codes. This includes all modern
-terminal emulators, and most not-so-modern ones in the UNIX world.
+terminal emulators, and most not-so-modern ones in the UNIX world. See
+**NOTES** for a list of tested terminal emulators.
-The color scheme is adjustable via the **-c** option; see
-**Customization**, below. To avoid having to give your custom colors on
-the command line every time, see **ENVIRONMENT**, below.
-
-The default color scheme is:
-
-**yellow**
- Commands. Also "command operators" such as the **GOTO** in **ON/GOTO** and
- the **STEP** in a **FOR** command. These are really operators as far as
- BASIC is concerned, but it makes more sense to colorize them as commands.
-
-**green**
- Operators (except functions and "command operators"), quotes around
- strings, and commas between **DATA** elements.
-
-**purple**
- Functions.
-
-**red**
- Numbers (except line numbers at the start of a line) and string
- constants (but not the quotes around the string).
-
-**cyan**
- Line numbers at the start of a line and **DATA** items.
-
-**blue**
- Comments (**REM** text).
-
-**uncolorized**
- Variable names.
-
-Black and white are not used by default because presumably, one or the
-other is the background color of the terminal.
-
-Customization
--------------
You can customize the colors by using the **-c** *colors* option, either
on the command line, or in the **LISTBAS_OPTS** environment variable.
*colors* is a string of exactly 8 characters, each of which must be the
@@ -174,34 +139,37 @@ The colors are the standard ANSI ones, plus *n*:
The order they're used in the *colors* argument is:
**1**
- Commands.
+ BASIC keywords. Default: *3* (yellow).
**2**
- Operators.
+ Operators, including quotes around strings and commas between **DATA** items. Default: *2* (green).
**3**
- Functions.
+ Functions. Default: *5* (purple).
**4**
- Constants.
+ Constants (numeric or string). Default: *1* (red).
**5**
Line numbers (at the start of a line only; **GOTO** and **GOSUB** line numbers
- are constants).
+ are constants). Default: *6* (cyan).
**6**
- **DATA** items (but not the commas between them).
+ **REM** text. Default: *4* (blue).
**7**
- **REM** text.
+ **DATA** items (but not the commas between them). Default: *6* (cyan).
**8**
- Variable names.
+ Variable names. Default: *n* (uncolorized).
So, the default color scheme is equivalent to:
**-c** *3251646n*
+Black and white are not used by default because presumably, one or the
+other is the background color of the terminal.
+
NOTES
=====