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.1 | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

(limited to 'listbas.1')

diff --git a/listbas.1 b/listbas.1
index a22e490..dce7340 100644
--- a/listbas.1
+++ b/listbas.1
@@ -27,25 +27,24 @@ 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 "LISTBAS" 1 "2024-06-26" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "LISTBAS" 1 "2024-07-01" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 listbas \- List the source of a tokenized Atari 8-bit BASIC program
 .SH SYNOPSIS
 .sp
-listbas [\fB\-v\fP] [\fB\-i\fP] [\fB\-a\fP | \fB\-u\fP ] \fBinput\-file\fP
+listbas [\fB\-v\fP] [\fB\-i\fP] [\fB\-a\fP | \fB\-m\fP ] \fBinput\-file\fP
 .SH DESCRIPTION
 .sp
 \fBlistbas\fP acts like the \fILIST\fP command in BASIC. It reads a
 tokenized (SAVEd) BASIC program and prints the code in human\-readable
 format.
 .sp
-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.
+By default, output is piped through \fBa8cat\fP(1), to covert ATASCII
+characters into Unicode equivalents. Raw ATASCII and "magazine listing"
+mode 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\&.
+\fBa8cat\fP is run as an external processe. The executables is searched
+for first in the current directory, and then in \fIPATH\fP\&.
 .SH OPTIONS
 .SS List options
 .INDENT 0.0
@@ -57,8 +56,9 @@ Include the immediate mode command (line 32768) in the output.
 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.
+.B \fB\-m\fP
+Output "magazine listing". Pipes output through \fBa8cat \-m\fP; see the man
+page for \fBa8cat\fP for details.
 .UNINDENT
 .SS General Options
 .INDENT 0.0
@@ -88,9 +88,10 @@ protection.
 \fBlistbas\fP doesn\(aqt show information about the variables. Use \fBvxrefbas\fP(1)
 for that.
 .IP \(bu 2
-\fBlistbas\fP will not write ATASCII data to your terminal. Instead, it uses
-\fBa8eol\fP(1) or \fBa8utf8\fP(1) to convert the output to something human\-readable
-that won\(aqt confuse the terminal.
+\fBlistbas\fP will not write ATASCII data to your terminal. By default, it uses
+\fBa8cat\fP(1) to convert the output to something human\-readable
+that won\(aqt confuse the terminal. When outputting raw ATASCII (\fB\-a\fP option),
+it refuses to run if standard output is a terminal.
 .IP \(bu 2
 \fBlistbas\fP only lists line 32768 (the immediate mode command) if
 specifically asked to do so.
-- 
cgit v1.2.3