From 35f4a061cc467b750e00894e4bea42e43599e26c Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Wed, 26 Jun 2024 04:47:08 -0400
Subject: listbas: tweak doc.

---
 listbas.1   | 12 ++++++++++--
 listbas.rst | 12 ++++++++++--
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/listbas.1 b/listbas.1
index 8f45458..a22e490 100644
--- a/listbas.1
+++ b/listbas.1
@@ -42,6 +42,10 @@ format.
 By default, output is piped through \fBa8eol\fP(1), to convert ATASCII
 characters to human\-readable sequences. Raw ATASCII and Unicode output
 are also available.
+.sp
+\fBa8eol\fP(1) and \fBa8utf8\fP(1) (for \fB\-u\fP) are run as external
+processes. The executables are searched for first in the current
+directory, and then in \fIPATH\fP\&.
 .SH OPTIONS
 .SS List options
 .INDENT 0.0
@@ -54,8 +58,7 @@ Output raw ATASCII; no translation to the host character set. Must be
 used with redirection; \fBlistbas\fP will not write ATASCII to the terminal.
 .TP
 .B \fB\-u\fP
-Use \fBa8utf8\fP(1) to translate ATASCII to ASCII. Requires \fBa8utf8\fP
-somewhere in \fIPATH\fP\&.
+Use \fBa8utf8\fP(1) to translate ATASCII to ASCII.
 .UNINDENT
 .SS General Options
 .INDENT 0.0
@@ -72,6 +75,11 @@ be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal.
 .UNINDENT
 .SH NOTES
 .sp
+\fBlistbas\fP will refuse to operate on a LIST\-protected program with
+scrambled variable names. For code\-protected programs, it will stop at
+the line with the invalid offset. Use \fBunprotbas\fP(1) to remove the
+protection.
+.sp
 \fBlistbas\fP is similar to Jindroush\(aqs \fBchkbas\fP(1). The main differences are:
 .INDENT 0.0
 .IP \(bu 2
diff --git a/listbas.rst b/listbas.rst
index 3a8e746..c4a937a 100644
--- a/listbas.rst
+++ b/listbas.rst
@@ -24,6 +24,10 @@ By default, output is piped through **a8eol**\(1), to convert ATASCII
 characters to human-readable sequences. Raw ATASCII and Unicode output
 are also available.
 
+**a8eol**\(1) and **a8utf8**\(1) (for **-u**) are run as external
+processes. The executables are searched for first in the current
+directory, and then in *PATH*.
+
 OPTIONS
 =======
 
@@ -38,14 +42,18 @@ List options
   used with redirection; **listbas** will not write ATASCII to the terminal.
 
 **-u**
-  Use **a8utf8**\(1) to translate ATASCII to ASCII. Requires **a8utf8**
-  somewhere in *PATH*.
+  Use **a8utf8**\(1) to translate ATASCII to ASCII.
 
 .. include:: genopts.rst
 
 NOTES
 =====
 
+**listbas** will refuse to operate on a LIST-protected program with
+scrambled variable names. For code-protected programs, it will stop at
+the line with the invalid offset. Use **unprotbas**\(1) to remove the
+protection.
+
 **listbas** is similar to Jindroush's **chkbas**\(1). The main differences are:
 
 - **listbas** only supports Atari BASIC, not Turbo BASIC or BASIC XL/XE.
-- 
cgit v1.2.3