aboutsummaryrefslogtreecommitdiff
path: root/a8utf8.1
diff options
context:
space:
mode:
Diffstat (limited to 'a8utf8.1')
-rw-r--r--a8utf8.121
1 files changed, 13 insertions, 8 deletions
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