diff options
Diffstat (limited to 'listamsb.rst')
| -rw-r--r-- | listamsb.rst | 42 |
1 files changed, 24 insertions, 18 deletions
diff --git a/listamsb.rst b/listamsb.rst index 3753bdf..2a86a23 100644 --- a/listamsb.rst +++ b/listamsb.rst @@ -38,14 +38,14 @@ If no **output-file** is given, output is to **stdout**. When output is to a file, the file will be overwritten without prompting if it already exists. -When listing a program to **stdout**, output is piped through -**a8cat**\(1), which converts the ATASCII output to UTF-8 that's -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**\. +By default, output is modern UTF-8 equivalents of the ATASCII +character set, with ANSI control sequences for inverse video and +color. See the **-M**, **-a**, **-i**, **-u**, **-t**, **-m**, **-s** +options to change the output style. + +When listing in color (when the **-M** option is not used), +**listamsb**\'s output is piped through **colorize-amsb**, which must +be available in your **PATH**\. **listamsb** will not write binary data (ATASCII or tokenized BASIC) directly to a terminal, under any circumstances. @@ -105,15 +105,28 @@ 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** and **colorize-amsb** are not used, with this option. + ATASCII to a terminal. **colorize-amsb** is not used, with this option. **-c** Check only. No output on **stdout**. Diagnostics are still printed on stderr, and the exit status is unchanged. It's an error to give an **output-file** with this option. -**-i**\, **-u**\, **-t**\, **-m**\, **-s** - These options are passed to **a8cat**. See its man page for details. +**-i** + Input uses Atari XL/XE International Character Set encoding, rather than + ATASCII graphics. + +**-u** + Use underlining for inverse video (see **a8cat**\(1) for more detail). + +**-t** + Text mode (see **a8cat**\(1) for more detail). + +**-m** + Magazine listing mode (see **a8cat**\(1) for more detail). + +**-s** + Strip bit 7 (inverse video bit; see **a8cat**\(1) for more detail). **-M** Monochrome listing: disable color syntax highlighting, meaning **colorize-amsb** @@ -270,13 +283,6 @@ continues processing. ENVIRONMENT =========== -**A8CAT** - - The path to the **a8cat**\(1) binary. Can be a full path or just - the executable name, in which case it will be searched for with the - normal **PATH** mechanism. If not set, *a8cat* is used. If there are - spaces or other metacharacters, they must be escaped. - LIMITATIONS =========== |