From f9f49e0e20ea64e99372b77e49b7cd9b84c25acf Mon Sep 17 00:00:00 2001 From: "B. Watson" 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.rst | 44 ++++++++++++++++++++++++++++++-------------- 1 file changed, 30 insertions(+), 14 deletions(-) (limited to 'listbas.rst') 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 -- cgit v1.2.3