aboutsummaryrefslogtreecommitdiff
path: root/a8utf8.rst
blob: 2d361933f5bec9fc9054a7e6e09f005ab4a82b22 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.. RST source for a8utf8(1) man page. Convert with:
..   rst2man.py a8utf8.rst > a8utf8.1
.. rst2man.py comes from the SBo development/docutils package.

======
a8utf8
======

--------------------------------------------------
Convert Atari 8-bit text to UTF-8 encoded Unicode.
--------------------------------------------------

.. include:: manhdr.rst

SYNOPSIS
========

*a8utf8* [**-i**] [*infile*] [*infile ...*]

*a8utf8* [**-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).

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::

  a8utf8 atari.txt > converted.txt

The output is plain UTF-8 Unicode, without BOM.

Inverse video (characters codes above **$80**) are translated to
their non-inverse equivalents, except **$9B** (Atari EOL), which is
translated to **\\n** (newline).

OPTIONS
=======

-i
  Input uses Atari XL/XE International Character Set encoding, rather than
  ATASCII graphics.

-t
  Print table of Atari to Unicode equivalents, in CSV format. Can
  be used with or without **-i** (two different tables).

.. include:: manftr.rst