                      S O U R C E      G U R U

          Z80 (TI-85) to 68000 Assembly Source Code Translator

                Copyright 1999-2000 by Patrick Davidson

                          E-Mail : pad@calc.org
                     Web Page : http://pad.calc.org/

                Version 0.6  -  Released March 31, 2000

  ================ USER'S GUIDE FOR CONVERTED PROGRAMS ===================

    Source Guru is a computer program which is used to automatically convert
TI-85 games to run on the TI-89, TI-92, and TI-92 Plus calculators.  This
document describes use of the converted programs,

1---) Read This First

    For a variety of reasons, Source Guru is not a 100% perfect converter.
Therefore, it is possible for a completely bug-free TI-85 program to fail
after conversion.  Additionally, bugs which by chance don't cause trouble
on the TI-85 may lead to more serious problems after conversion.  Until the
converted program has been thoroughly tested, you should not trust it not to
crash the calculator.

    Any program which I have released in converte version will have been
tested by me.  However, it's still a good idea for you to be cautious with
them.  I have explicit permission to release the converted version from the
authors of all programs I have released in converted form.

2---) How to run

For the TI-92, you should have Fargo II installed to run converted programs.
For a TI-89 or TI-92 Plus, use DoorsOS II or a compatible kernel.

    The converted programs are run the same way as any other program.  For
converted programs released by me, there are both "normal" and "turbo"
versions distributed.  The "turbo" one has a filename ending in "T".  The
"turbo" version will run faster than the "normal" program, but requires 32K
of free memory.  The "normal" verions require the "TI85LIB2" library will
the "turbo" versions require the "TI85LIB3" library.  The exact speeds of
the converted programs will vary from program to program.  Usually, the
"turbo" mode program should be as fast as or slightly faster than the
original on a TI-89, but is slower on the TI-92 (I currently don't know why
this is).

    Since converted programs may be unreliable, it is recommended that TI-92
start them from DB92 or FPL to escape from crashes.  For the TI-82 and TI-92
Plus, use a kernel with crash protection (I think they all have it).  Of
course, this crash protection is not 100% guaranteed.

3---) Keyboard mapping for the TI-92 and TI-92 Plus

ENTER   All enters except the one under the cursor pad work
Arrows  These are entered with the cursor pad.  Since it's an 8-way pad,
        if you don't press exactly right, you may move diagonally when you
        meant to move horizontally or vertically.  Also, programs that read
        with GET_KEY will not show this key as repeating as they would on
        the actual TI-85.
LOG     L
X^2     X
ON      O
EE      E
x-VAR   V
STAT    S
PRGM    LOCK (hand)
MORE    MODE
CUSTOM  APPS         

4---) Keyboard mapping for the TI-89

Arrows  These are entered with the arrow keys as expected, but tnoe that
        programs which read with GET_KEY will not show this key as repeating
        as they would on the actual TI-85.
CUSTOM  APPS
PRGM    HOME
MORE    MODE
TAN     T
COS     Z
SIN     Y
STAT    | (the vertical pipe)
x^2     SHIFT
GRAPH   diamond
LN      CATALOG
LOG     =
