From a493bd91d6366113178633b86dfd4703f73b520d Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Wed, 10 Jul 2024 16:28:06 -0400
Subject: chkbas: add missing left-paren to LEFT$/RIGHT$/MID$ for BXL/BXE; warn
 about ATASCII and mention a8cat in man page.

---
 jindroush/man/chkbas.1 | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

(limited to 'jindroush/man/chkbas.1')

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
-- 
cgit v1.2.3