diff options
| author | B. Watson <urchlay@slackware.uk> | 2024-07-10 16:28:06 -0400 |
|---|---|---|
| committer | B. Watson <urchlay@slackware.uk> | 2024-07-10 16:29:32 -0400 |
| commit | a493bd91d6366113178633b86dfd4703f73b520d (patch) | |
| tree | 96895ced2dfd43d33c4570f6aab45c2526b48a06 /jindroush/man | |
| parent | 9b2d35c14476f60d10b40aa1fed8e746d848a51d (diff) | |
| download | bw-atari8-tools-a493bd91d6366113178633b86dfd4703f73b520d.tar.gz | |
chkbas: add missing left-paren to LEFT$/RIGHT$/MID$ for BXL/BXE; warn about ATASCII and mention a8cat in man page.
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 |