home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol161 / qwikkey.doc < prev    next >
Encoding:
Text File  |  1985-03-23  |  3.8 KB  |  82 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                  Q W I K K E Y
  9.  
  10.  
  11.  
  12.                         A Keyboard Redefinition Program
  13.                                V1.1  20-Sep-1983
  14.  
  15.  
  16.                         Copyright (c) 1983 by Tony Fleig
  17.              QWIKKEY may be used for non-commercial purposes only.
  18.               No commercial use of QWIKKEY may be made without the
  19.                       author's express written permission.
  20.  
  21.  
  22.  
  23.              QWIKKEY allows any key(s) on your keyboard to  be  replaced
  24.         by  a  character  string  of  your  choosing.  The string can be
  25.         anything,  but  would  most  usefully  be  a  frequently  issued
  26.         command.   Keys  may  be defined at any time, even while you are
  27.         running a program (except WORDSTAR, in this version  at  least).
  28.         Key  definitions  remain across warm boots, but are lost on cold
  29.         boots;  the utility is meant to be used  on-the-fly,  to  define
  30.         commands  as you need them, rather than redefining a set of keys
  31.         for a particular program.
  32.  
  33.              Install QWIKKEY by running the  QWIKKEY.COM  program  (e.g.
  34.         A>QWIKKEY  -  this will  have  to be done after each cold boot).
  35.         QWIKKEY  will  then   prompt  for  an   "attention"   character.
  36.         This is the character which will signal QWIKKEY that you wish to
  37.         enter  a new key definition.  The best choice for this character
  38.         is a character that is not used for any other purpose  (commonly
  39.         a  control  character).  QWIKKEY positions itself just below the
  40.         CCP and  intercepts  all  console  input,  looking  for  defined
  41.         characters.   After  running QWIKKEY, no characters are defined,
  42.         so your system should behave just as it did before.
  43.  
  44.              To define a key, enter the attention  character  -  QWIKKEY
  45.         will  prompt  with:   "Key:".   At this point, press the key you
  46.         wish  to  define  (control  keys  are  generally   popular   for
  47.         redefinition).   After echoing the key entered, followed by "=",
  48.         QWIKKEY will now  wait  for  the  definition.   Definitions  may
  49.         contain  any  character  including  carriage returns, line feeds
  50.         etc.  (note that a carriage return is echoed  as  "^M" and  line
  51.         feed as "^J") except ^Z. ^Z is used to terminate the definition.
  52.         Example:
  53.  
  54.                   A>Key: ^A = PIP A:=B:*.*[V]^M  <--- ^Z here to end
  55.  
  56.  
  57.              If you want to remove a definition, simply define a key  to
  58.         be  itself.  There is a limit of 16 definitions of 30 characters
  59.         each.
  60.  
  61. QWIKKEY                                                                   Page 2
  62.  
  63.  
  64.              This is version 1.1, and was really done just to see if the
  65.         concept   was  valid.   It  appears  to  work  fine,  with  some
  66.         drawbacks:  XSUB  thinks  it's  already  loaded  if  QWIKKEY  is
  67.         installed,  and  therefore  is unusable, WORDSTAR overwrites the
  68.         CCP and everything below it as far as I  can  tell,  wiping  out
  69.         QWIKKEY,  and itself in the process.  There must be other things
  70.         that are broken by QWIKKEY V1.1 that I haven't discovered.   For
  71.         V2.0,  I plan to include the ability to store key definitions in
  72.         a file and retrieve them at will, and the capability of handling
  73.         keys  that  generate  escape  sequences,  such  as the alternate
  74.         keypad mode of the DEC VT100 terminal.  It  also  occurs  to  me
  75.         that  this  same technique could be applied to output as well as
  76.         input, allowing a program to send, for example, escape sequences
  77.         peculiar  to the Lier-Siegler ADM-3A, but have the corresponding
  78.         VT100 escape sequences delivered to the console terminal.
  79.  
  80.              My  thanks   to  Gary  Novosielski   for   the   relocation
  81.         technique used in version 3.0 of his UNSPOOL program.
  82.