home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / MBUG / MBUG044.ARC / QUICKKEY.DOC < prev    next >
Text File  |  1979-12-31  |  5KB  |  136 lines
  1.  
  2.  
  3.                                   Q W I K K E Y
  4.  
  5.  
  6.  
  7.                          A Keyboard Redefinition Program
  8.                                 V2.0  25-MAR-1984
  9.  
  10.  
  11.                         Copyright (c) 1984 by Tony Fleig
  12.               QwikKey may be used for non-commercial purposes only.
  13.               No commercial use of QwikKey may be made without the
  14.                       author's express written permission.
  15.  
  16.  
  17.         1.0  INTRODUCTION
  18.  
  19.         QwikKey  allows  the user to assign a character strings to  keys.  
  20.         When  a key having a string defined in this way  is  struck,  the 
  21.         defined  string,  rather  than the character normally  associated 
  22.         with the key, is delivered to the program running at the time.
  23.  
  24.         Key  definitions may be loaded from files  containing  previously 
  25.         saved definitions,  or they may be defined on-the-fly, even while 
  26.         a program is running.   Both normal keys (i.e.  keys generating a 
  27.         single  character)  and  keys  generating  escape  sequences  are 
  28.         supported.
  29.  
  30.         The  maximum length of the defined string is 31 minus the  length 
  31.         of  the  character  or string normally generated by  the  key  in 
  32.         question.  Thirty-one different keys may be defined.
  33.  
  34.  
  35.         2.0  OPERATION
  36.  
  37.         2.1  The First Time
  38.  
  39.         QwikKey  V2.0  should  be  invoked for the first  time  with  the 
  40.         command "QK".   QwikKey will prompt for an "attention/termination 
  41.         character" and an "escape sequence lead-in character".
  42.  
  43.         The attention/termination character is used to gain the attention 
  44.         of  QwikKey  in order to enter a new key  definition.   The  same 
  45.         character is used to terminate the definition string.  Thus, this 
  46.         character  should be one that is seldom if ever used,  both  from 
  47.         the keyboard, and in key definition strings.
  48.  
  49.         The  escape  sequence lead-in character is  the  first  character 
  50.         generated  by  keys which generate escape sequences  rather  than 
  51.  
  52.  
  53.  
  54.  
  55. è
  56.  
  57.  
  58.  
  59.         single  characters.   This is almost always the ESCAPE  character 
  60.         (ASCII 27 decimal).
  61.  
  62.         After  the attention and lead-in characters are entered,  QwikKey 
  63.         loads  itself  below the CCP  (Console  Command  Processor),  and 
  64.         returns  control  to CP/M.   The message "QwikKey  loaded."  will 
  65.         appear  at  each warm boot to remind you that QwikKey  is  indeed 
  66.         active.
  67.  
  68.         At  this point,  striking the attention character key will  cause 
  69.         QwikKey to respond with the following prompt:
  70.  
  71.              Key:
  72.  
  73.         Now  strike the key you wish to define.   The character  normally 
  74.         generated  by  the key will be displayed,  followed by an  equals 
  75.         sign.   Suppose for example,  you wished to define the  control-K 
  76.         key.  The following would appear after striking CTRL-K:
  77.  
  78.              Key: ^K =
  79.  
  80.         Now  enter  the  definition string,  followed  by  the  attention 
  81.         character  again.   Suppose  we  wished  to  define  ^K  as  "PIP 
  82.         A:=B:*.*[V]".   The  following would be displayed just before  we 
  83.         hit the attention character to terminate the definition:
  84.  
  85.              Key: ^K = PIP A:=B:*.*[V]
  86.  
  87.         Upon  entry  of  the termination character,  the  key  definition 
  88.         dialogue  is  erased.   Note that characters overwritten  by  the 
  89.         definition dialogue are not rewritten, but replaced on the screen 
  90.         with spaces.
  91.  
  92.         At this point, the key has been defined, and striking the defined 
  93.         key  will result in the definition string being delivered to  the 
  94.         current program (perhaps the CCP).
  95.  
  96.  
  97.         2.2  Saving Definitions
  98.  
  99.         The  following  command  will save your current  definitions  for 
  100.         later  recall in the file KEYDEF.DAT.   It can only be issued  at 
  101.         the CCP prompt level (e.g. A>).
  102.  
  103.              A>QK SAVE KEYDEF.DAT
  104.  
  105.         If the filename is omitted in the above example,  the definitions 
  106.         will be saved in the file QWIKKEY.DEF.   SAVE may be  abbreviated 
  107.         to the single character "S".
  108.  
  109. è
  110.  
  111.  
  112.         Note  that  the  attention/termination character and  the  escape 
  113.         sequence lead-in character are also saved in the definition file.
  114.  
  115.  
  116.         2.3  Loading Previously Saved Definitions
  117.  
  118.  
  119.  
  120.         The  following command will load previously saved  commands  from 
  121.         KEYDEF.DAT  into QwikKey's definition table in memory,  replacing 
  122.         any current definitions.  It can only be issued at the CCP prompt 
  123.         level (e.g. A>).
  124.  
  125.              A>QK LOAD KEYDEF.DAT
  126.  
  127.         If the filename is omitted in the above example,  the definitions 
  128.         will be read from the file QWIKKEY.DEF.   LOAD may be abbreviated 
  129.         to the single character "L".
  130.  
  131.         Note  that  the attention/termination character  and  the  escape 
  132.         sequence  lead-in  character  are also read from  the  definition 
  133.         file.
  134.  
  135.  
  136.