Babelfish (EXE)
---------------
Chris Vavruska
Copyright 2021


Introduction
------------
Babelfish (EXE) is an ORCA shell command line utility to convert files from
one compatible file type to another using BabelFish by Seven Hills.

Installation
------------
Babelfish (EXE) does not really require an installation as you can run it
right from the folder it exists. If you want to install it as a an ORCA Shell
utlitity then copy it to Utilities folder of your ORCA installation. You
also need to add the following line to the syscmnd file in the Shell folder
of your ORCA installation.

babelfish       U

Or, you can simply run the included install script to do it for you. Either
you choose you will need to quit and restart the ORCA environment afterwards.

Usage
-----
babelfish [options] 'source file' [output file]

  Use babelfish to convert files. Input file must be specified. If
  destination file is not specified then 'outfile' will be used.

  -i id             Source Translator Id
  -I name           Source Translator Name
  -o id             Output Translator Id
  -O name           Output Translator Name
  -l type           List input translator IDs for type
  -L type           List output translators IDs for type
  -F                Force delete output file (if exists)
  -t                List Translator Type IDs
  -v                Version Information
  -V                Verbose output
  -?, -h            This message

  Examples

  On my system to translate a teach file to HTML I would use the following
  command. The values of 4 & 20 may be different on you system.

  babelfish -i 4 -o 20 input.teach output.html


  Alternatively you could choose the translators by name (case
  sensitive).

  babelfish -I "Teach" -o "HTML+" input.teach output.html


FAQ
---

Q. Why does the graphic screen flash when running the Babelfish CLI
   application?
A. Babelfish (the tool) requires the desktop and a bunch of other tools
   to be started. One of those is QuickDraw which causes the graphic
   screen to be show. If there is a way to start the graphic environment
   without showing the screen then let me know.