===================================================
        titanium-info & Titarom - 22 July 2004
- Olivier Armand - ola dot e-ml at wanadoo dot fr -
===================================================

patchanic.c / patchanic.exe:
 An automated patching program for PC for AMS 3.00 OS Update (.89u) to
 make it work with Virtual TI. Run it from a command line prompt.
 Usage: patchanic original_os_update.89u patched_update.89u
 patched_update.89u will be created, and you will be able to use it
 Virtual TI. Caution, the patching can take quite a long time (~20
 seconds).

 It perhaps misses some patches, or patches data it shouldn't, so the
 patched AMS sometimes crashes or behaves weirdly (see BUGS at the end
 of titanium-info.txt), but is enough to test or debug most assembly
 programs (I haven't enough time to allow a perfect emulation).
 A patched update can be emulated with any version of Virtual TI
 (including JM's special versions) as a TI-89.

 The RAM ghost space still exists when emulating, so you won't see
 buggy programs using it if you don't add a data breakpoint on the
 ghost space (0x40000-0x7FFFF).
 ($C8).l points to $2XXXXX, so calculator detections allowing only the
 Titanium to execute the program will fail. Either remove the
 detection when debugging, or step to the detection and 'set PC' after
 it (trap #11 must be breakpointed to reach the first instruction of
 the program: step over it and step into the next jmp (a1)).
 Patchanic does not apply HW3Patch, so you must manually  modify the
 update and apply it by hand to debug programs that need it.

 Patchanic is free software; you can redistribute it and/or modify it
 under the terms of the GNU General Public License as published by the
 Free Software Foundation; either version 2 of the License, or (at
 your option) any later version.
 
 I will not reply to any e-mail asking me an original OS Update to
 patch it with Patchanic. An update can be found on the CD shipped
 with the TI-89 Titanium.
 Do not try to send a patched update to a standard TI-89: it is *NOT*
 meant to work on a real calculator. This may render the calculator
 unbootable.

titanium-info.txt (French):
 Which hardcoded patches Patchanic applies, and various notes on new
 AMS and hardware features mainly based on simple debugging with
 Virtual TI (a not very comprehensive, perhaps sometimes wrong, and
 not well organized document, I have to admit).


Thanks to
=========

* Rusty Wagner for the wonderful tool Virtual TI is, and JM for his
  improvements in it.
* Samuel Stearley for providing me what was needed to create this
  package.
* Lionel Debroux and Kevin Kofler for their comments on titanium-info
  and additionnal information.
