****************************************************************************
******************************************************************************
**                                                                          **
**                       Conversion Table EDitor 1.3                        **
**                                                                          **
**                                                                          **
**                     (c) 1993 MJSoft System Software                      **
**                                                                          **
**                                    -                                     **
**                                                                          **
**                              Martin  Mares                               **
**                                                                          **
**                                   and                                    **
**                                                                          **
**                              Tomas Zikmund                               **
**                                                                          **
******************************************************************************
 ****************************************************************************


   CONTENTS:
   ---------

  1. Preview
  2. System requirements
  3. How to start CTED
  4. The main window
  5. The Convert utility
  6. The conversion table format
  7. Remarks


1. Preview
----------

   This utility allows you to define your own conversion tables for Columns
and Convert (a small text conversion utility, which will be described later).

   Main features:

     - Written completely in assembly

     - Kickstart 2.0 and 3.0 compatible

     - Kickstart 2.0 look


   CTED  and  its documentation is Copyright (c) Martin Mares & Tomas Zikmund,
MJSoft System Software, Prague, Czech Republic.

   This  archive  can be freely redistributed, as long as all of its files are
included   in   their  original  form  without  any  additions,  deletions  or
modifications, and no more than a nominal fee is charged for its distribution.
All  copyright  notices  in  the programs and accompanying documentation files
must  remain  on  their places.  Also '.displayme' and other similar files may
not be added.  This is generally known as FREEWARE.

   Special  permission is given to Fred Fish to distribute this program on his
"Fish Disks".

   This  software  is  provided  "AS  IS" without warranty of any kind, either
expressed  or implied.  The author is not responsible for any damage caused by
it.


2. System requirements
----------------------

   This program requires:

      - Kickstart 1.2 or higher

      - Arp.library

      - Req.library

      - ReqTools.library (optional - if present, CTED uses it)

      - Some free memory


3. How to start CTED
--------------------

   There are two ways to start CTED and pass it the parameters:

      - Start it from CLI

      - Start it from Workbench by doubleclicking its icon.


4. The main window
------------------

   If you start CTED, the main window will appear.

   This window contains:

      - A part of the conversion table with proportional gadget used for
        scrolling.  This table has format "x (X) -> y (Y)", where X is the
        character to be converted (x is its code) and Y is the character,
        which will X be converted to (y is its code). One line of the table is
        highlighted (displayed in inverse video). This is the active line,
        which is being edited.

      - Two string gadgets named "Code" and "ASCII" used for editing the table
        manually.

      - The LOAD gadget - loads a conversion table from specified file

      - The SAVE gadget - saves the conversion table to specified file

      - The INIT gadget - performs conversion table initialization

      - The DIFF gadget - performs differential scanning. You supply two files
        (each maximally 256 bytes long). CTED will create a conversion table
        saying each character in the first file will be converted to the
        character found in the second file on the same position.

      - The SCAN gadget - performs "learning" scanning. You supply the file
        you wish to convert and CTED will search for unrecognised characters
        (characters, which are marked "without conversion" - (x -> x) and
        are in range 128..255). File parts containing these characters will
        be displayed with this character in boldface and other non-recognised
        characters in italics. Then a colon will be displayed as a prompt and
        you will have to enter one character. If you won't enter anything,
        this line will be ignored and scanning will be continued. If you enter
        ESCAPE, the scanning process will be aborted. If you enter some other
        character, it will be written to the conversion table as a conversion
        for that unknown character. Question marks ('?') are displayed instead
        of unprintable characters.


5. The Convert utility
----------------------

   Convert  is  a  small  command-line  utility (can be called only from CLI),
which performs a text file conversion.  This utility requires the arp.library.

   Arguments:

      TABLE - specifies the conversion table you wish to use

       FROM - specifies the source file

         TO - specifies the destination file. If you omit this name, the
              output will be written back to the source file.

        BUF - (not needed) - specifies I/O buffer size (default is 32768)
              If you process longer files, larger values of this parameter
              can increase speed of the operation.

   Characters converted to 0x00 will be removed from the output file.


6. The conversion table format
------------------------------

   The conversion table file contains one byte for each possible character
code (its size is 256 bytes). This byte contains the character which the
original character will be converted to.


7. Remarks
----------

   Send your comments, suggestions and bug reports to mjsoft@k332.feld.cvut.cz.