From 6a0ee6ab77d597e30ada80bd4fc1d1eb34b966bd Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Tue, 11 Mar 2025 14:32:10 -0400 Subject: listamsb: update man page. --- listamsb.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) (limited to 'listamsb.rst') diff --git a/listamsb.rst b/listamsb.rst index dac3c1e..08f762f 100644 --- a/listamsb.rst +++ b/listamsb.rst @@ -20,10 +20,6 @@ DESCRIPTION tokenized (SAVEd) AMSB program and prints the code in human-readable format. -By default, output is piped to **a8cat**\(1), which converts the -ATASCII output to something that's human-readable on modern terminals. -This means **a8cat** must be available somewhere in **$PATH**\. - **listamsb** supports both versions of Atari Microsoft BASIC: the disk-based version 1 and the cartridge-based version 2. The language is the same for both versions, so there's no need to specify it. @@ -40,6 +36,15 @@ options. If no **output-file** is given, output is to **stdout**. +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. + +**listamsb** will not write binary data (ATASCII or tokenized BASIC) +directly to a terminal. + OPTIONS ======= @@ -94,7 +99,7 @@ or **-U**. ATASCII to a terminal. **a8cat** is not used, with this option. **-c** - Check only. No output on stdout. Diagnostics are still printed on stderr, + 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. @@ -130,6 +135,7 @@ Utility Options **-v** Verbose output, on **stderr**. May be given twice for extra verbosity, which shows each line number, its offset, length, and end-of-line pointer. + Can be used with any of the mode options (**-C**, **-D**, **-L**, **-U**). **-h**\, **--help** Print built-in help and exit. -- cgit v1.2.3