HYPERKEY.TXT                 Manual for HyperKey tm            Revised  1/8/90










                                  HyperKey tm



                         Keyboard Enhancement Utilities











                            HyperWare
                            14460 Sycamore Avenue
                            San Martin, CA  95046
                            (408) 683-4911



                               HyperKey tm

                                Version 3



                      Keyboard Enhancement Utilities



                                by HyperWare

                            Copyright (c) 1987-90
                                 HyperWare
                                Roger Cross
                                 Tom Baker
                                David Foley







                      Documentation Revision  1/8/90


                             HyperKey tm  Table of Contents




         Chapter      Subject                                    Page
         --------------------------------------------------------------
           1          Introduction                                 1
                      HyperKey vs BIOS                             1
           2          System Requirements                          2
           3          Installation                                 3

                      HYPERKKEY.EXE
           4          HyperKey Parameters                          4
           5          Sample Device Driver Specifications          7
           6          Sample TSR Specifications                    7
           7          Microsoft Windows and the keyboard           8
           8          Special Configurations                       8
           9          Changing Parameters in HyperKey              8
          10          Error Messages                               9

                      KEYSET.EXE
          11          Using the Full Screen Setup                 10

                      DUDOS.EXE
          12          Using DUDOS                                 11
          13          Command Line Alias                          12
          14          Using the Recall List                       13

                      Appendices:
           A          Testing Installation                        14
           B          Tested Software                             15
           C          Terms of License Agreement                  16
           D          Limited Warranty                            17
           E          Copyright Notices                           18



                                    CHAPTER ONE:
                                    INTRODUCTION


     HyperKey boosts performance of your PC by enhancing your Keyboard.
     HyperKey provides you with complete control over your keyboard's Typematic
     functions.  Additionally, HyperKey provides Type Ahead Buffering,
     Typematic Pacing for instant stops while scrolling or repeating, Clicks
     for silent keyboards, one finger Touch Shifting tm, a DOS command line
     buffer with recall list, command alias, full screen setup plus more.


     HyperKey is made up of four basic programs.  HyperKey.EXE the main
     keyboard program which is the program that allows you to customize the
     operation of your keyboard.  KEYSET.EXE is the full screen setup program
     which allows you to try different settings and functions and create a
     configuration file.  DUDOS.EXE is the command line recall and aliasing
     program which allows you to edit and reuse all previously issued command
     lines entered from DOS.  INSTALL.EXE is the automatic installation
     program for HyperKey.



                                   HyperKey vs BIOS

     Your PC has a Basic Input/Output System (BIOS) which normally controls
     your keyboard functions.  BIOS does very little to provide support for so
     many of the windowing and scrolling type applications which are so common
     in today's PC systems.  Both the Delay to Repeat (Typematic Delay) and the
     Period of Repeat (Typematic Rate) are slow, cumbersome and unchangeable
     from DOS.  Additionally, PC BIOS provides a Type Ahead feature;  but it is
     limited to 15 characters.  Type Ahead buffering can be both good and bad.
     If you are waiting for a slow program to request more input, you may enter
     it before you are prompted, saving time when the program needs your
     input.  However, when you are scrolling or repeating some HyperKeytroke,
     Type Ahead causes you to overshoot your target and then beeps incessantly
     as your application complains that you have exceed its limits.

     HyperKey  addresses all of these problems.  You may set the Typematic
     Delay and Typematic Period to any values you like.  Type Ahead buffering
     provides 128 HyperKeytrokes and does not fill with repeated HyperKey as
     BIOS does.  The Typematic Period is paced to match your application's
     needs and will never overshoot or get ahead of your application.  In
     summary, HyperKey allows your PC Keyboard to excel in speed and
     performance.










                                       -1-


                                    CHAPTER TWO:
                                SYSTEM REQUIREMENTS










                         HyperKey  requires the following:


         - IBM PC, PC XT, PC AT, PS/2 or 100% Compatible

         - MS-DOS or PC-DOS version 2.00 or higher

         - One diskette drive either 360k or 1.2MB  5 1/4" or
                                     720k or 1.44MB 3 1/2"

         - 10k of RAM

         - 15k of Disk Space






























                                       -2-


                                  CHAPTER THREE:
                                   INSTALLATION


     HyperKey comes with an automatic installation program to help you install
     the programs.  To run the installation program enter:

     A:INSTALL [ENTER]

     You will be prompted for information about your requirements.  You can
     install HyperKey, DUDOS or both.  The installation program will edit your
     boot files to install the proper statements so HyperKey and/or DUDOS will
     load every time you boot your machine after running the installation
     program.









































                                       -3-

                                  CHAPTER FOUR:
                               HyperKey PARAMETERS


     You control the operating characteristics of HYPERKEY.EXE via the command
     line parameters that you specify in your CONFIG.SYS or AUTOEXEC.BAT file
     or by the parmaters specified in your config file if you use the xf:
     parameter.



     PARAMETER  EXPLANATION
     ----------------------------------------------------------------------

     D:nn   TYPEMATIC DELAY
            Sets the delay time before the key repeats itself, starting
            from when you hold down the key, until repetition begins.
            Start with a value of 350. Units in milliseconds.

     R:nn   TYPEMATIC PERIOD
            Sets the minimum time between repeats of a key after the
            initial Typematic Delay.  Smaller values repeat faster, larger
            values repeat more slowly.  Start with a value of 30.  Units in
            milliseconds.

     P:nn   TYPEMATIC PITCH
            Allows you to decrease the TYPEMATIC PERIOD automatically after
            each repeated key.  The value nn is subtracted from the repeat
            period after each repeated key.  Default is 500, Units are in
            microseconds.


     S:nn   TYPEMATIC SPAN
            Sets the number of repeat characters for which the TYPEMATIC
            PITCH control will be effective.  For example:  If you select a
            TYPEMATIC PITCH of 500 and a TYPEMATIC SPAN of 10.  For the
            first 10 repeated HyperKey, each will repeat faster than the
            previous one by 500 microseconds (1/2  millisecond), then
            remain constant for all HyperKey thereafter.  Default is 0
            (disabled).















                                       -4-




     H:nn   SPAN HOLDOFF
            Allows you to delay the initial effects of Typematic Span
            function.  The repeat period will remain constant for nn
            characters before the Span functions begin to decrease the
            period (increase the rate of repeats).  Example: You have set
            the SPAN to 30 and the PITCH to 500, now you want the first 5
            characters to repeat without increasing the rate:  Set the SPAN
            HOLDOFF to 5.  Default is zero.


     B:b    EXTENDED BUFFERING
            Enable HyperKey's Type Ahead buffer.  b or b:+ to enable; b:- to
            disable.  Default is enabled.  Note:  If after installing other
            enhancement products, you get two or more HyperKey delivered for
            each key you strike then disable this option.

     B:nn   During installation, the size of the extend keystroke buffer may
            be specified.  Values for nn may range from 16 to 4096.  Two bytes
            are required for each keystroke buffered.  Default is 128
            keystrokes.

     I      KEYBOARD LOCK INDICATORS
            Change the Keyboard Lock Indicators, such as CapsLock and NumLock.
            Use the first letter of the indicator name, UPPER-CASE sets the
            indicator, lower-case clears the indicator.  Indicators are
            CAPSLOCK, NUMLOCK, SCROLLLOCK and INSERTSTATE.

            Example:
                HYPERKEY -ICNSI       ; Sets all indicators.
                HYPERKEY -ICn         ; Sets CAPSLOCK, clears NUMLOCK.

            Some computers do not accept Indicators changes by device drivers,
            therefore you may need to execute HyperKey during AUTOEXEC.BAT
            initialization to change the indicators after BOOTING the machine.

     A:b    ACTIVE
            This option enables all HyperKey  functions.  A:+ to enable;  A:-
            to disable.  If you discover one of your programs is incompatable
            with HyperKey  you may disable it during that programs use.

     C:b    CLICK ON MAKE
            Issue a "Click" when a new key is struck.  Enter c or c:+ to
            enable Clicks;  c:- to disable.  Default is disabled.

     C:nn   CLICK PITCH
            Set the "Pitch of the Click".  This function is machine speed
            dependent, you can experiment with different values to create the
            sound you find most pleasing.  Default is 100.






                                       -5-



     CR:b   CLICK ON REPEATS
            Issue a "Click" on ALL keys, new and repeated.   cr:+ to enable;
            cr:- to disable.  Default is disabled.

     L:n    CLICK PERIOD
            Set the length of time the "Click" will sound.  This parameter is
            machine speed dependent.  Experiment to find a pleasing value.
            Default is 32.

     T:b    TOUCH SHIFTING tm
            Set touch shifting mode.  Allows you to enter a shifted keys
            combination serially.  Example:  To enter [Ctrl][F1], simply press
            the [Ctrl] key and release, then press the [F1] key and release.
            Directly speaking, Touch Shifting converts serial keying
            combinations to the equivalent parallel keying operation.  Touch
            Shifting is very useful for 101 and 102 key Keyboards.  t or t:+
            to enable;  t:- to disable.  Default is disabled.

     OK     OVERRIDE DISPLAY METHOD
            Allows you to select the display method.  HyperKey normally
            displays data directly via the Video BIOS.  OK or OK:+ forces I/O
            directly to the Video BIOS, while OK:- forces DOS I/O.  Alternately,
            the standard output device may be redirected to any device or
            file. Default is direct to Video BIOS.

            Example: hyperkey ok:-

            HyperKey will display the report via DOS Standard Output device.

            Example: hyperkey >CON

            Output is redirected to CON (console) device.


     OK:nn  OVERRIDE COLORS/ATTRIBUTES
            Allows you to select the Colors/Attributes for the Current Display.
            Color displays provide 16 foreground (text) colors to be applied on
            either 8 (CGA) or 16 (EGA/VGA) background colors.  Monochrome
            displays provide a variety of display attributes, some allow 2 or
            more intensities, underlining, blinking, etc.  For CGA displays
            there are 120 useful combinations,  EGA/VGA displays 240,
            Monochrome displays vary and are generally less than CGA.  Value nn
            be entered in either decimal or hexadecimal formats.

            Decimal example:      hyperkey ok:30
            Hexadecimal Example:  hyperkey ok:x1E

            Both selects yellow text on blue background.

            Alternately, you may select the colors manually by specifying.

            Example: >hyperkey OK:0.

                                       -6-




     OKC:nn OVERRIDE COLORS ONLY
            Same as OK:nn except, only Color Display attributes are affected.
            Useful for system with both monochrome and color displays.

     OKM:nn OVERRIDE MONOCHROME ATTRIBUTES ONLY
            Same as OK:nn except, only Monochrome Display attributes are
            affected.


                                  CHAPTER FIVE:
                    SAMPLE DEVICE DRIVER PARAMETER SPECIFICATIONS


     The following are examples of how to use HyperKey.EXE as a device driver:

     device=hyperkey.exe d:250 r:25 n

     With this set of parameters the following conditions apply:

     The delay to repeat time is 250 milliseconds.
     The minimum repeat delay is 25 milliseconds.
     No Type Ahead buffering is provided.


     device=hyperkey.exe

     With no parameters set the following conditions apply:

     The delay to repeat time is 350 milliseconds.
     The minimum repeat delay is 30 milliseconds.
     Type Ahead buffering of up to 128 characters.



                                  CHAPTER SIX:
            SAMPLE TERMINATE AND STAY RESIDENT PARAMETER SPECIFICATIONS


     hyperkey.exe d:250 r:25 n

     With this set of parameters the following conditions apply:

     The delay to repeat time is 250 milliseconds.
     The minimum repeat delay is 25 milliseconds.
     No Type Ahead buffering is provided.


     hyperkey.exe

     With no parameters set the following conditions apply:

     The delay to repeat time is 350 milliseconds.
     The minimum repeat delay is 30 milliseconds.
     Type Ahead buffering of up to 128 characters.



                                       -7-


                                  CHAPTER SEVEN:
                          MICROSOFT WINDOWS & THE KEYBOARD


     When MICROSOFT WINDOWS is active, keytrokes cannot be intercepted by a
     device driver such as HyperKey.  Therefore, HyperKey is inoperative while
     using the Windows Environment.



                                  CHAPTER EIGHT:
                             SPECIAL CONFIGURATIONS

     INTEL INBOARD 386:

     If you have an Intel Inboard 386, you should change the order of the
     device drives in your CONFIG.SYS file as follows:


     device = \sys\invoc.sys             { Intel Inboard Driver }
     device = \sys\speed.sys             { Intel Inboard Driver }
     device = \sys\hyperkey.exe
           .
           .
           .
     device = other.sys
           .
           .
           .



                                    CHAPTER NINE:
                    CHANGING HYPERKEY  PARAMETERS AFTER INSTALLATION


     After installing HyperKey  you may alter the operating parameters by
     running HYPERKEY.EXE at the DOS prompt.  Only the parameters you give on
     the command line will be changed.  For example assume you installed
     HyperKey using the Device Driver method and specified a Typematic Period
     of 25 milliseconds.  Later you decide the repeat rate could be a little
     faster.  Simply enter it at the DOS prompt:

     hyperkey.exe r:18

     HyperKey will now deliver repeat keys every 18 milliseconds.








                                       -8-


                                   CHAPTER TEN:
                                  ERROR MESSAGES


     HyperKey : Invalid Parameter:"UNKNOWN"

     HyperKey found an invalid command line parameter.  Check your command line
     parameters against the definitions in the INSTALLATION PARAMETERS section
     above.  HyperKey is installed with default settings.


     HyperKey : Incorrect DOS version

     HyperKey does not work with this version of MS-DOS.  HyperKey requires DOS
     version 2.0 or later.  HyperKey is not loaded.






































                                       -9-


                                 CHAPTER ELEVEN:
                                  USING KEYSET


     KEYSET.EXE allows the setup of parameters in a configuration file.  To
     load this file you enter:

     HYPERKEY.EXE xf:[fname].

     The installation program will create a file called HYPERKEY.CFG.  This
     will contain the default configuration.  If you have multiple people who
     use the same PC you might wish to store multiple configuration files for
     each persons keyboard preferences.  A good idea is to make a batch file
     for each person to run.  In the batch file include HYPERKEY.EXE
     xf:NAME.CFG, where NAME is the name of each persons configuration file.

     KEYSET will scan the path for HYPERKEY.CFG and read the settings into the
     setup program.  KEYSET allows you to edit the parameters of HyperKey, try
     them out, and then save the configuration file.  To run KEYSET just enter
     KEYSET.EXE [ENTER].  A full menu will appear with your options.  Use the
     arrow HyperKey to switch fields.  As you switch fields you will notice a
     brief description of each parameter in the middle window.  Use + and - to
     change the values of each parameter.  To try out the settings press F10
     and you will jump into the TEST WINDOW.  In the TEST WINDOW you can try
     typing with the settings.  Pressing F10 again will return you to editing
     the values.  Once you have the settings the way you like them, you can
     exit the setup program by pressing [ESC].  You may then have the choice of
     saving the new parameters to the configuration file.  Once saved, the next
     time you load HyperKey with the xf: option (as done automatically with the
     installation program) the new parameters will be loaded.























                                       -10-



                                 CHAPTER TWELVE:
                                   USING DUDOS


     DUDOS is a TSR program that provides a flexible and easy keyboard
     interface to MS-DOS.  DUDOS allows the translation of DOS commands by
     allowing the definition of alias'.  DUDOS also keeps a recall list of all
     commands entered at the DOS prompt, and allows the recall and editing of
     this command list.

     You can install DUDOS from the automatic installation program (see Chapter
     3:  Installation) or by executing it from the DOS prompt:

     DUDOS [alias.dat] [/c1:nnn] [/c2:nnn]

     alias.dat is a file containing the alias list.

     /c1 is the size of the primary recall list stack in nnn bytes (default
     256)

     /c2 is the size of the secondary recall list stack in nnn bytes (default
     130)  This stack is used for a separate recall list from the DOS recall
     list such as when using DEBUG.






























                                       -11-


                                 CHAPTER THIRTEEN:
                                COMMAND LINE ALIAS

     DUDOS allows the redefinition of DOS commands via its ALIAS function.  You
     can specify a command line with up to 9 parameters to be replaced by a
     specified alias.

     For example, if you wanted to replace the TYPE command with TY you would
     specify

     TY TYPE


     If you specified:

     S CD\%1

     Entering an S at the DOS prompt would issue a CD\ and put you in the root
     directory.  Entering an S WORK would move you to the \WORK directory from
     whatever directory you were in.

     In most cases the alias function can replace one line batch files by
     replacing the commands with an alias name.  The alias are arranged in a
     text file with one per line.  The alias file can be a maximum of 4K.  The
     actual alias commands can be up to 1K.  Each alias can have up to 9
     parameters on a command line.

     Example Alias File, ALIAS.DAT:

     TY TYPE
     S CD\%1
     E EDLIN %1
     C CLS


     Once installed you may display the Alias list by entering [CTRL] A at the
     DOS prompt.



















                                       -12-


                                 CHAPTER FOURTEEN:
                                 USING RECALL LIST


     Another benefit of DUDOS is the Recall List.  Like many mainframe
     terminals such as the DEC VT series, DUDOS saves the commands entered at
     the DOS prompt allowing you to recall them later, edit them and/or reuse
     them.  To scroll through the recall list use the up and down arrow key.
     You may display the entire list by entering [CTRL] R at the DOS prompt.
     DUDOS also allows the editing of a command line.  The default mode is
     overstrike.  You can toggle the insert mode by pressing the [INS] key.
     Backspace and the left and right arrow key can be used in overstrike or
     insert mode to edit the command line.  Entering a [CTRL] U will clear the
     command line.







































                                       -13-


                                    APPENDIX A:
                               TESTING INSTALLATION


     1.  Make a complete backup of your hard disk, if you have one.

     2.  Put a copy of HYPERKEY.EXE on newly formatted floppy diskette.

     3.  With the Diskette in drive A, enter at the DOS Prompt:
         HYPERKEY [ENTER]

     4.  If everything functions normally, your computer is BIOS compatible
         enough to install HyperKey  on your hard disk.

     5.  If your near compatible requires that either a Device Driver or TSR
         be install to emulate IBM BIOS functions, you should specify
         HYPERKEY.EXE immediately after the BIOS Emulator.

     6.  If after you have installed HyperKey  (specified in either the
         CONFIG.SYS or AUTOEXEC.BAT files) you discover some problems you can
         reboot the computer and abort the installation of HyperKey by holding
         the [Ctrl] [Alt] and [LeftShift] keys.  For most systems you will have
         to wait to depress these keys until the system has finished
         initializing the keyboard, but before the system begins reading the
         operating system device drivers from the disk (or diskette).  You can
         depress the shift keys when the disk or diskette (lights) becomes
         active.


























                                       -14-


                                    APPENDIX B:
                         SPECIAL SOFTWARE CONFIGURATIONS


     The following programs have been tested and/or used extensively with
     HyperKey and require some type of special loading instructions.  The
     notes for these products is listed below:


     Borland International
     SuperKey 1.16A      /n option should be set






























                                       -15-



                                    APPENDIX C:
                             TERMS OF LICENSE AGREEMENT

     This software is protected by both United States copyright law and
     international treaty provisions.  Therefore, you must treat this software
     "just like a book,"  with the following single exception.  HYPERWARE
     authorizes you to make archival copies of the software for the sole
     purpose of backing up our software and protecting your investment from
     loss.  By saying, "just like a book," HYPERWARE means that this software
     may be used by any number of people and may be freely moved from one
     computer location to another, so long as there is no possibility of it
     being used at one location while it is being used at another.  Just like a
     book that can't be read by two different people in two different places at
     the same time, neither can the software be used by two different people
     in two different places at the same time.

     You may not make copies of the software documentation or disk, except as
     described above.  You may not distribute, rent, sub-license, or lease the
     software or the documentation.  You may not alter, modify, or adapt the
     software or documentation, including but not limited to translating,
     decompiling, reverse assembling, or creating derivative works.  You may
     not use the software in a network, timesharing, multiple CPU, or
     multi-user environment unless each user is licensed by HYPERWARE.


     HyperKey is Licensed and not Sold.

     We do not warrant that the documentation is accurate, or that the program
     operates as specified.  We will not be liable for any damages of any kind
     sustained through the use of the program.

     By using the program, you agree to this.





















                                       -16-


                                    APPENDIX D:
                                 LIMITED WARRANTY

     In the event of notification of defects in material or workmanship, within
     the warranty period of 45 days from the date of purchase, HYPERWARE will,
     at its option, replace the defective diskette or refund the license fee.
     If you need to return a product, call the HYPERWARE Customer Service
     Department to obtain a return authorization number.  The remedy for breach
     of this warranty shall be limited to replacement or refund and shall not
     encompass any other damages, including but not limited to loss of profit,
     and special, incidental, consequential, or other similar claims.

     HYPERWARE specifically disclaims all other warranties, expressed or
     implied, including but not limited to implied warranties of
     merchantability and fitness for a particular purpose with respect to
     defects in the diskette and documentation, and the program license granted
     herein in particular, and without limiting operation of the program
     license with respect to any particular application, use, or purpose.  In
     no event shall HYPERWARE be liable for any loss of profit or any other
     commercial damage, including but not limited to special, incidental,
     consequential, or other damages.  This statement shall be construed,
     interpreted, and governed by the laws of the State of California.


     You may obtain Technical Support for this product Monday through Friday
     8:00 a.m. - 5:00 p.m., Pacific Time.

     Administration:    (408) 683-4911
     Technical Support: (408) 683-4923
     Fax:               (408) 683-4042

     Mail:              HyperWare
                        14460 Sycamore Ave.
                        San Martin, CA 95046


     HyperWare and HyperKey are trademarks of Roger Cross.
     MS-DOS is a trademark of Microsoft Corporation.
     Microsoft Windows is copyrighted by Microsoft Corporation.
     Other programs and/or equipment mentioned herein are trademarks or
     registered trademarks of their respective publishers and/or
     manufacturers.








                                       -17-



                                    APPENDIX E:
                                 COPYRIGHT NOTICES


     HyperKey is a trademark of HyperWare

     MS-DOS, is a trademark of Microsoft Corporation.

     IBM PC, PC XT, PC AT ,PC-DOS, and PS/2 are trademarks of International
     Business Machines Corporation.

     COMPAQ, DESKPRO, PORTABLE II and DESKPRO 286 are trademarks of Compaq
     Computer Corporation.

     Intel Inboard is a registered trademark of Intel Corporation.






































                                       -18-



                                   HyperKey  tm

                      Keyboard Enhancement Utilities  Version 3



     HyperKey tm is a utility for all MS-DOS/PC-DOS based personal computers.
     It allows customizing of your keyboard functions.

     HyperKey tm requires 3k to 10k depending on options.

     HyperKey tm requires 15k of disk space.

     HyperKey tm comes with an automatic installation program to install itself
     on your computer.

     HyperKey tm works with any PC including XT, AT, 386 and 486 based
     machines.


     Works with industry standard software such as:

     Autocad, Lotus 123, dBASE, Desqview, Procomm, Deskmate, Super Calc,
     Multimate, Word Perfect, Borland Turbo Compilers, Brief, Word Star

     and industry standard hardware such as:

     Compaq, IBM, ALR, Toshiba, Mitsubishi, Everex, AST, Wyse, NEC, Wang,
     Zenith, Northgate, Intel, Epson, DELL, Wells American, HP, Zeos, Data
     General and Tandon.


     System Requirements:

     - IBM PC, XT, AT, PS/2 or 100% Compatible

     - PC-DOS or MS-DOS version 2.00 or higher

     - 15k of disk space

     - 10k or RAM

     Copyright (c) 1989 HyperWare, 14460 Sycamore Ave., San Martin, CA 95046
                                                              (408) 683-4911






