======================================================================

- Syntax to create the script 'simkscpt' for the key configurations -
  for Sim by Olivier Armand <ola.e-ml@wanadoo.fr>
  Last Update : 02/23/2003

======================================================================

You should read the ReadMe.txt file before reading this one.


General Syntax
===============

config_name1 : original_key1 -> new_key1, orignal_key2 -> new_key2,
  etc.
config_name2 : original_key1 -> new_key1, etc.
config_name3 : etc.

config_nameXs are the name of different configurations you have
created. They are case sensitive. They get have up to 20 characters.
A colon must follow them.

Then there is the definition of the remapping. original_keyXs are the
keys that the program is waiting for. new_keyXs are the keys you want
to press to activate the original_keyXs (the program will believe that
you are pressing the original key).

For example if the key '2nd' is FIRE on a program for TI89, and you
want to make it become F1 on TI92+, write :
	2nd -> F1
(the list of the keys names is at the end of this file).
The keys are case insensitive (you could write 'f1'). The character
between the two keys is the STO character.

A comma must separate the different keys. There must NOT be
any comma at the end of a configuration (when it is the last key to
remap).

You MUST remap all the keys you want to use, even if its name does
not change (you *must* write 'up->up' for example). Only the keys
you have written in the configuration will be active during the
execution of the program.

If the same key is remapped twice or more (for example if enter->enter
is followed by enter->enter_cpad), only the last remapping will have
an effect (here enter->enter_cpad).

If two configurations have the same name, the first one (in
alphabetical order) will be used.


The spacing characters
=======================

You can put between any token spacing characters or sequences :
new lines, spaces and comments.
For example this syntax will be correct :

Caesar      :
  left->left, up     -> up,
  right
  ->

  right,
  alpha->F1

(of course this is just an example, it is illegible).
Do not forget the commas at the end of the lines when writing new
lines.

Comments can be written after a semicolon, wherever a spacing
character can be written. The comment will stop at the end of the
line. For example :

Caesar :  ; Configuration for Caesar III
 left->left, up->up, right->right, down->down,  ; the pad
 alpha->F1  ; click



The parsing of the script
==========================

Sim checks the syntax of the script before using a configuration. Note
that only the syntax of the configuration you are using will be
checked, so there may be syntax errors elsewhere in the script, even
if Sim has managed to use a configuration.

If there is a syntax error, a message is displayed in the status bar.
The number in brackets is the number of the line where the first syntax
error has been found. You should use a text editor showing the line
numbers to locate easily the errors (you can use Clment Vasseur's
SIDE : http://darkclem.free.fr)

The message displayed should be self-explanatory.
Note that 'EOF' means End Of File.

Sometimes it is difficult to find what is wrong in a configuration
because you have written it on a single line. You should split the
configuration in multiple lines to find the syntax error.
Put for example a key on each line :
left->left,
right->right,
etc.


The keys
=========

Here is the list of the name you must use for original_keys and
new_keys. They are case insensitive.
The ON key does not need to be remapped.
The keys are listed here from the left part to the right part of the
keyboard of the TI92+.

The keys for TI89 and TI92+/V200 are listed (the keys specific to
the TI89 are at the end of the list). But you must use keys that
exist on the calculator you are emulating.
For example if you are emulating a TI89 on a TI92+, the keys at the
left of the '->' must be keys that exists on the keyboard of the TI89,
and the keys at the right of the '->' must be keys of the TI92+.

If you are not emulating a program (you are just remapping the
keys of a program that works on your calculator, with the option
'thiscalc'), the keys at the left and at the right of the '->' must be
keys that exists on the calculator Sim is running onto.

If you try to use a key of a wrong calculator model, Sim will tell
you that the key does not exist.


Identifier  -	Comment
-----------------------

HAND		
F1	
F2		
F3		
F4		
F5		
F6		
F7		
F8		
A-Z		The letters and the numbers do not change
0-9		(for example F1->A, Z->hand, etc.)
SHIFT			
THETA		
DIAMOND		
2ND		
STO		Because the character '->' cannot be used...
SPACE		Because the character ' ' cannot be used...
=		
BACKSPACE	
ENTER		On TI92+/V200 : the key on the alphabetic and
		numeric keypads.
MODE		
CLEAR		
LN		
ESC		Escape
APPS		
ENTER_CPAD	On TI92+/V200 : the key next to the cursor pad.
LEFT		
UP		
RIGHT		
DOWN		
SIN		
COS		
TAN		
^		
(		
)		
COMMA		Because the character ',' cannot be used...
/		
*		
-		
+		
(-)		'Negate' : just press the key to get the character
.		
CATALOG		
ALPHA		
|		'With'
EE
HOME

