From 869862a4db0c727e3797b15d41d6b865cb8f3350 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Mon, 1 Jul 2024 19:13:14 -0400
Subject: listbas: use a8cat instead of a8utf8 or a8eol.

---
 listbas.rst | 25 +++++++++++++------------
 1 file changed, 13 insertions(+), 12 deletions(-)

(limited to 'listbas.rst')

diff --git a/listbas.rst b/listbas.rst
index c4a937a..d6d17b1 100644
--- a/listbas.rst
+++ b/listbas.rst
@@ -11,7 +11,7 @@ List the source of a tokenized Atari 8-bit BASIC program
 SYNOPSIS
 ========
 
-listbas [**-v**] [**-i**] [**-a** | **-u** ] **input-file**
+listbas [**-v**] [**-i**] [**-a** | **-m** ] **input-file**
 
 DESCRIPTION
 ===========
@@ -20,13 +20,12 @@ DESCRIPTION
 tokenized (SAVEd) BASIC program and prints the code in human-readable
 format.
 
-By default, output is piped through **a8eol**\(1), to convert ATASCII
-characters to human-readable sequences. Raw ATASCII and Unicode output
-are also available.
+By default, output is piped through **a8cat**\(1), to covert ATASCII
+characters into Unicode equivalents. Raw ATASCII and "magazine listing"
+mode 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*.
+**a8cat** is run as an external processe. The executables is searched
+for first in the current directory, and then in *PATH*.
 
 OPTIONS
 =======
@@ -41,8 +40,9 @@ List options
   Output raw ATASCII; no translation to the host character set. Must be
   used with redirection; **listbas** will not write ATASCII to the terminal.
 
-**-u**
-  Use **a8utf8**\(1) to translate ATASCII to ASCII.
+**-m**
+  Output "magazine listing". Pipes output through **a8cat -m**; see the man
+  page for **a8cat** for details.
 
 .. include:: genopts.rst
 
@@ -61,9 +61,10 @@ protection.
 - **listbas** doesn't show information about the variables. Use **vxrefbas**\(1)
   for that.
 
-- **listbas** will not write ATASCII data to your terminal. Instead, it uses
-  **a8eol**\(1) or **a8utf8**\(1) to convert the output to something human-readable
-  that won't confuse the terminal.
+- **listbas** will not write ATASCII data to your terminal. By default, it uses
+  **a8cat**\(1) to convert the output to something human-readable
+  that won't confuse the terminal. When outputting raw ATASCII (**-a** option),
+  it refuses to run if standard output is a terminal.
 
 - **listbas** only lists line 32768 (the immediate mode command) if
   specifically asked to do so.
-- 
cgit v1.2.3