home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / f / keyfig.hlp < prev    next >
Encoding:
Text File  |  1993-03-27  |  9.0 KB  |  219 lines
  1. Help   is  available  on  the  following 
  2. topics:
  3. --> done help <--
  4. --> General Usage <--
  5. --> Setting up your work file <--
  6. --> What to do with your work file <--
  7. --> Key values <--
  8. --> Selecting a key to edit <--
  9. --> Logical/Physical Colors <--
  10. --> Editing keys <--
  11. --> Assigning/Editing Strings <--
  12. --> Assigning Colors <--
  13. --> Assigning Special Functions <--
  14. --> Assigning HEX values <--
  15. --> Finishing up <--
  16. --> For experts only <--
  17. Use the up and down arrow keys to scroll 
  18. through the menu; type the return key to 
  19. select the topic on which you want help.The purpose of this program is to  allow 
  20. you  to  alter the definition of  almost 
  21. ANY key on the keyboard.   The only keys 
  22. you  CANNOT modify are:  the SHIFT keys, 
  23. the SHIFT LOCK key, the CONTROL key, the 
  24. 40/80 DISPLAY key and the COMMODORE key.  
  25.  
  26. At  each step,  options are presented in 
  27. menu form.   You can scroll through  the 
  28. options  in  the menus by using  the  up 
  29. and  down arrow keys at the top  of  the 
  30. keyboard;   pressing   the  return   key 
  31. selects  the choice that is highlighted.  
  32. At  almost any point,  you can exit  the 
  33. program by typing 'CTRL c' (the  CONTROL 
  34. key and C simultaneously.)The first thing you will be asked to  do 
  35. is  set up your work file.   You will be 
  36. given  a choice of 3 sources from which 
  37. you can do this: 
  38.  
  39. DEFAULT  DEFINITIONS  -  which  basically 
  40. represent   a   standard  set   of   key 
  41. definitions.
  42. CURRENT  DEFINITIONS  - which  represent 
  43. the   most   recently  loaded   set   of 
  44. definitions.  
  45. DEFINITIONS  ON  CP/M BOOT DISK  - which 
  46. represent the set of definitions  stored 
  47. on  your  boot disk,   normally  default  
  48. definitons,  unless you replace them via 
  49. this program.Once your work file is set up,  you will 
  50. be  given  a choice of 3 things  to  do: 
  51. EDIT  KEYS-  which allows you to  modify 
  52.      key definitions. 
  53. ASSIGN  LOGICAL/PHYSICAL COLORS  - which 
  54.      allows you to redefine the  meaning 
  55.      associated with a particular color.  
  56. EXIT  AND SAVE YOUR WORK FILE - This  is 
  57.      provided  here as a quick means  of 
  58.      copying  one set of definitions  to 
  59.      another.   For example, loading the 
  60.      default  definitions into your work 
  61.      file and saving them as the current 
  62.      definitions,  provides  a means  of 
  63.      restoring your current  definitions 
  64.      after  running an application which 
  65.      may  have used a now undesired  set 
  66.      of key definitions.Each key has 4 values associated with it:
  67. normal   value  - which  represents  the 
  68.      unshifted  value  of  the  key   as 
  69.      labelled.
  70. SHIFTED value  - which  represents   the 
  71.      value  of  the  key,  as  labelled, 
  72.      obtained by typing the desired  key 
  73.      and  the  shift key simultaneously. 
  74. CONTROL  value  -  which  represents the 
  75.      value of the key obtained by typing 
  76.      the desired key and the CONTROL key 
  77.      simultaneously.
  78. CAPS LOCK value -  which represents  the 
  79.      value  obtained while in  COMMODORE 
  80.      mode.   This  mode is  obtained  by 
  81.      typing the COMMODORE  key and stays 
  82.      in effect until you type it again.To select  a  key  for editing,  you must
  83. actually  select  the specific (1 of  4) 
  84. value  of  the  key  that  you  want  to 
  85. modify.   To  do this,  type the key  so 
  86. that the four values associated with  it 
  87. are  displayed.   Use  the up  and  down 
  88. arrow  keys  to scroll through the  four 
  89. values;  type  the return key to  select 
  90. the value that is highlighted.   This is 
  91. the  specific  key value  that  will  be 
  92. modified.   The next time you view  this 
  93. key  the new value you assigned will  be 
  94. displayed.   You can modify as many keys 
  95. as you want.  When you are done,  select 
  96. the  fifth  choice - exit and save  work 
  97. file.  (NOTE: To view the up arrow, down 
  98. arrow  or return key,  type the  desired 
  99. key and the control key simultaneously).  Once  you have chosen to assign logical/ 
  100. physical  colors,  you will be  given  a 
  101. choice  of doing this for either a 40 or 
  102. an 80 column screen.   Then,  two  color 
  103. maps  will be displayed.  The top one is 
  104. the  current  logical  color  map;   the 
  105. bottom  one is the physical  color  map. 
  106. You  will be asked to select the logical 
  107. color  you  want  to  assign  (type  the 
  108. letter  in  the box with the  color  you 
  109. want from the top map).   Then you  will 
  110. be asked for the physical color you want 
  111. assigned  to it (type the letter in  the 
  112. box  with the color you want,  from  the 
  113. bottom  map.)   You can assign  as  many 
  114. colors as you want;  type the RETURN key 
  115. when  you  are  finished. Once  you  have selected a specific  key 
  116. value  to  edit,  you  will be  given  a 
  117. choice of 5 ways of modifying the key:
  118. ASSIGN  a  new character - which  allows 
  119.      you    to   do   a    'one-for-one' 
  120.      replacement of the key.
  121. ASSIGN  a  STRING - which allows you  to 
  122.      assign/edit  a string (more than  1 
  123.      character) to the key
  124. ASSIGN  a  COLOR - which allows  you  to 
  125.      assign an 80 or a 40 column color
  126. ASSIGN a special function - which allows 
  127.      you  to  assign a function  from  a 
  128.      list of currently available special 
  129.      functions.
  130. ASSIGN a HEX value - which allows you to 
  131.      replace the key value with a single 
  132.      hex value.Once you have chosen to assign a string, 
  133. you will be given a list of 32 available 
  134. strings  (some  of which may already  be 
  135. defined.)  Scroll through and select the 
  136. one you want to assign to this key.   At 
  137. this point,  the one you choose will  be 
  138. displayed near the top of the screen for 
  139. editing.   You  can edit by typing  keys 
  140. and/or  by  choosing  one  of  the  menu 
  141. options presented -insert a color, a hex 
  142. value, special function or second string 
  143. (warning  - the remainder of the  string 
  144. will  be deleted if you insert a  second 
  145. string.)  You can also use the left  and 
  146. right  arrow  keys  and the  insert  and 
  147. delete keys.   When you are done, select 
  148. the  menu choice  'exit string edit  and 
  149. save assigned string.'Once you have chosen to assign a  color, 
  150. you  will  be given a choice of 5  color 
  151. types to assign: an 80 column foreground 
  152. color,  an 80 column background color, a 
  153. 40 column foreground color,  a 40 column 
  154. background  color or a 40 column  border 
  155. color.   Scroll  through and select  the 
  156. one you want to assign.   At this point, 
  157. a  color  map  consisting  of  16  boxes 
  158. labelled a through p will be  displayed. 
  159. Type    the   letter   from   the    box 
  160. representing  the color that you want to 
  161. assign.  (NOTE that one letter  (usually 
  162. 'a') will appear to be missing,  because 
  163. it  blends with the background  color  - 
  164. assume    ALL    boxes   are    lettered 
  165. sequentially!)Once you have chosen to assign a special 
  166. function you will be given a list of  16 
  167. currently  available special  functions.  
  168. Scroll  through the list and assign  the 
  169. function you want this key to perform.Once  you  have chosen to assign  a  hex
  170. value to a key, you will be prompted for
  171. the  value to assign.   Only  characters
  172. from  0-9 and a-f (upper or lower  case)
  173. will   be   accepted.    As   you   type
  174. characters, the current value is shifted
  175. left  one  nibble and the new  value  is
  176. ORed into the lst nibble.   You can type
  177. as many characters as you want,  but the
  178. last  2  you  type  will  be  the  value
  179. assigned  to the key.   Type return when
  180. you are finished.  Note:   The value you
  181. type  when  the  four  key  values   are
  182. displayed  will not be displayed as hex,
  183. but  as what the hex  value  represents.
  184. WARNING:  This  mode should only be used
  185. by those familiar with hexadecimal data.Once  you have loaded your workfile  and 
  186. completed  any editing you wanted to do, 
  187. you  will be given three choices  as  to 
  188. what  to do with your work file:   
  189.  
  190. SAVE AS   CURRENT   - which  makes   the 
  191.      definitions   in  your  work   file 
  192.      effective immediately upon  exiting 
  193.      this program
  194. SAVE ON CP/M DISK - which will cause the 
  195.      definitions in your work file to be 
  196.      loaded  the next time you boot from 
  197.      the disk to which it was saved
  198. DON'T   SAVE- a means of exiting if you 
  199.      made a mistake or changed your mind
  200.  
  201. Scroll through and select what you  want 
  202. to doTo  edit  key definitions without  using
  203. the  KEYFIG program,  type  the  CONTROL
  204. key,  RIGHT SHIFT key and  RIGHT or LEFT
  205. arrow   keys  simultaneously  (RT  arrow
  206. selects string edit,  LFT arrow  selects
  207. hex  edit);   then type the key you want
  208. to edit.  If assigning a string, the key
  209. must  already have a string assigned  to
  210. it.  A   window  will  pop  up   at  the
  211. bottom of the screen,  in which you will
  212. edit. Either enter the hex value or type
  213. the string.  If editing hex, any illegal
  214. key will abort the edit without changing
  215. the value.  Commands for string edit are
  216. all entered  by typing CTRL,RT SHFT with
  217. the command key.  RT&LFT arrow keys move
  218. within the string,  RET exits the  edit,
  219. '+' or '-' inserts/deletes a character.