*******************************************************************************
*                                                                             *
*   A M S   E x t e n d e r                                                   *
*                                                                             *
*   by Stefan Heule                                                           *
*   member of boolsoft (www.boolsoft.org)                                     *
*                                                                             *
*   ReadMe                                                                    *
*                                                                             *
*******************************************************************************


-------------------------------------------------------------------------------
Contents
-------------------------------------------------------------------------------
I.    Installation
II.   Uninstallation
III.  Features
IV.   Usage/Keys
V.    Limitations
VI.   How it works
VII.  License
VIII. Credits


-------------------------------------------------------------------------------
I. Installation
-------------------------------------------------------------------------------
Choose the correct file(s) from the binary directory. You can choose the
language, calculator model and the version, either compressed or uncompressed.
It doesn't matter which version you'll take, with the compressed one you will
have two files (the data and its launcher), but the total size is smaller. Also
note, that the files are on-calc compatible, so you can send the files for the
TI-89 Titanium to a Voyage 200, for example. This becomes handy if you want to
send the program to a friend with a different calculator.
The program installes among other things a TSR event hook. Therefore, it mostly
follows Kevin Kofler's event hook conventions and uses his AMS 2 HW2 TSR support
(h220xtsr) v1.12. As a result, you should install AMS Extender after any
incompatible event hook. For more info 'How it works'.


-------------------------------------------------------------------------------
II. Uninstallation
-------------------------------------------------------------------------------
To uninstall the AMS Extender, simply execute it a second time. Do NOT use
UnInEvHk! It won't crash your calculator, but some parts of AMS Extender will
stay installed (the trap 4 hook, to be precise).


-------------------------------------------------------------------------------
III. Features
-------------------------------------------------------------------------------
Standard features:
- It allows you to set the keydelay and scrolldelay to make scrolling everywhere
  faster.
- You can now run kbdprgm's from everywhere on the calc, not just from within
  the homescreen. For example, if you are in the Y-editor, and you press
  [diamond]+[1], kbdprgm1 will start!
  Now, you can also use kbdprgm7 - kbdprgm9
- This hook will automatically add the brackets after the name of an executable
  program. Example: Type "tiex" into the command line, and press [ENTER]. The
  TiExplorer will be executed :) This even works, if you use a foldername
  together with the filename!
- You can set the cursor blink rate (not very useful, but funny though)
- It is possible to set a autostart application, which will be started every
  startup, even after the APD-feature turned the calc off. You can set the
  program to start in the options dialog. It will be searched in every folder,
  so don't care about this.
- You also can change the APD (auto power down) timer.
- I was too lazy to press [2nd]+[ON] to turn off the calc, so it is now possible
  to do this job just with [ON]. How relaxing :)
- Start the three editors (program, text and data/matrix) with a key combo. There
  are hot key's for nearly all built-in Apps, but not for the (in my opinion) most
  used: the program and text editor. I think this is very stupid by TI...
- Start a user defined program by pressing [2nd]+[MEM]. This is useful in
  combination with my utility CalcInfo to replace the old memory dialog with a
  better one.

Some features are only available on the Voyage 200:
- You can run kbdfuncX with [diamond]+[F1-F8]
- It displays a digital clock in the right corner of the status line, with two
  diffrent formats (12h/24h or off).
- [diamond] + [CLEAR] clears the whole home screen history (like ClrHome)
- Adds a well-known feature (from every computer): "Select all". If you are in
  the home screen command line and press [diamond]+[A], the whole text will be
  selected.
- It shows a small 7 level battery icon (also in the right corner of the status
  line, next to the clock).
- You can choose between two diffrent keyboard layouts, the german and the english
  one (QWERTZ/QWERTY)
- It is possible to change the angle-mode (between RAD/DEG) with a shortcut:
  [diamond]+[*]


-------------------------------------------------------------------------------
IV. Usage/Keys
-------------------------------------------------------------------------------
Voyage 200/TI-92+:
- [diamond]+[MODE] to access the configuration dialog
  IMPORTANT: For this dialog to work, you cannot rename "amsext". Also, if you
  are using the compressed version, "amsext" has to be in the current folder.
- [diamond]+[CLEAR] to clear the whole home screen history (like ClrHome)
- [diamond]+[U] to start the program editor
- [diamond]+[I] to start the text editor
- [diamond]+[M] to start the data/matirx editor
- [diamond]+[A] to select the whole text in the command line
- [diamond]+[*] to change between RAD and DEG
- [diamond]+[1-9] to start kbdprgmX
- [diamond]+[F1-F8] to start kbdfuncX
- [2nd]+[MEM] to start a user defined program
- [ON] to turn off the calc

TI-89/TI-89 Titanium:
- [diamond]+[HOME] to access the options dialog
- [diamond]+[CLEAR] to clear the whole home screen history (like ClrHome)
- [diamond]+[1-9] to start kbdprgmX
- [2nd]+[F4] to start the program editor
- [2nd]+[F5] to start the text editor
- [2nd]+[MEM] to start a user defined program
- [ON] to turn off the calc


-------------------------------------------------------------------------------
V. How it works
-------------------------------------------------------------------------------
It is a TSR (terminate but stay resident) program, which installs itself in the
RAM. This allows the program to stay active after the installation, so it can
capture all events, but without disabling TI's event handling routines.
This program uses Kevin Koflers HW2 AMS 2.0x TSR support v1.12. It is installed
only in the installation routine on HW2 with AMS 2.0x and without HW2/3Patch.


-------------------------------------------------------------------------------
VI. License
-------------------------------------------------------------------------------
Copyright (C) 2006-2010  Stefan Heule

This program 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 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see <http://www.gnu.org/licenses/>.


-------------------------------------------------------------------------------
VII. Credits
-------------------------------------------------------------------------------
> AMS Extender

> released: see history.txt
> written by Stefan Heule

> released under boolsoft

> compiled with GCC4TI

> Thanks to:
  - The TIGCC Team (http://tigcc.ticalc.org/)
  - Zeljko Juric for the great TIGCC documentation.
  - TI-Chess team for the TIGCC Tools Suite, especially ttbin2hex.exe.
  - Kevin Kofler for h220xTSR and UnInEvHk (http://www.tigen.org/kevin.kofler/)
    And I also want to thank him for the Vista-update of TIGCC. Additionally,
	he helped me solving many problems with the hook.
  - Greg Dietsche (gforce@calc.org) and Thomas Naeff (porter) (th.n@gmx.ch) for
    their sample TSR, which was really helpful!
  - Samuel Stearley and Greg Dietsche (porter) for the routine to get the 
    pointer to the command line.
  - Olivier Armand (ExtendeD) for the routine to start programs and the code to
    uninstall a TSR. He used these things in his Integrated Desktop.
  - Again Olivier Armand (ExtendeD) for the documentation "ams_2.08_doc", with
    useful inforamtions about clock-relating routines.
  - Thorsten Kempas for the idea with the clock and the battery state (ISL)
  - Phip for testing the program on the Titanium and helping me to find some
    better shortcuts.
  - The guy who had the idea to shut down the calc by pressing just [ON]. I
    don't remember his name (there was a program at ticalc.org), so if you are
    this person or know him please let me know so I can give appropriate
    credits.
  - Boscop for bug reports and suggestions.
  - TI-Chess team for their tutorials, especially S1P3 for a TSR example.
  - Simon Hutter for bug reports and testing.

> Contact:
  -mail to: calc@stefanheule.com
  -website: http://calc.stefanheule.com
  -msn:     stefanheule@gmx.ch