diff options
Diffstat (limited to 'jindroush/man')
| -rw-r--r-- | jindroush/man/chkbas.1 | 18 | ||||
| -rw-r--r-- | jindroush/man/chkbas.rst | 8 |
2 files changed, 25 insertions, 1 deletions
diff --git a/jindroush/man/chkbas.1 b/jindroush/man/chkbas.1 index 1f5313a..f2664f3 100644 --- a/jindroush/man/chkbas.1 +++ b/jindroush/man/chkbas.1 @@ -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 "CHKBAS" 1 "2024-06-25" "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 @@ -45,6 +45,22 @@ standard output. If \fBbasic\-file\fP is anything other than standard Atari BASIC, the BASIC dialect must be specified (see \fBOPTIONS\fP, below). .sp +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 .INDENT 3.5 diff --git a/jindroush/man/chkbas.rst b/jindroush/man/chkbas.rst index e16f475..b6c678f 100644 --- a/jindroush/man/chkbas.rst +++ b/jindroush/man/chkbas.rst @@ -28,6 +28,14 @@ standard output. If **basic-file** is anything other than standard Atari BASIC, the BASIC dialect must be specified (see **OPTIONS**, below). +It's highly recommended to avoid running **chkbas** 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 **a8cat**\(1), thus:: + + $ chkbas -atari PROGRAM.BAS | a8cat + Sample run, with no options:: $ chkbas HELLO.BAS |