+--------------------------------------------+
| XByter V1.1 (C) 1993 Ultima Thule Software |
+----------+-------------------------+-------+
           | Written By Jorn Halonen |
           +-------------------------+


- SOFTWARE -
------------
 This software  is Public Domain. Meaning  that
 you can freely  copy/spread it as  long as you
 doesn't make any profit  doing it. It is based
 on the  two separate  utilities "iso2ibm"  and
 "ibm2iso" written by Daniel Bloch.

 NB! NB! NB!
 You will  need a written  permission from  the
 author if you  want to  include XByter  in ANY
 software package.


- DISCLAIMER -
--------------
 The Author can't be held  responsible for  any
 damage  this software may cause.  You're using
 it at your own risk.

 It must be said that  XByter is totally system
 compliant and written/compiled with SAS/C 6.2,
 running both Enforcer and  Mungwall. Bugs have
 yet to be found.


- REQUIREMENTS -
----------------
 Any Amiga system equipped with:

 * Kickstart/Workbench 2.04++
 * 512kb RAM (XByter uses two 64kb buffers for
              large textfiles. Smaller buffers
              with text files < 64kb)

 Recommended system :-)

 A5000 with:

 * Kickstart/Workbench 4.0
 * 8Mb Chip / 16Mb Fast
 * 50 Mhz 68060
 * AT&T 3210 DSP


- INSTALLING -
--------------
 Just put  the XByter  file in  the  default C:
 catalog (or any other suitable one).


- PURPOSE -
-----------
 If you have transferred text files from an IBM
 (or  compatible)  machine  to your  Amiga, you
 might have  noticed that the text doesn't look
 to good when you try to display it.

 XByter converts text files between the ISO and
 IBM text formats in the same way as "iso2ibm",
 "ibm2iso" or Asckit.

 XByter adds these features:

 * Speed!!!
 * Because of file recognition, text files are
   converted automatically to the other format
 * Wild card support (multiple files)
 * The converted file replaces source file if
   no destination file is given.
 * Recognizes and skips binary files
 * Intelligent error messages


- USAGE -
---------
 The command line options are:

 XByter [-flag] <infile> [outfile]

 Where:

 <infile>  is the file you want to convert.
 [outfile] is the output file.

 And where [-flag] is ONE of these:

 -ibm      Converts the <infile> to ibm format.
           If the file already is ibm formatted,
           no action is taken.
 -iso      The ISO representation of the '-ibm'
           flag.
 -query    Analyzes the file and displays what
           kind of file this is. (iso, ibm or
           binary)

 You may use  standard AmigaDos  wild  cards in
 the <infile> parameter. But remember that this
 means that all these files will be overwritten,
 when/if converted. (ie no <outfile> when using
 wildcards.)

 NB! [outfile] is  optional. That  means if you
     don't  specify  any, the <infile>  will be
     be overwritten when converted.


- EXAMPLES -
------------

 1> Xbyter sorce.txt dest.txt

 * Converts the file "source.txt" to the opposite
   format  and outputs  the result to "dest.txt".

 1> XByter -iso source.txt dest.txt

 * Converts the file "source.txt" to ISO text. If
   it's already ISO, no action is taken.

 1> XByter -iso #?.txt

 * Converts all files matching the <infile> para-
   meter to ISO text (Skips ISO files).


- BENCHMARK -
-------------
 FILE    : 770.213 bytes (IBM format)
 ibm2iso : 78 seconds
 Asckit! : 31 seconds + some gadget clicking
 XByter  :  6 seconds (Yes, six! :-)

 The benchmark was run from Hard-disk on a stock
 Amiga 4000/040.


- HISTORY -
-----------
 Version 1.0 // May 10 -93
 * First public release

 Version 1.1 // May 20 -93
 * Added '-query' flag
 * Added '-iso' and '-ibm' flags
 * Support for multiple files using wildcards
 * Conversion tables changed! Version 1.0 didn't
   support various national characters at all
 * Removed some potential bugs


- BUGS/THANKS -
---------------
 While XByter is freeware I'd appreciate a post-
 card or  perhaps an email  if you find yourself
 using my software frequently. And  please  send
 me bug-reports/suggestions if you feel like it.

 email: jorngh@dhhalden.no

 smail: Jorn Halonen
        Marcus Thranesgate 17
        1776 Halden
        Norway

 Thanks to : Kjell Irgens  and Tom De Voeght for
 their suggestions.