diff options
Diffstat (limited to 'jindroush/man/chkbas.1')
| -rw-r--r-- | jindroush/man/chkbas.1 | 22 |
1 files changed, 17 insertions, 5 deletions
diff --git a/jindroush/man/chkbas.1 b/jindroush/man/chkbas.1 index 5fbcbae..f2664f3 100644 --- a/jindroush/man/chkbas.1 +++ b/jindroush/man/chkbas.1 @@ -27,14 +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 "CHKBAS" 1 "2024-05-19" "1.10" "Jindroush's Atari 8-bit tools" +.TH "CHKBAS" 1 "2024-07-10" "1.10" "Jindroush's Atari 8-bit tools" .SH NAME chkbas \- check and detokenize Atari BASIC SAVEd files .SH SYNOPSIS .sp chkbas [\fB\-atari\fP] [\fB\-short\fP] [\fB\-verbose\fP] [\fB\-noinverse\fP] [\fB\-tbs\fP | \fB\-bxl\fP | \fB\-bxe\fP] \fBbasic\-file\fP [\fBoutput\-file\fP] -.sp -listbas [\fB\-atari\fP] [\fB\-verbose\fP] [\fB\-noinverse\fP] [\fB\-tbs\fP | \fB\-bxl\fP | \fB\-bxe\fP] \fBbasic\-file\fP [\fBoutput\-file\fP] .SH DESCRIPTION .sp \fBchkbas\fP detokenizes Atari 8\-bit BASIC SAVEd files. It lists the BASIC @@ -47,7 +45,21 @@ standard output. If \fBbasic\-file\fP is anything other than standard Atari BASIC, the BASIC dialect must be specified (see \fBOPTIONS\fP, below). .sp -\fBlistbas\fP is simply an alias for \fBchkbas \-short\fP\&. +It\(aqs highly recommended to avoid running \fBchkbas\fP without +redirecting or piping its output: If the program contains ATASCII +graphics or inverse characters, they will be printed as\-is to the +terminal, which can confuse the terminal. For simply reading the code, +pipe to \fBa8cat\fP(1), thus: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +$ chkbas \-atari PROGRAM.BAS | a8cat +.ft P +.fi +.UNINDENT +.UNINDENT .sp Sample run, with no options: .INDENT 0.0 @@ -125,7 +137,7 @@ EOL characters (\fB$9B\fP). .B \fB\-short\fP Output only the program listing, with lines terminated by the system default newline character(s), e.g. \fBn\fP on UNIX\-like OSes, -\fBrn\fP on MS\-DOS or Windows. This is the default for \fBlistbas\fP\&. +\fBrn\fP on MS\-DOS or Windows. .TP .B \fB\-verbose\fP Program listing will be interspersed with per\-line and per\-statement |