diff options
| -rw-r--r-- | listamsb.1 | 16 | ||||
| -rw-r--r-- | listamsb.rst | 16 |
2 files changed, 22 insertions, 10 deletions
@@ -39,10 +39,6 @@ listamsb [\fB\-U\fP] | [\fB\-C\fP] | [\fB\-D\fP] | [[\fB\-L\fP] [\fB\-a\fP] [\fB tokenized (SAVEd) AMSB program and prints the code in human\-readable format. .sp -By default, output is piped to \fBa8cat\fP(1), which converts the -ATASCII output to something that\(aqs human\-readable on modern terminals. -This means \fBa8cat\fP must be available somewhere in \fB$PATH\fP\&. -.sp \fBlistamsb\fP 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\(aqs no need to specify it. @@ -58,6 +54,15 @@ Programs can be "crunched" and "decrunched" with the \fB\-C\fP and \fB\-D\fP options. .sp If no \fBoutput\-file\fP is given, output is to \fBstdout\fP\&. +.sp +When listing a program to \fBstdout\fP, output is piped through +\fBa8cat\fP(1), which converts the ATASCII output to UTF\-8 that\(aqs +human\-readable on modern terminals. This means \fBa8cat\fP must be +available in your \fBPATH\fP\&. If this is not convenient, you can set +the location of \fBa8cat\fP via the \fBA8CAT\fP environment variable. +.sp +\fBlistamsb\fP will not write binary data (ATASCII or tokenized BASIC) +directly to a terminal. .SH OPTIONS .SS Operation Modes .INDENT 0.0 @@ -110,7 +115,7 @@ Output raw ATASCII. This option must be used with an ATASCII to a terminal. \fBa8cat\fP is not used, with this option. .TP .B \fB\-c\fP -Check only. No output on stdout. Diagnostics are still printed on stderr, +Check only. No output on \fBstdout\fP\&. Diagnostics are still printed on stderr, and the exit status is unchanged. It\(aqs an error to give an \fBoutput\-file\fP with this option. .TP @@ -146,6 +151,7 @@ the actual comments won\(aqt (\fI10 REM HELLO\fP will become \fI10 REM\fP). .B \fB\-v\fP Verbose output, on \fBstderr\fP\&. 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 (\fB\-C\fP, \fB\-D\fP, \fB\-L\fP, \fB\-U\fP). .TP .B \fB\-h\fP, \fB\-\-help\fP Print built\-in help and exit. 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. |