2000
Help   is  available  on  the  following 
topics:
--> done help <--
--> General Usage <--
--> Setting up your work file <--
--> What to do with your work file <--
--> Key values <--
--> Selecting a key to edit <--
--> Logical/Physical Colors <--
--> Editing keys <--
--> Assigning/Editing Strings <--
--> Assigning Colors <--
--> Assigning Special Functions <--
--> Assigning HEX values <--
--> Finishing up <--
--> For experts only <--
Use the up and down arrow keys to scroll 
through the menu; type the return key to 
select the topic on which you want help.The purpose of this program is to  allow 
you  to  alter the definition of  almost 
ANY key on the keyboard.   The only keys 
you  CANNOT modify are:  the SHIFT keys, 
the SHIFT LOCK key, the CONTROL key, the 
40/80 DISPLAY key and the COMMODORE key.  

At  each step,  options are presented in 
menu form.   You can scroll through  the 
options  in  the menus by using  the  up 
and  down arrow keys at the top  of  the 
keyboard;   pressing   the  return   key 
selects  the choice that is highlighted.  
At  almost any point,  you can exit  the 
program by typing 'CTRL c' (the  CONTROL 
key and C simultaneously.)The first thing you will be asked to  do 
is  set up your work file.   You will be 
given  a choice of 3 sources from which 
you can do this: 

DEFAULT  DEFINITIONS  -  which  basically 
represent   a   standard  set   of   key 
definitions.
CURRENT  DEFINITIONS  - which  represent 
the   most   recently  loaded   set   of 
definitions.  
DEFINITIONS  ON  CP/M BOOT DISK  - which 
represent the set of definitions  stored 
on  your  boot disk,   normally  default  
definitons,  unless you replace them via 
this program.Once your work file is set up,  you will 
be  given  a choice of 3 things  to  do: 
EDIT  KEYS-  which allows you to  modify 
     key definitions. 
ASSIGN  LOGICAL/PHYSICAL COLORS  - which 
     allows you to redefine the  meaning 
     associated with a particular color.  
EXIT  AND SAVE YOUR WORK FILE - This  is 
     provided  here as a quick means  of 
     copying  one set of definitions  to 
     another.   For example, loading the 
     default  definitions into your work 
     file and saving them as the current 
     definitions,  provides  a means  of 
     restoring your current  definitions 
     after  running an application which 
     may  have used a now undesired  set 
     of key definitions.Each key has 4 values associated with it:
normal   value  - which  represents  the 
     unshifted  value  of  the  key   as 
     labelled.
SHIFTED value  - which  represents   the 
     value  of  the  key,  as  labelled, 
     obtained by typing the desired  key 
     and  the  shift key simultaneously. 
CONTROL  value  -  which  represents the 
     value of the key obtained by typing 
     the desired key and the CONTROL key 
     simultaneously.
CAPS LOCK value -  which represents  the 
     value  obtained while in  COMMODORE 
     mode.   This  mode is  obtained  by 
     typing the COMMODORE  key and stays 
     in effect until you type it again.To select  a  key  for editing,  you must
actually  select  the specific (1 of  4) 
value  of  the  key  that  you  want  to 
modify.   To  do this,  type the key  so 
that the four values associated with  it 
are  displayed.   Use  the up  and  down 
arrow  keys  to scroll through the  four 
values;  type  the return key to  select 
the value that is highlighted.   This is 
the  specific  key value  that  will  be 
modified.   The next time you view  this 
key  the new value you assigned will  be 
displayed.   You can modify as many keys 
as you want.  When you are done,  select 
the  fifth  choice - exit and save  work 
file.  (NOTE: To view the up arrow, down 
arrow  or return key,  type the  desired 
key and the control key simultaneously).  Once  you have chosen to assign logical/ 
physical  colors,  you will be  given  a 
choice  of doing this for either a 40 or 
an 80 column screen.   Then,  two  color 
maps  will be displayed.  The top one is 
the  current  logical  color  map;   the 
bottom  one is the physical  color  map. 
You  will be asked to select the logical 
color  you  want  to  assign  (type  the 
letter  in  the box with the  color  you 
want from the top map).   Then you  will 
be asked for the physical color you want 
assigned  to it (type the letter in  the 
box  with the color you want,  from  the 
bottom  map.)   You can assign  as  many 
colors as you want;  type the RETURN key 
when  you  are  finished. Once  you  have selected a specific  key 
value  to  edit,  you  will be  given  a 
choice of 5 ways of modifying the key:
ASSIGN  a  new character - which  allows 
     you    to   do   a    'one-for-one' 
     replacement of the key.
ASSIGN  a  STRING - which allows you  to 
     assign/edit  a string (more than  1 
     character) to the key
ASSIGN  a  COLOR - which allows  you  to 
     assign an 80 or a 40 column color
ASSIGN a special function - which allows 
     you  to  assign a function  from  a 
     list of currently available special 
     functions.
ASSIGN a HEX value - which allows you to 
     replace the key value with a single 
     hex value.Once you have chosen to assign a string, 
you will be given a list of 32 available 
strings  (some  of which may already  be 
defined.)  Scroll through and select the 
one you want to assign to this key.   At 
this point,  the one you choose will  be 
displayed near the top of the screen for 
editing.   You  can edit by typing  keys 
and/or  by  choosing  one  of  the  menu 
options presented -insert a color, a hex 
value, special function or second string 
(warning  - the remainder of the  string 
will  be deleted if you insert a  second 
string.)  You can also use the left  and 
right  arrow  keys  and the  insert  and 
delete keys.   When you are done, select 
the  menu choice  'exit string edit  and 
save assigned string.'Once you have chosen to assign a  color, 
you  will  be given a choice of 5  color 
types to assign: an 80 column foreground 
color,  an 80 column background color, a 
40 column foreground color,  a 40 column 
background  color or a 40 column  border 
color.   Scroll  through and select  the 
one you want to assign.   At this point, 
a  color  map  consisting  of  16  boxes 
labelled a through p will be  displayed. 
Type    the   letter   from   the    box 
representing  the color that you want to 
assign.  (NOTE that one letter  (usually 
'a') will appear to be missing,  because 
it  blends with the background  color  - 
assume    ALL    boxes   are    lettered 
sequentially!)Once you have chosen to assign a special 
function you will be given a list of  16 
currently  available special  functions.  
Scroll  through the list and assign  the 
function you want this key to perform.Once  you  have chosen to assign  a  hex
value to a key, you will be prompted for
the  value to assign.   Only  characters
from  0-9 and a-f (upper or lower  case)
will   be   accepted.    As   you   type
characters, the current value is shifted
left  one  nibble and the new  value  is
ORed into the lst nibble.   You can type
as many characters as you want,  but the
last  2  you  type  will  be  the  value
assigned  to the key.   Type return when
you are finished.  Note:   The value you
type  when  the  four  key  values   are
displayed  will not be displayed as hex,
but  as what the hex  value  represents.
WARNING:  This  mode should only be used
by those familiar with hexadecimal data.Once  you have loaded your workfile  and 
completed  any editing you wanted to do, 
you  will be given three choices  as  to 
what  to do with your work file:   

SAVE AS   CURRENT   - which  makes   the 
     definitions   in  your  work   file 
     effective immediately upon  exiting 
     this program
SAVE ON CP/M DISK - which will cause the 
     definitions in your work file to be 
     loaded  the next time you boot from 
     the disk to wh
400
ich it was saved
DON'T   SAVE- a means of exiting if you 
     made a mistake or changed your mind

Scroll through and select what you  want 
to doTo  edit  key definitions without  using
the  KEYFIG program,  type  the  CONTROL
key,  RIGHT SHIFT key and  RIGHT or LEFT
arrow   keys  simultaneously  (RT  arrow
selects string edit,  LFT arrow  selects
hex  edit);   then type the key you want
to edit.  If assigning a string, the key
must  already have a string assigned  to
it.  A   window  will  pop  up   at  the
bottom of the screen,  in which you will
edit. Either enter the hex value or type
the string.  If editing hex, any illegal
key will abort the edit without changing
the value.  Commands for string edit are
all entered  by typing CTRL,RT SHFT with
the command key.  RT&LFT arrow keys move
within the string,  RET exits the  edit,
'+' or '-' inserts/deletes a character.
0

