home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / z.lbr / Z3KEY.HZP / Z3KEY.HLP
Encoding:
Text File  |  1991-11-18  |  5.9 KB  |  131 lines
  1. ;
  2.                                   Z3KEY.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.               14k        A490  1.4        Arnold Bailey 5/86       Z3RCP1 
  6.  
  7.   1- Z3KEY.RCP  2- Z3KEY.COM  3- Super-Shift Mode  4- Source Files            
  8.  
  9.  
  10.    Z3KEY is  a keyboard redefinition program designed for ZCPR3.  Z3KEY.RCP is 
  11. a resident  command processor that  allows you  to assign character strings to 
  12. keys.  Z3KEY.COM allows you  to save  definitions, re-define the attention and
  13. lead-in characters, set/reset the case flag, and set the delay time.
  14.  
  15.    Key definitions may  be  loaded  from  files  containing  previously  saved
  16. definitions, or they  may  be  defined  on-the-fly,  even  while  a program is 
  17. running.  Both normal  keys (i.e., keys  generating  a single  character)  and
  18. keys  generating escape  sequences  are supported.  Also  supported are Super-
  19. Shift sequences for keyboards without function keys.   
  20. :1
  21.  
  22.  
  23. Z3KEY.RCP Commands:
  24.  
  25.    KEY+    - turns on the key redefinition program.  The user may then 
  26.              redefine keys as necessary.
  27.  
  28.    KEY-    - turns off the key redefinition program.  This must be done
  29.              before replacing Z3KEY.RCP with another RCP to avoid trashing 
  30.              the BIOS conin and const pointers.
  31.  
  32.    CASE+   - turns on the case translation flag.  Any char sent as part of a
  33.              lead-in char sequence will be automatically upcased.  For 
  34.              example, if '\' was used as the lead-in char, the sequence '\a'
  35.              and '\A' would be equivalent.
  36.  
  37.    CASE-   - turns off the case translation flag.
  38.  
  39.    KSTAT   - displays whether Z3KEY is active and the status of the case flag.
  40.  
  41.    KEYS    - displays the present key definitions a page at a time.
  42. :2
  43.  
  44.  
  45.                               Z3KEY.COM Utility
  46.  
  47. Installation
  48.  
  49.    Z3KEY.COM  is  installed  for  the first time by typing 'Z3KEY HHHH', where 
  50. 'HHHH' is the address  of  the Environment Descriptor  in hexadecimal.  It can
  51. also be installed with Z3INS.COM in the usual manner.
  52.  
  53.  
  54. Options
  55.  
  56. S  -  save  key definition.  User  will  be  prompted for the name to save the 
  57.       definition to.  The name will always have the extension .RCP appended to
  58.       it.  This name will  be inserted  in the file and displayed when KEY+ is 
  59.       run to activate it at a later time.
  60.  
  61. A  -  change the  attention character.   Use a very unlikely character such as 
  62.       ^] or ^_.
  63.  
  64. L  -  change the  lead-in  character.  Use the first character of the function 
  65.       key sequences  your terminal produces.  For  example, the  Wyse terminal 
  66.       uses ^A as the first character of its F1 through F16 characters.  If you
  67.       want to use the Super-Shift mode, use  any key you like.  The '\'  is  a 
  68.       good choice on most machines.
  69.  
  70. D  -  change delay times.  User will be prompted for a new delay loop number
  71.       and any number from 0 to 32,000 may be entered.  For normal function key
  72.       use, a delay of 200 is good for most machines.  For Super-Shift mode, a
  73.       number of 1000 is usually good.  
  74.  
  75.  
  76. Options (continued):
  77.  
  78. R  -  change  expansion  rate  count.  Any  number  between  0  and 255 may be
  79.       entered.  The expansion rate count  is the number  of times that the new
  80.       Console Status routine will be called before a macro expansion character
  81.       will be flagged as available.  This prevents programs  that try to flush
  82.       the incoming  characters  on  startup  from  throwing  away  part of the
  83.       definition.  Turbo Pascal is  an example of such a program.  If a key is
  84.       defined to start up Turbo Pascal  as 'TURBO^MYE' and the expansion count
  85.       is set to 0,  the 'Y' and 'E' will be discarded by the program.  Setting
  86.       the expansion count to 2 will result in proper operation.
  87.  
  88. F  -  compile definitions from a text file.  The user will be prompted for the
  89.       name of a text file containing key definitions.  
  90.  
  91. K  -  display key definitions.  
  92.  
  93. :3
  94. Super-Shift Mode
  95.  
  96.    The Super-Shift  mode  is  created  by  increasing the delay time using the 
  97. Z3KEY.COM utility.  Normally the delay is  set  so that it is just long enough
  98. to allow the next character sent  by  a function  key to be received but times
  99. out before another  key can be entered manually.  This  allows  the program to
  100. tell the  difference  between  an  ESCAPE  key  being  pressed  and  an escape 
  101. charcater that is the beginning of a function key sequence.
  102.  
  103.    When the  delay  time  is increased  sufficiently, you  can enter the other
  104. characters in a sequence manually.  For example,  if you define the '\' as the
  105. lead-in character, entering '\p' could be  used to generate 'procedure'.  This
  106. gives you the equivalent of a whole keyboard full of function keys.
  107.  
  108.    Just increasing the delay allows multiple character sequences to be entered
  109. after a lead-in character as long as they are entered quickly enough.
  110.  
  111.    Setting the  delay to 0 makes the program wait after a lead-in character as
  112. long as necessary  for the  next  character.  Such sequences  are  always  two
  113. characters, the  lead-in  character  and  the  following  character.  This  is 
  114. similar to the SmartKey method of Super-Shift.
  115. :4
  116.  
  117.                                Z3KEYRCP.LIB
  118.  
  119.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  120.                3k        F117  1.4        Arnold Bailey 5/86       Z3RCP
  121. ==============================================================================
  122.  
  123.  
  124.  
  125.                                 Z3KEYRCP.Z80
  126.        
  127.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  128.               12k        0F21  1.4        Arnold Bailey 5/86       Z3RCP
  129. ==============================================================================
  130.  D2 17 3A 5D 00 FE 2F 20 06   <*........:]../ .>
  131. 00 0120 - 21 5C 09 C3 AA 01 CD 0C 1E 22 B1 09 28 0