diff options
Diffstat (limited to 'listamsb.1')
| -rw-r--r-- | listamsb.1 | 47 |
1 files changed, 25 insertions, 22 deletions
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "LISTAMSB" 1 "2025-03-17" "0.2.2" "Urchlay's Atari 8-bit Tools" +.TH "LISTAMSB" 1 "2025-04-01" "0.2.2" "Urchlay's Atari 8-bit Tools" .SH NAME listamsb \- List the source of a tokenized Atari Microsoft BASIC program .SH SYNOPSIS @@ -57,14 +57,14 @@ If no \fBoutput\-file\fP is given, output is to \fBstdout\fP\&. When output is to a file, the file will be overwritten without prompting if it already exists. .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. -When listing in color (when the \fB\-M\fP option is not used), \fBa8cat\fP\(aqs -output is piped through \fBcolorize\-amsb\fP, which also must be available -in your \fBPATH\fP\&. +By default, output is modern UTF\-8 equivalents of the ATASCII +character set, with ANSI control sequences for inverse video and +color. See the \fB\-M\fP, \fB\-a\fP, \fB\-i\fP, \fB\-u\fP, \fB\-t\fP, \fB\-m\fP, \fB\-s\fP +options to change the output style. +.sp +When listing in color (when the \fB\-M\fP option is not used), +\fBlistamsb\fP\(aqs output is piped through \fBcolorize\-amsb\fP, which must +be available in your \fBPATH\fP\&. .sp \fBlistamsb\fP will not write binary data (ATASCII or tokenized BASIC) directly to a terminal, under any circumstances. @@ -121,15 +121,28 @@ or \fB\-U\fP\&. .B \fB\-a\fP Output raw ATASCII. This option must be used with an \fBoutput\-file\fP, a pipe, or redirection: \fBlistamsb\fP will not write -ATASCII to a terminal. \fBa8cat\fP and \fBcolorize\-amsb\fP are not used, with this option. +ATASCII to a terminal. \fBcolorize\-amsb\fP is not used, with this option. .TP .B \fB\-c\fP 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 -.B \fB\-i\fP, \fB\-u\fP, \fB\-t\fP, \fB\-m\fP, \fB\-s\fP -These options are passed to \fBa8cat\fP\&. See its man page for details. +.B \fB\-i\fP +Input uses Atari XL/XE International Character Set encoding, rather than +ATASCII graphics. +.TP +.B \fB\-u\fP +Use underlining for inverse video (see \fBa8cat\fP(1) for more detail). +.TP +.B \fB\-t\fP +Text mode (see \fBa8cat\fP(1) for more detail). +.TP +.B \fB\-m\fP +Magazine listing mode (see \fBa8cat\fP(1) for more detail). +.TP +.B \fB\-s\fP +Strip bit 7 (inverse video bit; see \fBa8cat\fP(1) for more detail). .TP .B \fB\-M\fP Monochrome listing: disable color syntax highlighting, meaning \fBcolorize\-amsb\fP @@ -282,16 +295,6 @@ you see this warning, you\(aqll also see \fIN\fP <unknown token \fIXX\fP> messages in the actual listing. .UNINDENT .SH ENVIRONMENT -.sp -\fBA8CAT\fP -.INDENT 0.0 -.INDENT 3.5 -The path to the \fBa8cat\fP(1) binary. Can be a full path or just -the executable name, in which case it will be searched for with the -normal \fBPATH\fP mechanism. If not set, \fIa8cat\fP is used. If there are -spaces or other metacharacters, they must be escaped. -.UNINDENT -.UNINDENT .SH LIMITATIONS .sp \fBlistamsb\fP may behave strangely when fed something other than a |