home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD2.img / d9xx / d900 / columns / cted.doc < prev    next >
Text File  |  1993-07-24  |  6KB  |  166 lines
  1.  
  2.  **************************************************************************** 
  3. ******************************************************************************
  4. **                                                                          **
  5. **                       Conversion Table EDitor 1.2                        **
  6. **                                                                          **
  7. **                                                                          **
  8. **                     (c) 1993 MJSoft System Software                      **
  9. **                                                                          **
  10. **                                    -                                     **
  11. **                                                                          **
  12. **                              Martin  Mares                               **
  13. **                                                                          **
  14. **                                   and                                    **
  15. **                                                                          **
  16. **                              Tomas Zikmund                               **
  17. **                                                                          **
  18. ******************************************************************************
  19.  **************************************************************************** 
  20.  
  21.  
  22.    CONTENTS:
  23.    ---------
  24.  
  25.   1. Preview
  26.   2. System requirements
  27.   3. How to start CTED
  28.   4. The main window
  29.   5. The Convert utility
  30.   6. The conversion table format
  31.   7. Remarks
  32.  
  33.  
  34. 1. Preview
  35. ----------
  36.  
  37.    This utility allows you to define your own conversion tables for Columns
  38. and Convert (a small text conversion utility, which will be described later).
  39.  
  40.    Main features:
  41.  
  42.      - Written completely in assembly
  43.  
  44.      - Kickstart 2.0 and 3.0 compatible
  45.  
  46.      - Kickstart 2.0 look
  47.  
  48.  
  49.    CTED  and  its documentation is Copyright (c) Martin Mares & Tomas Zikmund,
  50. MJSoft System Software, Prague, Czech Republic.
  51.  
  52.    This  archive  can be freely redistributed, as long as all of its files are
  53. included   in   their  original  form  without  any  additions,  deletions  or
  54. modifications, and no more than a nominal fee is charged for its distribution.
  55. All  copyright  notices  in  the programs and accompanying documentation files
  56. must  remain  on  their places.  Also '.displayme' and other similar files may
  57. not be added.  This is generally known as FREEWARE.
  58.  
  59.    Special  permission is given to Fred Fish to distribute this program on his
  60. "Fish Disks".
  61.  
  62.    This  software  is  provided  "AS  IS" without warranty of any kind, either
  63. expressed  or implied.  The author is not responsible for any damage caused by
  64. it.
  65.  
  66.  
  67. 2. System requirements
  68. ----------------------
  69.  
  70.    This program requires:
  71.  
  72.       - Kickstart 1.2 or higher
  73.  
  74.       - Arp.library
  75.  
  76.       - Req.library
  77.  
  78.       - Some free memory
  79.  
  80.  
  81. 3. How to start CTED
  82. --------------------
  83.  
  84.    There are two ways to start Columns and pass it the parameters:
  85.  
  86.       - Start it from CLI
  87.  
  88.       - Start it from Workbench by doubleclicking its icon.
  89.  
  90.  
  91. 4. The main window
  92. ------------------
  93.  
  94.    If you start CTED, the main window will appear.
  95.  
  96.    This window contains:
  97.  
  98.       - A part of the conversion table with proportional gadget used for
  99.         scrolling.  This table has format "x (X) -> y (Y)", where X is the
  100.         character to be converted (x is its code) and Y is the character,
  101.         which will X be converted to (y is its code). One line of the table is
  102.         highlighted (displayed in inverse video). This is the active line,
  103.         which is being edited.
  104.  
  105.       - Two string gadgets named "Code" and "ASCII" used for editing the table
  106.         manually.
  107.  
  108.       - The LOAD gadget - loads a conversion table from specified file
  109.  
  110.       - The SAVE gadget - saves the conversion table to specified file
  111.  
  112.       - The INIT gadget - performs conversion table initialization
  113.  
  114.       - The DIFF gadget - performs differential scanning. You supply two files
  115.         (each maximally 256 bytes long). CTED will create a conversion table
  116.         saying each character in the first file will be converted to the
  117.         character found in the second file on the same position.
  118.  
  119.       - The SCAN gadget - performs "learning" scanning. You supply the file
  120.         you wish to convert and CTED will search for non-recognised characters
  121.         (characters, which are marked "without conversion" - (x -> x) and
  122.         aren't in range 32..126). File parts containing this characters will
  123.         be displayed with this character in boldface and other non-recognised
  124.         characters in italics. Then a colon will be displayed as a prompt and
  125.         you will have to enter one character. If you won't enter anything,
  126.         this line will be ignored and scanning will be continued. If you enter
  127.         ESCAPE, the scanning process will be aborted. If you enter a
  128.         character, this character will be written into the conversion table as
  129.         a conversion for that unknown character.
  130.  
  131.  
  132. 5. The Convert utility
  133. ----------------------
  134.  
  135.    Convert  is  a  small  command-line  utility (can be called only from CLI),
  136. which performs a text file conversion.  This utility requires the arp.library.
  137.  
  138.    Arguments:
  139.  
  140.       TABLE - specifies the conversion table you wish to use
  141.  
  142.        FROM - specifies the source file
  143.  
  144.          TO - specifies the destination file. If you omit this name, the
  145.               output will be written back to the source file.
  146.  
  147.         BUF - (not needed) - specifies I/O buffer size (default is 32768)
  148.               If you process longer files, larger values of this parameter
  149.               can increase speed of the operation.
  150.  
  151.    Characters converted to 0x00 will be removed from the output file.
  152.  
  153.  
  154. 6. The conversion table format
  155. ------------------------------
  156.  
  157.    The conversion table file contains one byte for each possible character
  158. code (its size is 256 bytes). This byte contains the character which the
  159. original character will be converted to.
  160.  
  161.  
  162. 7. Remarks
  163. ----------
  164.  
  165.    Send your comments, suggestions and bug reports to mjsoft@k332.feld.cvut.cz.
  166.