diff options
Diffstat (limited to 'listamsb.rst')
| -rw-r--r-- | listamsb.rst | 24 |
1 files changed, 18 insertions, 6 deletions
diff --git a/listamsb.rst b/listamsb.rst index 92ab15f..3753bdf 100644 --- a/listamsb.rst +++ b/listamsb.rst @@ -11,7 +11,7 @@ List the source of a tokenized Atari Microsoft BASIC program SYNOPSIS ======== -listamsb [**-U**] | [**-C** [**-k**]] | [**-D**] | [[**-L**] [**-a**] [**-c**] [**-v**] [**-h**] [**-i**] [**-u**] [**-t**] [**-m**] [**-n**] [**-s**] [**-r** *line-range*] ...] [**input-file**] [**output-file**] +listamsb [**-U**] | [**-C** [**-k**]] | [**-D**] | [[**-L**] [**-a**] [**-c**] [**-v**] [**-h**] [**-i**] [**-u**] [**-t**] [**-m**] [**-M**] [**-n**] [**-s**] [**-r** *line-range*] ...] [**input-file**] [**output-file**] DESCRIPTION =========== @@ -43,6 +43,9 @@ When listing a program to **stdout**, output is piped through human-readable on modern terminals. This means **a8cat** must be available in your **PATH**\. If this is not convenient, you can set the location of **a8cat** via the **A8CAT** environment variable. +When listing in color (when the **-M** option is not used), **a8cat**\'s +output is piped through **colorize-amsb**, which also must be available +in your **PATH**\. **listamsb** will not write binary data (ATASCII or tokenized BASIC) directly to a terminal, under any circumstances. @@ -102,7 +105,7 @@ or **-U**. **-a** Output raw ATASCII. This option must be used with an **output-file**, a pipe, or redirection: **listamsb** will not write - ATASCII to a terminal. **a8cat** is not used, with this option. + ATASCII to a terminal. **a8cat** and **colorize-amsb** are not used, with this option. **-c** Check only. No output on **stdout**. Diagnostics are still printed on stderr, @@ -112,6 +115,10 @@ or **-U**. **-i**\, **-u**\, **-t**\, **-m**\, **-s** These options are passed to **a8cat**. See its man page for details. +**-M** + Monochrome listing: disable color syntax highlighting, meaning **colorize-amsb** + is not used. + **-r** *line-range* Show only part of the listing. *line-range* can be a single line, or a comma- or hyphen-separated pair of starting and ending line numbers (e.g. **100,200**, or @@ -273,11 +280,16 @@ ENVIRONMENT LIMITATIONS =========== -Unlike **listbas**, there's no color syntax highlighting. Probably there -never will be. +**listamsb** may behave strangely when fed something other than a +tokenized AMSB program, at least if the first byte in the file +is **$00** or **$01**. Unfortunately, tokenized Atari BASIC (and +variants like Turbo and BASIC XL) begin with **$00**. Usually +you'll get this error:: + + not an AMSB file: program size too small (0). Atari BASIC file? -It's hard to reliably detect AMSB files. Most of the time, it can at least -detect Atari BASIC files, but occasionally you'll get gibberish output instead. +\.\.\.but occasionally you may get a bunch of warnings and gibberish +output instead. EXIT STATUS =========== |