From 140ced429cba74084d65942840b1f97fc77d8d9b Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Tue, 23 Apr 2024 22:28:28 -0400
Subject: a8utf8: add -r (reverse) option.

---
 a8utf8.1 | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

(limited to 'a8utf8.1')

diff --git a/a8utf8.1 b/a8utf8.1
index 3ff998f..2a7bec4 100644
--- a/a8utf8.1
+++ b/a8utf8.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 "A8UTF8" 1 "2022-08-27" "0.2.0" "Urchlay's Atari 8-bit Tools"
+.TH "A8UTF8" 1 "2024-04-23" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 a8utf8 \- Convert Atari 8-bit text to UTF-8 encoded Unicode.
 .\" RST source for a8utf8(1) man page. Convert with:
@@ -38,15 +38,15 @@ a8utf8 \- Convert Atari 8-bit text to UTF-8 encoded Unicode.
 .
 .SH SYNOPSIS
 .sp
-\fIa8utf8\fP [\fB\-i\fP] [\fIinfile\fP] [\fIinfile ...\fP]
+\fIa8utf8\fP [\fB\-r\fP] [\fB\-i\fP] [\fIinfile\fP] [\fIinfile ...\fP]
 .sp
-\fIa8utf8\fP [\fB\-i\fP] \fB\-t\fP
+\fIa8utf8\fP [\fB\-r\fP] [\fB\-i\fP] \fB\-t\fP
 .SH DESCRIPTION
 .sp
-Convert Atari 8\-bit ATASCII or International Character Set text to
-UTF\-8 encoded Unicode. Control graphics characters are replaced with
-their nearest Unicode equivalents (mostly from the Box Drawing block,
-or from the Basic Latin block with \fB\-i\fP option).
+Convert Atari 8\-bit ATASCII or XL ICS (International Character
+Set) text to UTF\-8 encoded Unicode. Control graphics characters are
+replaced with their nearest Unicode equivalents (mostly from the Box
+Drawing block, or from the Basic Latin block with \fB\-i\fP option).
 .sp
 If no \fIinfile\fP is given, input is read from standard input. Output always
 goes to standard output; to write to a file, use a command like:
@@ -75,7 +75,12 @@ ATASCII graphics.
 .TP
 .B  \-t
 Print table of Atari to Unicode equivalents, in CSV format. Can
-be used with or without \fB\-i\fP (two different tables).
+be used with or without \fB\-i\fP and/or \fB\-r\fP (four different tables).
+.TP
+.B  \-r
+Reverse conversion: Input is UTF\-8, output is ATASCII (or XL ICS, with \fB\-i\fP).
+Beware that printing ATASCII to a terminal may look funny, and may even confuse
+the terminal. Redirecting to a file is safe.
 .UNINDENT
 .SH COPYRIGHT
 .sp
-- 
cgit v1.2.3