home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / dkey120.zip / DKEY.DOC < prev    next >
Text File  |  1988-07-10  |  6KB  |  139 lines
  1. DKEY documentation
  2.  
  3.  
  4. DKEY was designed as a very small replacement for Prokey or SuperKey
  5. type programs.  It does not contain many of the bells and whistles of
  6. these other products, but in it's default configuration it consumes
  7. only 3.1k of RAM - this includes a 1k macro buffer.  Use it in good
  8. health, and feel free to share unmodified copies.
  9.  
  10.  
  11.  
  12.  
  13.  
  14. Version 1.20    7-10-88    SideKick access added (see #12 below).  Bug
  15.                fixed relating to redefining <9>.
  16.  
  17. Version 1.10    2-24-88    Yet another bug fixed relating to '<' and '>'
  18.  
  19. Version 1.09    2-16-88    Fixed bug relating to keycodes > 127
  20.  
  21. Version 1.08    2-9-88     Numeric keypad keys 0-9 . + - now generate
  22.                            distinct codes during macro playback.
  23.  
  24. Version 1.07    10-5-87    Bug fixed relating to changing '<' and '>'.
  25.  
  26. Version 1.06    7-11-87    Update to allow for changeable 'Hot Key'.
  27.  
  28. Version 1.05    5-26-87    Bug fixed which caused files created by
  29.                            certain text editors to be mis-read.
  30.  
  31. Version 1.04    5-4-87     Bug fixed in display portion where
  32.                            computer would crash if length of macro
  33.                            definitions exceeded 256.
  34.  
  35. Version 1.03    7-25-86    Original shareware release.
  36.  
  37.  
  38.  
  39.  
  40. 1)  Install the resident portion of DKEY by typing
  41.         DK n
  42.     where n is the size, in kbytes, that you want for the macro
  43.     buffer.  If n is not specified, 1k will be allocated for the
  44.     macro buffer.  62k is the maximum allowed.
  45.  
  46. 2)  If DK is already resident, it will tell you so.
  47.  
  48. 3)  To define a new macro:
  49.  
  50.         a)  Press ^\  (Control backslash)  DKEY will announce its
  51.             readiness to accept a definition by printing DKEY:
  52.         
  53.         b)  Press the key to be redefined.  (Any keystroke that BIOS
  54.             accepts is OK).  DKEY will echo your choice & begin accepting
  55.             definition characters.  The screen will appear as:
  56.             
  57.                 A>DKEY: <^A> = "
  58.         
  59.         c)  Enter any series of keystrokes for the definition.  Pressing
  60.             RETURN enters a return into the macro and advances to the 
  61.             next screen line.  The backspace key will allow you to correct
  62.             errors.  Note:  The display will not backup past the beginning
  63.             of a screen line but keystrokes will continue to be deleted.
  64.         
  65.         d)  Terminate the definition by pressing ^\ again.
  66.  
  67.         e)  Please note that all this happens "off-line" to any
  68.             program running at the time, including DOS.
  69.  
  70.         
  71. 4)  To redefine a key which already has a macro assigned to it, merely
  72.     repeat the definition process, nothing special is required.
  73.         
  74. 5)  To restore a key to its non-macro state, enter  ^\ key ^\
  75.         
  76. 6)  To reset the entire entire keyboard to its non-macro state,
  77.     enter  ^\ ^@ ^\   (^@ enters the DKEY Command mode, but RESET is
  78.     the only command currently implemented.
  79.  
  80. 7)  To stop a macro while it is running, press ^\
  81.  
  82. 8)  To display any existing macros, type 'DKEY'.
  83.  
  84. 9)  To save the current macros for later use, type 'DKEY >filespec'. 
  85.     This saves the display to a file which can be editted or added
  86.     to.  To create your own macro file, merely follow the example
  87.     given by DKEY when it writes to a file.
  88.  
  89. 10) To load a macro file, type 'DKEY filespec'.  This invocation erases all
  90.     previous definitions.  To load a macro file but maintain the previous
  91.     definitions (merge), type 'DKEY filespec -m'.  The existing definitions
  92.     will be maintained except where a key is given a new definition in the
  93.     file being loaded.  The merge option indicator may be upper or lower case,
  94.     may occur before or after the filespec.  '-' or '/' may be used as the
  95.     option  switch.
  96.  
  97. 11) To manipulate DKEY from a C program, see KEYLIB.ASM
  98.  
  99. 12) In version 1.2, SideKick access was added.  This allows a macro
  100.     to call up SideKick and even enter keystrokes.  This feature is
  101.     accessible only from a loaded macro and cannot be inserted
  102.     directly into a macro being created on the keyboard.  The
  103.     following example is a macro which will enter the SideKick
  104.     notepad, move to the end, create a new line, enter the current
  105.     time and date and position at the end of that line.
  106.  
  107.             <`> = "<SideKick><Alt N><^Q>o<Up><^Q>d  "
  108.  
  109.  
  110.     Please note that this requires SideKick version 1.50 or greater. 
  111.     No harm is done if SideKick is not resident.
  112.  
  113.  
  114.  
  115. 13) To change the 'Hot Key' ( default is ^\ ), insure that the two
  116.     files:  DK.COM  and  DKHOTKEY.COM  are in the default directory. 
  117.     At the DOS prompt, type 'DKHOTKEY'.  At the prompt, enter the key
  118.     combination you want to be the new 'Hot Key'.  Note that not all
  119.     key combinations are acceptable to BIOS.  If you press a
  120.     combination and nothing happens, it probably means that the
  121.     combination you pressed is not acceptable.  The copy of DK.COM
  122.     will then be updated.  To activate the program with the new 'Hot
  123.     Key', reboot using the new copy of DK.COM.  (This change is in
  124.     response to the Tandy 1000 which does not use the same code for
  125.     ^\  as the IBM PC.  Thanks to C. J. Mitchell, Jr. for
  126.     bringing that fact to my attention.
  127.  
  128. 14) If you find this program useful, a donation ($10 recommended)
  129.     would be most welcome.
  130.  
  131.         Digital Mechanics
  132.         5347 Arlington Dr. W.
  133.         Hanover Park, IL  60103
  134.  
  135.  
  136.  
  137.  
  138. * SideKick is a trademark of Borland International
  139.