+--------------------------------------------+
| XByter V1.2 (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.


- 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
 too 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 source.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).

 1> XByter Work:Docs/#?.txt

 * Converts  all  files  matching "#?.txt" in the
   directory "Work:Docs".


- BENCHMARK -
-------------
 FILE    : 770.213 bytes (IBM format)
 ibm2iso : 78 seconds
 Asckit! : 31 seconds
 XByter  :  6 seconds
 Convert :  5 seconds (Got to beat this one :-)

 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.

 Version 1.2	// May 28 -93
 * Flags couldn't be written in upper case. Fixed.
 * Improved the wildcard support. Directories/wild
   cards can now be mixed (see examples).
 * Wildcard conversion screwed up sometimes due to
   the ExNext() function. Switched to ExAll().


- 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, Tom De Voeght and Reinhard Geisler
 for their suggestions.