home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / sysutl / pk191.arc / POWERKIT.DOC < prev    next >
Text File  |  1988-12-19  |  37KB  |  641 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                             POWERKIT Documentation
  9.  
  10.  
  11.                                 November 1988
  12.                                  Version 1.90
  13.  
  14.  
  15.                      Copyright 1987-88 by John H. Brooks.
  16.                              All rights reserved.
  17.                            Permission is granted to
  18.                    distribute copies of this documentation.
  19.  
  20.  
  21.     DISCLAIMER: This software is sold "as is."  No warranty is given, either 
  22.     express or implied, that any specific POWERKIT feature will work on any 
  23.     particular machine.  The manufacturer will not be liable for any damage 
  24.     caused by the use of POWERKIT. 
  25.     
  26.     The names of hardware and software products, and companies mentioned in 
  27.     this document are trademarks or service marks of the respective companies.
  28.  
  29.     To registered users, version 1.90 is a FREE upgrade.
  30.  
  31.     FORWARD: Welcome, I'll be brief.  I'm asking you to please pay for POWER-
  32.     KIT if you use it.  At $12.95, I believe the price is fair.  Give POWERKIT 
  33.     a good workout, then remit to: 
  34.     
  35.                              CENTRAL DATA SERVICES
  36.                                1641 WINONA COURT
  37.                                DENVER, CO 80204
  38.                                 (303) 595-4218
  39.  
  40.     SUPPORT FOR POWERKIT: Since there are so many different video cards, 
  41.     versions of PC/MS-DOS, flavors of the BIOS ROM, hardware configurations, 
  42.     all calling themselves "PC (or AT) compatible," the "non-guarantee" above 
  43.     is regrettable but necessary.  Obviously, you won't buy POWERKIT if it 
  44.     doesn't work on your machine, but if you could spare a few moments to let 
  45.     me know what would not work, and what kind of machine you have, I'll do my 
  46.     best to get POWERKIT to work on your machine.  As many registered users of 
  47.     POWERKIT have already discovered, I intend to have POWERKIT be one of the 
  48.     best supported SHAREWARE (or commercial, for that matter) programs in the 
  49.     business.  SEE PAGE 11 FOR INFORMATION ON POWERKIT'S NEW ONLINE SUPPORT.
  50.  
  51. INSTALLATION: Type "PK" at the DOS prompt. You may also type some optional 
  52.         instructions to POWERKIT (described in detail later) after the "PK".
  53.  
  54. INTRODUCTION: POWERKIT is small, about 2700 bytes of it stay in memory. If 
  55.         each of POWERKIT's tasks were to be done by separate "COM" programs, 
  56.         many thousands of bytes would be used.  Almost all of POWERKIT's 
  57.         operations may be controlled from the command line (the DOS prompt or 
  58.         a line in AUTOEXEC.BAT), with a keyboard "hot" key, or from a pop-up 
  59.         "1-2-3" style menu, even while you are inside another program.  Many 
  60.         can be disabled, if your favorite utility program does the same thing.  
  61.         After all, POWERKIT uses very little memory. 
  62.  
  63. Page 2 
  64.  
  65.         
  66.         You will like the way POWERKIT handles your keyboard.  A key, when 
  67.         pressed, starts to repeat after a waiting period whose length you set, 
  68.         accelerates smoothly at a rate you set to a top speed you set, and 
  69.         when released, "stops on a dime."  Keystrokes also may be made to 
  70.         repeat very slowly, or to repeat not at all.  POWERKIT's AutoPilot 
  71.         lets you teach your machine how to do a repetitive task, while you sit 
  72.         back and relax.  If that's not enough, add an extra large keystroke 
  73.         buffer and an ability to view what's in it, a way to route printer 
  74.         output to your screen, an escape hatch from programs that falter, a 
  75.         screen blanker, a floppy disk motor early shut-off, a way to protect 
  76.         your machine from prying eyes and mischievous fingers (even at 
  77.         bootup), a few other things, and there's HOOK. 
  78.         
  79.         HOOK is unique.  HOOK will open up many of those programs that won't 
  80.         let your "can't live without" pop-up utilities pop up.  HOOK will do 
  81.         other things too (see /K)eyboard redefine, and KEYPAD 5, H, page 9). 
  82.  
  83. LESS EXPERIENCED PC USERS: Don't be put off by the wealth of more or less 
  84.         technical data which follows.  You already know how to get POWERKIT 
  85.         working and if you read how to get the help menus (see /U1 farther down 
  86.         this page) you may never have to read anything else about POWERKIT. 
  87.  
  88. COMMANDING POWERKIT: Most POWERKIT parameters may be set by including them 
  89.         after the "PK" when you call POWERKIT, and several MUST be set from 
  90.         there.  For example, typing: 
  91.  
  92.                 PK/M15/W5/d2/f110/g68 
  93.         
  94.         will set the floppy disk motor to shut off after 1.5 seconds (15 
  95.         tenths), the wait before repeating a keystroke to 1/2 second (5 
  96.         tenths), the display to switch off after 2 minutes (if no keys have 
  97.         been pressed during that time), the keystroke repeat speed to a 
  98.         maximum of 110 keystrokes per second, and replaces KEYPAD 5 with F10 
  99.         (68 is the decimal scan code for F10) as the HOT key.  The commands 
  100.         may be entered in any order, in lower/UPPER case. 
  101.  
  102.         The following commands can be given ONLY from the command line of 
  103.         PK.COM
  104.  
  105.         /U1 is for NEW USERS who would like to have a menu to remind them of 
  106.         POWERKIT's many options.  /U1 tells POWERKIT, as it is being loaded, to 
  107.         attach an interface to itself which will allow it to communicate with 
  108.         a public domain program called SlashBar.  Slashbar is a program that 
  109.         pops menus of the user's choice onto the screen whenever the "ALT" and 
  110.         "/" keys are pressed simultaneously.  SlashBar, and its complementary 
  111.         program, MAKEBAR (MAKEBAR creates the menus SlashBar pops up), was 
  112.         written by R.L. Hummel, who wrote a description of SlashBar and its 
  113.         operation in the May 26, 1987 (vol. 6, # 10) issue of PC Magazine. 
  114.         There are many places you can obtain a copy of SlashBar, including PC 
  115.         Magazine's own BBS, (212) 696-0360 or (415) 598-9100.
  116.  
  117.         Assuming you have obtained a copy of SLASHBAR.COM, some modifications 
  118.         must be made to it.  But don't worry, they only need be made once, and 
  119.         they are easy to do.  Make sure that DEBUG.COM, SLASHBAR.COM, and 
  120.         SLASHMOD.TXT (included in this package) are on the same diskette, 
  121.         then, at the "A>" prompt, type: 
  122.  
  123. Page 3
  124.         
  125.                 A>debug slashbar.com <slashmod.txt
  126.  
  127.         The modification allows SlashBar to communicate with programs (any 
  128.         programs, not just POWERKIT) that are loaded "beneath" SlashBar.  With 
  129.         that task completed, see that POWERKIT.MNU (included in this package) 
  130.         is on the same diskette as SLASHBAR.COM, and at the "A>" prompt, type:
  131.  
  132.                 A>slashbar powerkit.mnu/2000
  133.  
  134.         Press "ALT" and "/" at the same time and watch POWERKIT's menu pop 
  135.         onto the screen.  The beauty of using SlashBar for POWERKIT's menus 
  136.         (besides being my tiny contribution to standardization of program 
  137.         interfaces) is that SlashBar need not be loaded when you are using a 
  138.         huge application program that takes up virtually all available memory, 
  139.         all memory, except perhaps for the 2.5k POWERKIT needs.  SlashBar, 
  140.         together with its menu buffer, uses several thousand bytes.
  141.  
  142.         For you that register POWERKIT, send an extra $2.50, and receive the 
  143.         latest version of POWERKIT, and a utility program that adds POWERKIT's 
  144.         commands to any other "BAR" (menu) file you use with SlashBar. 
  145.  
  146.         /In, /Jn sets the high byte and low byte, respectively, of the "ex-
  147.         tended" ASCII code SlashBar (or any other menu program) uses to get 
  148.         POWERKIT's attention.  With SlashBar, the high byte "must" be zero.  
  149.         The default low byte is 30 (1Eh), which is CTRL-6 (SlashBar doesn't 
  150.         recognize KEYPAD 5).  These switches were provided in case CTRL-6 
  151.         means something to one of your programs, and you wish to write your 
  152.         own "BAR" file (using MAKEBAR.COM), or use the utility provided to 
  153.         registered users (see /U1, page 2).
  154.  
  155.         /An, n = 0 to 9 (or thereabouts) tells POWERKIT the number of phony 
  156.         keystrokes to insert between each "real" keystroke.  This is a means 
  157.         to curb repeating key overshoot in especially recalcitrant programs.
  158.  
  159.         /Rn, n = 0 to 9 (or more) tells POWERKIT the number of times to "lie" 
  160.         to an application about the status of the keystroke buffer.  Its 
  161.         purpose is the same as /An above.  See page 8 for further details.
  162.  
  163.         /Cn, n = 0 or 1 toggles CAPS/SHIFT LOCK (see KEYPAD 5, C, page 10)
  164.         When ON, and when CAPS is ON too, pressing a SHIFT key will NOT pro-
  165.         duce a lower case letter. 
  166.         
  167.         /En, n = 65 to 90 (these are the ASCII codes for A-Z), sets the drive, 
  168.         floppy, ram, or hard, where POWERKIT looks for COMMAND.COM when it 
  169.         exits an application program and allows you to load and run another 
  170.         program, format a disk, etc.  COMMAND.COM must be in the "root" dir.
  171.  
  172.         /M)otor off after 1 to 255 tenths seconds.  This command has nothing 
  173.         to do with speeding up floppy disk input or output, it merely allows 
  174.         the computer to turn off the floppy disk drive motor after so many 
  175.         tenths of a second.  I included this command in POWERKIT to let you get 
  176.         back to work more quickly after a disk access (the keyboard sometimes 
  177.         won't work while the drive motor is on).  Also, it is not always safe 
  178.         to remove a disk from the drive while the motor is on (stray magnetic 
  179.         fields produced by the motor could garble the data on your disk).  If 
  180.         you tell POWERKIT nothing about motor shutoff, POWERKIT will set it to 
  181.         one second.  /M0 makes POWERKIT ignore motor shut off. 
  182.  
  183. Page 4 
  184.         
  185.         /Nn, N = 0 or 1, forces shell to DOS to use current active display page 
  186.         (n = 0), or change to a new display page (n = 1).  Also see page 10.
  187.         
  188.         /On, n = 0 to 25 (1 = top of screen), sets the line on which the 
  189.         cursor will appear after POWERKIT completes its initialization.  The 
  190.         default is line 25.  If you don't like that "CURSOR VANISH?" message, 
  191.         set /C25 (or any other setting) to make it go away.  /C0 clears the 
  192.         screen and puts the cursor at the top of the screen.
  193.         
  194.         /K)eyboard redefine, from its name, you might think is a replacement 
  195.         for ANSI.SYS. It is NOT, it is a supplement to ANSI.SYS and the other 
  196.         similar keyboard redefinition programs.  For the technically inclined, 
  197.         ANSI.SYS redefines the keyboard by replacing the (extended) ASCII code 
  198.         generated by one key, with the extended ASCII code generated by a dif-
  199.         ferent key.  However, some programs don't even bother to look at ASCII 
  200.         codes, so /K)eyboard redefine (used with HOOK, see page 9) works by 
  201.         replacing the "scan" code generated by one key with the scan code of a 
  202.         different key. 
  203.  
  204.         From here on the going gets kind of tough for awhile, so I'll go slow-
  205.         ly.  There is a type of program let's call a KIM, a Keyboard Interrupt 
  206.         Monopolizer.  If you own SIDEKICK, or a similar program, and you tried 
  207.         to call it up by pressing CTRL-ALT (or some other HOT key) while in-
  208.         side another program, and it either wouldn't pop up or your machine 
  209.         froze, that program you were inside was a KIM.  KIM's have other prob-
  210.         lems, too.  The older KIM's have no way of recognizing the larger key-
  211.         boards that come with many of the newer PC compatibles, except for the 
  212.         keys corresponding to the old 83 key "standard PC keyboard."  This 
  213.         means you can't use that nice separate cursor keypad while working 
  214.         within the KIM, for example.  POWERKIT's /K)eyboard redefine, in 
  215.         conjunction with the HOOK command could help you with that problem. 
  216.         /K)eyboard redefine takes two forms.  One, you can put pairs of scan 
  217.         codes on the "PK" command line; a "/" then the decimal scan 
  218.         code you wish to redefine, followed by "/" plus the decimal scan code 
  219.         you wish it to be, repeating this for each key to be redefined.  For 
  220.         example, what you see below makes the keyboards of TANDY 1000's or 
  221.         2000's work just fine inside most KIM's: 
  222.  
  223.      /K41/72/43/75/74/80/78/77/88/71/89/41/90/43/85/78/83/74/87/28/86/83/84/70 
  224.        ^ NOTE: no slash needed for first number 
  225.  
  226.         Obviously, you need to know something about scan codes to do this, 
  227.         which leads to the second way /K can be used.  Putting /K on the 
  228.         "PK" command line, followed by nothing at all, or followed by another 
  229.         POWERKIT command (like /k/h, for example) causes POWERKIT to help you 
  230.         find the scan codes.  First, the machine will start its normal boot-up 
  231.         procedure. When it loads POWERKIT, a beep will occur, and the display 
  232.         will read: 
  233.  
  234.         Press key to be changed, ESC to quit: 
  235.  
  236.         /k 
  237.         
  238.         Press a key, and its scan code (in decimal) will appear behind the /k, 
  239.         you will hear another beep, and the display will show: 
  240.  
  241.         Press key to change to: 
  242.  
  243. Page 5 
  244.  
  245.         /kXX 
  246.  
  247.         The XX above represents the scan code of the first key pressed.  Press 
  248.         a second key; its scan code will appear as /kXX/YY.  Another beep, and 
  249.         the "Press key to be changed, ESC to quit:" prompt will reappear.  In 
  250.         this way you can tell POWERKIT which keys you want redefined.  For 
  251.         example, to get that long line of redefined scan codes shown above (on 
  252.         a TANDY 1000), do the following (keypad means the numeric keypad): 
  253.         
  254.         PRESS           THEN PRESS      ACTION 
  255.         up arrow        keypad 8        fixes up arrow key 
  256.         down arrow      keypad 2        fixes down arrow key 
  257.         left arrow      keypad 4        fixes left arrow key 
  258.         right arrow     keypad 6        fixes right arrow key 
  259.         HOME            keypad 7        fixes HOME key 
  260.         F11             up arrow        makes F11 print ` and ~ 
  261.         F12             left arrow      makes F12 print \ and | 
  262.         INSERT          right arrow     changes INSERT to grey + 
  263.         DELETE          down arrow      changes DELETE to grey -
  264.         keypad ENTER    ENTER           fixes keypad ENTER 
  265.         keypad .        DELETE          changes keypad . to DELETE 
  266.         BREAK           HOLD            fixes CTRL-BREAK 
  267.         ESC                             saves scan codes and exits 
  268.         (inside a KIM, keypad 0 will probably act like INSERT) 
  269.  
  270.         In general, for any extended keyboard, you can use the first five 
  271.         sequences above for the ARROW and HOME keys, and in addition: 
  272.  
  273.         PRESS           THEN PRESS      ACTION 
  274.         END             keypad 1        fixes END key 
  275.         PG UP           keypad 9        fixes PG UP key 
  276.         PG DN           keypad 3        fixes PG DN key 
  277.         INSERT          keypad 0        fixes INSERT key 
  278.         DELETE          keypad .        fixes DELETE key 
  279.         ESC                             exits
  280.  
  281.         POWERKIT has enough room for 15 redefined keys.  After all this, the 
  282.         line on the display starting with /k will show the necessary scan 
  283.         codes to put on the "PK" command line before you next run the KIM; but 
  284.         there is no need to reboot the computer now, just write down the /k 
  285.         line for future reference.  POWERKIT has saved these codes, and after 
  286.         you do just one more thing, you can load the KIM and have your 
  287.         keyboard work properly.  That final task is to activate HOOK while the 
  288.         CAPS key is turned ON.  HOOK is activated by KEYPAD 5, H.  See page 9 
  289.         for a complete discussion of HOOK.  Turning on HOOK with CAPS ON tells 
  290.         POWERKIT to feed the new scan codes to the KIM. 
  291.         
  292.         /L)ock machine at bootup, like /K above, takes two forms.  Putting /L 
  293.         on the line with no parameters will show the (decimal) scan codes of 
  294.         the keys you press, until you press ESC, to use in a password that 
  295.         will have to be entered before the machine will continue booting up.  
  296.         Using parameters with /L will define the password.  For example: 
  297.  
  298.         /l30/48/46/32
  299.           ^ NOTE: no slash needed for first number 
  300.  
  301.         will define the password "ABCD".  The password may contain up to eight 
  302.  
  303. Page 6 
  304.  
  305.         keystrokes.  This password will protect only against children or 
  306.         casual meddling.  However, on a machine with a hard disk, and with 
  307.         some additional hardware/software changes, this password could provide 
  308.         one more "layer" of protection for "sensitive" data.  BE SURE to put 
  309.         ECHO OFF in your AUTOEXEC.BAT file when using this feature.
  310.  
  311.         /Qn, n = 0,1,2,4, or 8, for HOT KEY ALONE, or RIGHT SHIFT, LEFT SHIFT, 
  312.         CTRL, or ALT, plus HOT KEY, respectively (HOT KEY set by "/Gn" or from 
  313.         the keyboard, see page 10).  When n is not zero, the designated shift 
  314.         key must be pressed at the same time as the HOT key.  This switch was 
  315.         added to increase the number of possible HOT keys. 
  316.  
  317.         /Sn, n = 18 to 255 is a speedup factor.  It does this by stretching 
  318.         the time between memory refreshes in your machine.  It works on IBM 
  319.         PC's and AT's, and a few clones that are SO COMPATIBLE, they even use 
  320.         the same refresh interval.  Modern memory chips no longer need to be 
  321.         refreshed as often as the IBM machines do it.  /S255 should work on 
  322.         any machine whose memory chips have been manufactured in the last five 
  323.         years.  If not, lower n in /Sn, until it does work.  The speedup is 5% 
  324.         on 4.77 Mhz machines (PC's), up to 20% on some 12 Mhz AT clones.
  325.  
  326.         /Tn enables an algorithm that blanks HERCULES brand display adaptors.  
  327.         If you have an Hercules "compatible" adaptor, it probably can be 
  328.         blanked without invoking this command.
  329.  
  330.         /T1 -- Tests for an Hercules adaptor.  If present, enables blanking.
  331.         /T2 -- Activates Hercules blanking without testing first.
  332.  
  333.         /Vn, n = 91 to 255, is the number of timer ticks your machine makes in 
  334.         5 seconds.  The default is 91.
  335.  
  336.         /Xn adjusts the the time it takes repeating keystrokes to get up to 
  337.         top speed, (a speed you can set according to your own taste, see 
  338.         KEYPAD 5, F page 7).
  339.  
  340.         /X0 -- Repeating keystrokes start out at top speed.
  341.         /X1 -- Repeating keystrokes accelerate smoothly, but quickly, to their 
  342.                top speed.
  343.         /X2 -- Repeating keystrokes accelerate rather more slowly than with 
  344.                the /X1 setting.  This is the default setting.
  345.  
  346.         /Y0 turns off POWERKIT's Scroll Lock key handler (see page 10).
  347.  
  348.         /Z1 -- Turns on the much louder "system beep" and turns off POWERKIT's.
  349.  
  350. OTHER COMMANDS that may be put on the "PK" command line are:
  351.  
  352.         /D)isplay off 
  353.         /F)ast repeat
  354.         /G)et new HOT key
  355.         /H)ook
  356.         /O)vershoot plan A, B, or C, 0 for A, 1 for B, 2 for C. (used to be /P)
  357.         /P)rinter output to screen, 0 (off) or 1 (on).
  358.         /W)ait before repeating
  359.  
  360.         Note that when defining the HOT key here, the (decimal) scan code of 
  361.         your designated HOT key must be used.  Note also that when HOOK is 
  362.         placed here, and you wish it to be used with /K)eyboard redefine, make 
  363.         sure the CAPS key is ON while your machine is booting up. 
  364.  
  365.  
  366. Page 7
  367.         
  368. COMMANDS ACCESSED BY PRESSING AND RELEASING KEYPAD 5:  What follows are 
  369.         descriptions of the POWERKIT commands accessed from the keyboard.  
  370.         First, the "5" key on the numeric keypad (SHIFT KEYPAD 5 when NUM LOCK 
  371.         is "on") must be pressed, RELEASED, then the indicated COMMAND key 
  372.         pressed and released.  If the command needs more input (numbers or 
  373.         letters), enter them when you hear a beep.  Press ENTER when finished.  
  374.         If you press KEYPAD 5 by accident, press it AGAIN to cancel.
  375.  
  376. KEYPAD 5, ESC: Sometimes can bring you back to the DOS prompt from a hung or 
  377.         crashed program.  When KEYPAD 5, ESC does succeed, when you have pre-
  378.         cious unsaved data on a ramdisk for example, POWERKIT will have earned 
  379.         its keep. 
  380.         
  381.         NOTE: A few programs have their own escape routines.  If they exist, 
  382.         they are invoked by either CTRL-BREAK or CTRL-C (usually). 
  383.  
  384. KEYPAD 5, W: At the beep, entering a number from 1 to 60, followed by ENTER, 
  385.         will set the delay before keystrokes begin to repeat to that many 
  386.         tenths of a second.  Enter zero if you wish to go back to your old, 
  387.         sluggish keyboard.  But then, POWERKIT tasks associated with KEYPAD 5 
  388.         W, F, S, A, and R will no longer work. 
  389.  
  390. KEYPAD 5, F: At the beep, entering a number from 5 to 255, followed by ENTER, 
  391.         will set the maximum speed a keystroke repeats to that many repeti-
  392.         tions per second, give or take 2 reps./second.  The actual repetition 
  393.         rate will be determined by how fast the application program can handle 
  394.         keystrokes (ANSI.SYS slows the repeat rate, for example).  Enter zero 
  395.         and the keyboard will work like an old-fashioned typewriter keyboard 
  396.         (no auto-repeat, a more comfortable mode for those with disabilities). 
  397.  
  398.         NOTE 1: Use KEYPAD 5, S (see below) for 1 rep./sec, or slower.
  399.  
  400.         NOTE 2: Some repeat speeds are smoother than others.  This is deter-
  401.         mined by the tick rate of the system clock.  For most PC compatibles, 
  402.         5, 10, 19, 37, 55, 74, 92, 110 reps./sec. are the smoothest.  Also, 
  403.         adding 2 or 3 lies/rep. (KEYPAD 5, B, 2 or 3) smooths things out.
  404.  
  405. KEYPAD 5, S: At the beep, entering a number from 1 to 255, followed by ENTER, 
  406.         will repeat a keystroke (or a sequence of keystrokes) every that many 
  407.         seconds.  This is used mainly with AutoPilot (KEYPAD 5, A below).
  408.  
  409. KEYPAD 5, A: Activates AutoPilot. At the beep, enter up to 18 keystrokes that 
  410.         you want repeated, then press ENTER.  If you want an ENTER keystroke 
  411.         to be part of the sequence, press RIGHT SHIFT-ENTER.  After ENTER is 
  412.         pressed, the sequence will repeat, unless CAPS = ON, in which case the 
  413.         sequence will execute only once (but will be saved for possible re-
  414.         use), like an ordinary MACRO.  To stop (and erase) the repeating se-
  415.         quence, press any key.  However, if you want to save this sequence, 
  416.         press the RIGHT SHIFT key, which stops the action and saves the 
  417.         keystroke sequence.  To reactivate AutoPilot (using these keystrokes), 
  418.         press KEYPAD 5, A.  If CAPS = ON as you press, AutoPilot will stop af-
  419.         ter doing the sequence only once.  To erase a keystroke sequence that 
  420.         has been saved by pressing RIGHT SHIFT, without restarting AutoPilot, 
  421.         press KEYPAD 5, RIGHT SHIFT-A. 
  422.  
  423.         NOTE: Because of the peculiar nature of the programs we have dubbed 
  424.         KIM's (page 4, or see KEYPAD 5, H, page 9), there are actually two 
  425.         AutoPilot routines.  Therefore, an AutoPilot sequence that has been 
  426.  
  427.  
  428. Page 8
  429.  
  430.         defined outside a KIM won't work inside a KIM, and vice versa.  Use 
  431.         KEYPAD 5, A, with CAPS turned ON, to destroy saved keystrokes before 
  432.         "hooking" and entering a KIM, or before leaving a KIM.  PRESSING and 
  433.         RELEASING the CTRL, ALT, or SHIFT keys will count as ONE of the six-
  434.         teen permitted keystrokes while inside a KIM, while these key presses 
  435.         DON'T count against the sixteen when outside a KIM.
  436.  
  437.         I am certain that AutoPilot will be used in ways I could never dream 
  438.         of.  If you must dump your "KEY" program to load a large application, 
  439.         AutoPilot will be there to restore some of its function by using 
  440.         AutoPilot together with the at least rudimentary MACRO capability 
  441.         most application programs now have.  A single PG DN keystroke can be 
  442.         set to repeat at a comfortable pace, to let you read a document in 
  443.         your word processor without touching the keyboard.  To snoop through 
  444.         the BIOS ROM using DEBUG's UNASSEMBLE command, set the keystrokes to 
  445.         U, and RIGHT SHIFT-ENTER.  When something interesting appears, press 
  446.         RIGHT SHIFT, examine it more closely, then continue snooping with 
  447.         KEYPAD 5, A.  Suppose you would like to eliminate an entire column of 
  448.         a table in one of your applications.  You know the application has a 
  449.         very slick method of doing this, but you can remember only how to 
  450.         eliminate one line of the column at a time.  You can go to the user's 
  451.         manual, or it might be quicker to go to AutoPilot, enter the single 
  452.         line commands, plus a DOWN ARROW keystroke. 
  453.  
  454. KEYPAD 5, R: At the beep, enter A or B.  This sets the "plan" to use to inhib-
  455.         it repeating key overshoot, when inside certain programs.  Plan "A" 
  456.         inserts unusable "null" keystrokes between each "real" keystroke. How-
  457.         ever, some programs are just too smart for their own good and discard 
  458.         these null keystrokes before they can fill its buffer and prevent 
  459.         "run-on".  Hence the need for Plan "B".  Plan "B" tells the program a 
  460.         "little white lie", but it's "for its own good".  It sends a "no key-
  461.         stroke in buffer" report back to the program, several times, before 
  462.         sending the "true" message.  You can use these two plans together.  If 
  463.         CAPS = ON when choosing a plan, the values for the other plan will not 
  464.         be erased.  After entering A or B (after the second beep), enter the 
  465.         number of null keystrokes (or fibs) to insert between each "real" 
  466.         keystroke, then press ENTER. 
  467.         
  468.         You may never use this command.  The majority of programs use the 
  469.         keystroke buffer supported by the BIOS (delineated by the two words at 
  470.         40h:80h).  POWERKIT sees to it that, while a key is repeating, this 
  471.         buffer never contains more than one keystroke. Hence, overshoot is 
  472.         impossible. 
  473.  
  474.         However, KIM's (see pages 4 or 9) and some non-KIM's maintain their 
  475.         own keystroke buffers and couldn't care less that your cursor keeps 
  476.         moving after you release it.  Experiment with combinations of KEYPAD 
  477.         5, F (repeat speed)  and KEYPAD 5, R, A, B, and n.  Overshoot may not 
  478.         be eliminated, but is almost always reduced.  For example, setting 
  479.         KEYPAD 5, F to 92 and KEYPAD 5, R to "A,3" eliminates overshoot in 
  480.         QuickBASIC 3.0, a non-KIM which, nevertheless, keeps its own 8 key-
  481.         stroke buffer.  Setting KEYPAD 5, F to 37 and KEYPAD 5, R to "A,5" 
  482.         only reduces overshoot in QuickBASIC 2.0, a KIM which must be "hooked" 
  483.         (see page 9), and which keeps a 16 keystroke buffer.  BRIEF (v2.01) 
  484.         works fine with POWERKIT's default setting (2 fibs, 0 nulls), but on 
  485.         slower machines, your cursor will move faster using 1 null, 0 fibs. 
  486.  
  487.         NOTE: Some programs object mightily to the null keystrokes Plan A uses 
  488.  
  489.  
  490. Page 9
  491.  
  492.         to control overshoot.  PC-Write (and LIST), for example, sounds like a 
  493.         moonstruck cricket when nulls are set to greater than zero.  These 
  494.         plans may also be used to make repeats look smoother. 
  495.  
  496. KEYPAD 5, H: The HOOK command is designed to outwit those application programs 
  497.         I call Keyboard Interrupt Monopolizers, or KIM's for short.  You prob-
  498.         ably have a KIM in your library. It's a program such that after you 
  499.         load it, your favorite pop-up utilities won't work until you exit it.  
  500.         Activate HOOK just before you load the KIM.  If you hear a beep when 
  501.         the KIM starts to execute, then HOOK probably has intercepted the pro-
  502.         gram successfully and your pop-ups (including POWERKIT) should work. 
  503.         Deactivate HOOK after you leave the KIM by entering KEYPAD 5, H again.  
  504.         No beep this time. 
  505.  
  506.         FOR ADVANCED USERS: If CAPS LOCK is ON when you invoke HOOK, the KIM 
  507.         will be fed SCAN CODES determined from the table developed from data 
  508.         entered with the /K)eyboard redefine command.  See page 4 for a dis-
  509.         cussion of this command. This solves most of the problems many KIM's 
  510.         have with keyboards possessing more than the standard 83 "PC" keys. 
  511.         Some keyboards omit either the "make" or "break" signal when the 
  512.         lights (called LED's) in the CAPS or NUM LOCK keys are turned off or 
  513.         on.  These keys will still have to be pressed four times to put them 
  514.         through a complete cycle (while inside a KIM).
  515.  
  516.         SAD NOTE 1: No "keyboard macro" program (these programs usually have 
  517.         "KEY" somewhere in their name) that I am aware of will work inside a 
  518.         KIM, even a "hooked" KIM.  AutoPilot produces a (repeating) keyboard 
  519.         macro and that is why two separate AutoPilot routines were necessary.
  520.  
  521.         SAD NOTE 2: POWERKIT will not "hook" some KIM's.  These are KIM's that 
  522.         do not use DOS services to attach themselves to interrupts.  Also, 
  523.         hooking a non-KIM will sometimes hang the machine.
  524.  
  525.         QuickBASIC APPLICATIONS: Programs compiled with any QuickBASIC 
  526.         compiler, and which use the ON KEY command, must be "hooked" before 
  527.         pop-up utilities will work properly. 
  528.  
  529. KEYPAD 5, V: Opens (and closes) a view-port into the keystroke buffer.  Your 
  530.         most used applications probably have become so familiar to you, you 
  531.         know long beforehand what comes next and what you want to do about it.  
  532.         However, distractions occur and you can "lose your place" while typing 
  533.         "blind" into the keystroke buffer.  At these times a view-port is use-
  534.         ful. The view-port expands and contracts according to how many unused 
  535.         keystrokes are left in the buffer.  Reenter the command to close the 
  536.         view-port. 
  537.  
  538. KEYPAD 5, L: Lets you blank the screen and lock up the keyboard.  After 
  539.         pressing KEYPAD 5, L, the screen will blank (if you haven't disabled 
  540.         blanking).  At the beep, just press ENTER if you want no password pro-
  541.         tection, or enter up to a four keystroke password, then press ENTER.  
  542.         To get your machine back, PRESS and RELEASE the RIGHT SHIFT key and 
  543.         reenter the password.  Incidentally, your machine will go on computing 
  544.         while locked, if no keyboard input is needed. 
  545.  
  546. KEYPAD 5, D: At the beep, entering a number from 1 to 60, followed by ENTER, 
  547.         sets the display to turn off after one to sixty minutes of keyboard 
  548.         inactivity.  KEYPAD 5, D, 0 disables screen blanking.  Blanking is im-
  549.         portant for monochrome displays, to preserve their phosphor coatings.  
  550.  
  551.  
  552. Page 10
  553.  
  554.         POWERKIT's default setting is screen blanking DISABLED.  See page 6, 
  555.         /Tn, for instructions on enabling Hercules brand MGA card blanking. 
  556.  
  557. KEYPAD 5, G:  At the beep, press the key you wish to use to signal POWERKIT.  
  558.         Some call this a HOT key.  Use KEYPAD 5, G before you load a program 
  559.         to which KEYPAD 5 means something.  The keys LEFT and RIGHT SHIFT, 
  560.         CTRL, ALT, CAPS, NUM LOCK, and HOLD won't work as HOT keys.  Also, if 
  561.         NUM LOCK is ON, you must hold SHIFT, then press the HOT key. 
  562.  
  563. KEYPAD 5, C: Toggles a feature that, when ON (beep), and when CAPS is ON too, 
  564.         pressing a SHIFT key will NOT produce a lower case letter. 
  565.  
  566. KEYPAD 5, Y: Toggles POWERKIT's SCROLL LOCK key handler on/off.  POWERKIT turns 
  567.         the Scroll Lock key into what (I think) it should have been all along.  
  568.         Pressing the key will freeze a scrolling display until you press SCROLL 
  569.         LOCK again, allowing you to examine its contents at your leisure (now 
  570.         that's a whole lot easier than CTRL-NUM LOCK, isn't it?).  A beep will 
  571.         tell you when the display has been frozen, and beeps will greet your 
  572.         every key press, until you press SCROLL LOCK again.  Toggle it OFF, 
  573.         when a program has its own designs on the SCROLL LOCK key.
  574.         
  575. KEYPAD 5, P: Directs output normally destined for the printer, to the screen.  
  576.         This is handy when no printer is available and you must use a program 
  577.         that demands a printer be attached (when you are using a PC compatible 
  578.         laptop away from the office, for instance).  It also lets you preview 
  579.         the formatting of a document without wasting a lot of time and paper, 
  580.         if you don't have a WYSIWYG (what you see is what you get) text editor. 
  581.         Pressing KEYPAD 5, P a second time turns off this feature. 
  582.  
  583.         NOTE: I always boot up with /P1 on the "PK" command line, because it's 
  584.         easy to activate Print Screen inadvertently, with no printer online.
  585.  
  586. KEYPAD 5, E: Exits an application program, and puts you at the DOS prompt.  
  587.         There, you can perhaps do some little thing that you forgot to do be-
  588.         fore you entered the application (like format a new disk if the disk 
  589.         you are using is full, and the application wants to write more data).  
  590.         To return to the application, type "exit" at a DOS prompt.  If you have 
  591.         a graphics adaptor (CGA, EGA, etc.), POWERKIT exits to a different dis-
  592.         play page, so as not to mess up your screen.  With a single page adap-
  593.         tor (MDA), there is no choice, sorry.  However, a less confusing dis-
  594.         play will result if you place the cursor at the bottom of the screen 
  595.         prior to exiting to DOS.  See also the switch, /N on page 4. 
  596.         
  597.         POWERKIT has to find COMMAND.COM in order to do this little trick, and 
  598.         it is not very smart, it looks for COMMAND.COM only in a "root" direc-
  599.         tory (the directory you are in when you type "B:", say, at the DOS 
  600.         prompt).  The default is the "root" directory on drive "A", but you can 
  601.         change this drive at bootup with the "/E" switch (see page 3). CAUTION:  
  602.         Don't shell to DOS at the DOS prompt, and especially, NOT at bootup. 
  603.  
  604. CONFLICTS WITH OTHER PROGRAMS: Other times when POWERKIT and other TSR's or 
  605.         application programs don't work well together occur because the other 
  606.         program is trying to do some of the same things POWERKIT is doing, 
  607.         such things as enlarging the keystroke buffer, blanking the screen, or 
  608.         speeding up the cursor.  When this happens, disable the contested 
  609.         function, either in POWERKIT or in the other program (in the case of 
  610.         POWERKIT's extended keystroke buffer, simply don't enable it). 
  611.  
  612.  
  613. Page 11
  614.  
  615.         Finally, you must change POWERKIT's HOT key if it means something to 
  616.         the other program.
  617.  
  618. 101 KEY ENHANCED KEYBOARDS: I have completely rewritten POWERKIT's keyboard 
  619.         handler to make it compatible with most (90%) 101 key keyboards. How-
  620.         ever, if it doesn't work with yours and you would like it to, there is 
  621.         a 101 key enhanced keyboard driver (about 2k bytes) that WORKS with 
  622.         POWERKIT, included in this package. 
  623.  
  624. ONLINE SUPPORT FOR POWERKIT: If you have a modem, you can get prompt answers 
  625.         to your questions (several times a day), and download some interesting 
  626.         files by contacting me on a CCIE (Compatible Computer Information Ex-
  627.         change) BBS.  The phone number is: (303) 377-6725.  You need not be a 
  628.         regis-tered user to use this service. 
  629.  
  630. That's it, you're on your own.  Enjoy POWERKIT and please don't forget to send 
  631.         $12.95.
  632.  
  633.                                  CENTRAL DATA SERVICES
  634.                                    1641 WINONA COURT
  635.                                    DENVER, CO 80204
  636.                                     (303) 595-4218
  637.                                       or 595-4074
  638.  
  639.  
  640.  
  641.