From dfc8edb273235c2494bad0d119990b2981978cbb Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Sun, 14 Jul 2024 01:03:50 -0400 Subject: listbas: tweak doc. --- listbas.rst | 58 +++++++++++++--------------------------------------------- 1 file changed, 13 insertions(+), 45 deletions(-) (limited to 'listbas.rst') 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 ===== -- cgit v1.2.3