a8utf8: add -r (reverse) option.

1 files changed, 12 insertions, 7 deletions

diff --git a/a8utf8.rst b/a8utf8.rst
index 2d36193..ec9fbba 100644
--- a/a8utf8.rst
+++ b/a8utf8.rst
@@ -15,17 +15,17 @@ Convert Atari 8-bit text to UTF-8 encoded Unicode.
 SYNOPSIS
 ========
 
-*a8utf8* [**-i**] [*infile*] [*infile ...*]
+*a8utf8* [**-r**] [**-i**] [*infile*] [*infile ...*]
 
-*a8utf8* [**-i**] **-t**
+*a8utf8* [**-r**] [**-i**] **-t**
 
 DESCRIPTION
 ===========
 
-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 **-i** 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 **-i** option).
 
 If no *infile* is given, input is read from standard input. Output always
 goes to standard output; to write to a file, use a command like::
@@ -47,6 +47,11 @@ OPTIONS
 
 -t
   Print table of Atari to Unicode equivalents, in CSV format. Can
-  be used with or without **-i** (two different tables).
+  be used with or without **-i** and/or **-r** (four different tables).
+
+-r
+  Reverse conversion: Input is UTF-8, output is ATASCII (or XL ICS, with **-i**).
+  Beware that printing ATASCII to a terminal may look funny, and may even confuse
+  the terminal. Redirecting to a file is safe.
 
 .. include:: manftr.rst