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.1 | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) (limited to 'listamsb.1') diff --git a/listamsb.1 b/listamsb.1 index 9273525..a75ad23 100644 --- a/listamsb.1 +++ b/listamsb.1 @@ -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. -- cgit v1.2.3