diff options
Diffstat (limited to 'listamsb.1')
| -rw-r--r-- | listamsb.1 | 34 |
1 files changed, 27 insertions, 7 deletions
@@ -27,12 +27,12 @@ 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-12" "0.2.2" "Urchlay's Atari 8-bit Tools" +.TH "LISTAMSB" 1 "2025-03-17" "0.2.2" "Urchlay's Atari 8-bit Tools" .SH NAME listamsb \- List the source of a tokenized Atari Microsoft BASIC program .SH SYNOPSIS .sp -listamsb [\fB\-U\fP] | [\fB\-C\fP [\fB\-k\fP]] | [\fB\-D\fP] | [[\fB\-L\fP] [\fB\-a\fP] [\fB\-c\fP] [\fB\-v\fP] [\fB\-h\fP] [\fB\-i\fP] [\fB\-u\fP] [\fB\-t\fP] [\fB\-m\fP] [\fB\-n\fP] [\fB\-s\fP] [\fB\-r\fP \fIline\-range\fP] ...] [\fBinput\-file\fP] [\fBoutput\-file\fP] +listamsb [\fB\-U\fP] | [\fB\-C\fP [\fB\-k\fP]] | [\fB\-D\fP] | [[\fB\-L\fP] [\fB\-a\fP] [\fB\-c\fP] [\fB\-v\fP] [\fB\-h\fP] [\fB\-i\fP] [\fB\-u\fP] [\fB\-t\fP] [\fB\-m\fP] [\fB\-M\fP] [\fB\-n\fP] [\fB\-s\fP] [\fB\-r\fP \fIline\-range\fP] ...] [\fBinput\-file\fP] [\fBoutput\-file\fP] .SH DESCRIPTION .sp \fBlistamsb\fP acts like the \fILIST\fP command in Atari Microsoft BASIC. It reads a @@ -62,6 +62,9 @@ When listing a program to \fBstdout\fP, output is piped through 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\&. .sp \fBlistamsb\fP will not write binary data (ATASCII or tokenized BASIC) directly to a terminal, under any circumstances. @@ -118,7 +121,7 @@ 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 is not used, with this option. +ATASCII to a terminal. \fBa8cat\fP and \fBcolorize\-amsb\fP are not used, with this option. .TP .B \fB\-c\fP Check only. No output on \fBstdout\fP\&. Diagnostics are still printed on stderr, @@ -128,6 +131,10 @@ this option. .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. .TP +.B \fB\-M\fP +Monochrome listing: disable color syntax highlighting, meaning \fBcolorize\-amsb\fP +is not used. +.TP .B \fB\-r\fP \fIline\-range\fP Show only part of the listing. \fIline\-range\fP can be a single line, or a comma\- or hyphen\-separated pair of starting and ending line numbers (e.g. \fB100,200\fP, or @@ -287,11 +294,24 @@ spaces or other metacharacters, they must be escaped. .UNINDENT .SH LIMITATIONS .sp -Unlike \fBlistbas\fP, there\(aqs no color syntax highlighting. Probably there -never will be. +\fBlistamsb\fP may behave strangely when fed something other than a +tokenized AMSB program, at least if the first byte in the file +is \fB$00\fP or \fB$01\fP\&. Unfortunately, tokenized Atari BASIC (and +variants like Turbo and BASIC XL) begin with \fB$00\fP\&. Usually +you\(aqll get this error: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +not an AMSB file: program size too small (0). Atari BASIC file? +.ft P +.fi +.UNINDENT +.UNINDENT .sp -It\(aqs hard to reliably detect AMSB files. Most of the time, it can at least -detect Atari BASIC files, but occasionally you\(aqll get gibberish output instead. +\&...but occasionally you may get a bunch of warnings and gibberish +output instead. .SH EXIT STATUS .sp 0 for success, 1 if there was an error reading the input (e.g. file |