diff options
author | B. Watson <urchlay@slackware.uk> | 2024-07-14 01:03:50 -0400 |
---|---|---|
committer | B. Watson <urchlay@slackware.uk> | 2024-07-14 01:04:44 -0400 |
commit | dfc8edb273235c2494bad0d119990b2981978cbb (patch) | |
tree | 0db55d3ee004dfff4edd5b4858c91b9d3a7a0d09 /listbas.rst | |
parent | 9a50a4df8790a2bcc749e7b178c7cc725ac50691 (diff) | |
download | bw-atari8-tools-dfc8edb273235c2494bad0d119990b2981978cbb.tar.gz |
listbas: tweak doc.
Diffstat (limited to 'listbas.rst')
-rw-r--r-- | listbas.rst | 58 |
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 ===== |