home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 24b / pk181a.zip / POWERKIT.DOC < prev    next >
Text File  |  1988-04-27  |  36KB  |  633 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                             POWERKIT Documentation
  9.  
  10.  
  11.                                   April 1988
  12.                                  Version 1.80
  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.80 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 $9.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.                                   or 595-4074
  40.  
  41.     SUPPORT FOR POWERKIT: Since there are so many different video cards, 
  42.     versions of PC/MS-DOS, flavors of the BIOS ROM, hardware configurations, 
  43.     all calling themselves "PC (or AT) compatible," the "non-guarantee" above 
  44.     is regrettable but necessary.  Obviously, you won't buy POWERKIT if it 
  45.     doesn't work on your machine, but if you could spare a few moments to let 
  46.     me know what would not work, and what kind of machine you have, I'll do my 
  47.     best to get POWERKIT to work on your machine.  As many registered users of 
  48.     POWERKIT have already discovered, I intend to have POWERKIT be one of the 
  49.     best supported SHAREWARE (or commercial, for that matter) programs in the 
  50.     business.  SEE PAGE 11 FOR INFORMATION ON POWERKIT'S NEW ONLINE SUPPORT.
  51.  
  52. INSTALLATION: Type "PK" at the DOS prompt. You may also type some optional 
  53.         instructions to POWERKIT (described in detail later) after the "PK".
  54.  
  55. INTRODUCTION: POWERKIT is small, about 2500 bytes of it stay in memory. If 
  56.         each of POWERKIT's tasks were to be done by separate "COM" programs, 
  57.         many thousands of bytes would be used.  Almost all of POWERKIT's 
  58.         operations may be controlled from the defining line in the CONFIG.SYS 
  59.         file or the command line for the "COM" version of POWERKIT, with a 
  60.         keyboard "hot" key, or from a pop-up "1-2-3" style menu, even while 
  61.  
  62. Page 2
  63.  
  64.         you are inside another program.  Many can be disabled, if your 
  65.         favorite utility program does the same thing better.  After all, 
  66.         POWERKIT uses very little memory. 
  67.         
  68.         You will like the way POWERKIT handles your keyboard.  A key, when 
  69.         pressed, starts to repeat after a waiting period whose length you set, 
  70.         accelerates smoothly at a rate you set to a top speed you set, and 
  71.         when released, "stops on a dime."  Keystrokes also may be made to 
  72.         repeat very slowly, or to repeat not at all.  POWERKIT's AutoPilot 
  73.         lets you teach your machine how to do a repetitive task, while you sit 
  74.         back and relax.  If that's not enough, add an extra large keystroke 
  75.         buffer and an ability to view what's in it, a way to route printer 
  76.         output to your screen, an escape hatch from programs that falter, a 
  77.         screen blanker, a floppy disk motor early shut-off, a way to protect 
  78.         your machine from prying eyes and mischievous fingers (even at 
  79.         bootup), a few other things, and there's HOOK. 
  80.         
  81.         HOOK is unique.  HOOK will open up many of those programs that won't 
  82.         let your "can't live without" pop-up utilities pop up.  HOOK will do 
  83.         other things too (see /K)eyboard redefine, and KEYPAD 5, H, page 8). 
  84.  
  85. INEXPERIENCED PC USERS: Don't be put off by the wealth of more or less techni-
  86.         cal data which follows.  You already know how to get POWERKIT working 
  87.         and if you read how to get the help menus (see /U1 farther down this 
  88.         page) you may never have to read anything else about POWERKIT.
  89.  
  90. COMMANDING POWERKIT: Most POWERKIT parameters may be set by including them 
  91.         after the "PK" when you call POWERKIT, and several MUST be set from 
  92.         there.  For example, typing: 
  93.  
  94.                 PK/M15/W5/d2/f110/g68 
  95.         
  96.         will set the floppy disk motor to shut off after 1.5 seconds (15 
  97.         tenths), the wait before repeating a keystroke to 1/2 second (5 
  98.         tenths), the display to switch off after 2 minutes (if no keys have 
  99.         been pressed during that time), the keystroke repeat speed to a 
  100.         maximum of 110 keystrokes per second, and replaces KEYPAD 5 with F10 
  101.         (68 is the decimal scan code for F10) as the HOT key.  The commands 
  102.         may be entered in any order, in lower/UPPER case. 
  103.  
  104.         The following commands can be given ONLY from the command line of 
  105.         PK.COM
  106.  
  107.         /U1 is for NEW USERS who would like to have a menu to remind them of 
  108.         POWERKIT's many options.  /U1 tells POWERKIT, as it is being loaded, to 
  109.         attach an interface to itself which will allow it to communicate with 
  110.         a public domain program called SlashBar.  Slashbar is a program that 
  111.         pops menus of the user's choice onto the screen whenever the "ALT" and 
  112.         "/" keys are pressed simultaneously.  SlashBar, and its complementary 
  113.         program, MAKEBAR (MAKEBAR creates the menus SlashBar pops up), was 
  114.         written by R.L. Hummel, who wrote a description of SlashBar and its 
  115.         operation in the May 26, 1987 (vol. 6, # 10) issue of PC Magazine. 
  116.         There are many places you can obtain a copy of SlashBar, including PC 
  117.         Magazine's own BBS, (212) 696-0360 or (415) 598-9100.
  118.  
  119.         Assuming you have obtained a copy of SLASHBAR.COM, some modifications 
  120.         must be made to it.  But don't worry, they only need be made once, and 
  121.         they are easy to do.  Make sure that DEBUG.COM, SLASHBAR.COM, and 
  122.  
  123. Page 3
  124.  
  125.         SLASHMOD.TXT (included in this package) are on the same diskette, 
  126.         then, at the "A>" prompt, type: 
  127.  
  128.                 A>debug slashbar.com <slashmod.txt
  129.  
  130.         The modification allows SlashBar to communicate with programs (any 
  131.         programs, not just POWERKIT) that are loaded "beneath" SlashBar.  With 
  132.         that task completed, see that POWERKIT.MNU (included in this package) 
  133.         is on the same diskette as SLASHBAR.COM, and at the "A>" prompt, type:
  134.  
  135.                 A>slashbar powerkit.mnu/2000
  136.  
  137.         Press "ALT" and "/" at the same time and watch POWERKIT's menu pop 
  138.         onto the screen.  The beauty of using SlashBar for POWERKIT's menus 
  139.         (besides being my tiny contribution to standardization of program 
  140.         interfaces) is that SlashBar need not be loaded when you are using a 
  141.         huge application program that takes up virtually all available memory, 
  142.         all memory, except perhaps for the 2.5k POWERKIT needs.  SlashBar, 
  143.         together with its menu buffer, uses several thousand bytes.
  144.  
  145.         For you that register POWERKIT, send an extra $2.50, and receive the 
  146.         latest version of POWERKIT, and a utility program that adds POWERKIT's 
  147.         commands to any other "BAR" (menu) file you use with SlashBar. 
  148.  
  149.         /In, /Jn sets the high byte and low byte, respectively, of the "ex-
  150.         tended" ASCII code SlashBar (or any other menu program) uses to get 
  151.         POWERKIT's attention.  With SlashBar, the high byte "must" be zero.  
  152.         The default low byte is 30 (1Eh), which is CTRL-6 (SlashBar doesn't 
  153.         recognize KEYPAD 5).  These switches were provided in case CTRL-6 
  154.         means something to one of your programs, and you wish to write your 
  155.         own "BAR" file (using MAKEBAR.COM), or use the utility provided to 
  156.         registered users (see /U1, page 2).
  157.  
  158.         /An, n = 0 to 9 (or thereabouts) tells POWERKIT the number of phony 
  159.         keystrokes to insert between each "real" keystroke.  This is a means 
  160.         to curb repeating key overshoot in especially recalcitrant programs.
  161.  
  162.         /Rn, n = 0 to 9 (or more) tells POWERKIT the number of times to "lie" 
  163.         to an application about the status of the keystroke buffer.  Its 
  164.         purpose is the same as /An above.  See page 8 for further details.
  165.  
  166.         /Cn, n = 0 to 25 (1 = top of screen), sets the line on which the 
  167.         cursor will appear after POWERKIT completes its initialization.  The 
  168.         default is line 25.  If you don't like that "CURSOR VANISH?" message, 
  169.         set /C25 (or any other setting) to make it go away.  /C0 clears the 
  170.         screen and puts the cursor at the top of the screen.
  171.        
  172.         /En, n = 65 to 90 (these are the ASCII codes for A-Z), sets the drive, 
  173.         floppy, ram, or hard, where POWERKIT looks for COMMAND.COM when it 
  174.         exits an application program and allows you to load and run another 
  175.         program, format a disk, etc.  COMMAND.COM must be in the "root" dir.
  176.  
  177.         /M)otor off after 1 to 255 tenths seconds.  This command has nothing 
  178.         to do with speeding up floppy disk input or output, it merely allows 
  179.         the computer to turn off the floppy disk drive motor after so many 
  180.         tenths of a second.  I included this command in POWERKIT to let you 
  181.  
  182. Page 4 
  183.  
  184.         get back to work more quickly after a disk access (the keyboard some-
  185.         times won't work while the drive motor is on).  Also, it is not always 
  186.         safe to remove a disk from the drive while the motor is on (stray mag-
  187.         netic fields produced by the motor could garble the data on your 
  188.         disk).  If you tell POWERKIT nothing about motor shutoff, POWERKIT 
  189.         will set it to one second.  /M0 makes POWERKIT ignore motor shut off. 
  190.  
  191.         /Nn, N = 0 or 1, forces shell to DOS to use current active display page 
  192.         (n = 0), or change to a new display page (n = 1).  Also see page 10.
  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 8) 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 8 
  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.         /Tn enables an algorithm that blanks HERCULES brand display adaptors.  
  318.         If you have an Hercules "compatible" adaptor, it probably can be 
  319.         blanked without invoking this command.
  320.  
  321.         /T1 -- Tests for an Hercules adaptor.  If present, enables blanking.
  322.         /T2 -- Activates Hercules blanking without testing first.
  323.  
  324.         /Vn, n = 91 to 255, is the number of timer ticks your machine makes in 
  325.         5 seconds.  The default is 91.
  326.  
  327.         /Xn adjusts the the time it takes repeating keystrokes to get up to 
  328.         top speed, (a speed you can set according to your own taste, see 
  329.         KEYPAD 5, F page 7).
  330.  
  331.         /X0 -- Repeating keystrokes start out at top speed.
  332.         /X1 -- Repeating keystrokes accelerate smoothly, but quickly, to their 
  333.                top speed.
  334.         /X2 -- Repeating keystrokes accelerate rather more slowly than with 
  335.                the /X1 setting.  This is the "default" setting, i.e., this is 
  336.                the acceleration rate you will get if you do nothing.
  337.  
  338.         /Y0 turns off the beep heard when a key is pressed and "PAUSE" (HOLD 
  339.         on a Tandy 1000, SCROLL LOCK on a PC clone) is enabled. 
  340.  
  341.         /Z1 -- Turns on the much louder "system beep" and turns off POWERKIT's.
  342.  
  343. OTHER COMMANDS that may be put on the "PK" command line are:
  344.  
  345.         /D)isplay off 
  346.         /F)ast repeat
  347.         /G)et new HOT key
  348.         /H)ook
  349.         /O)vershoot plan A, B, or C, 0 for A, 1 for B, 2 for C. (used to be /P)
  350.         /P)rinter output to screen, 0 (off) or 1 (on).
  351.         /W)ait before repeating
  352.  
  353.         Note that when defining the HOT key here, the (decimal) scan code of 
  354.         your designated HOT key must be used.  Note also that when HOOK is 
  355.         placed here, and you wish it to be used with /K)eyboard redefine, make 
  356.         sure the CAPS key is ON while your machine is booting up. 
  357.  
  358. COMMANDS ACCESSED BY PRESSING AND RELEASING KEYPAD 5:  What follows are 
  359.         descriptions of the POWERKIT commands accessed from the keyboard.  
  360.         First, the "5" key on the numeric keypad (SHIFT KEYPAD 5 when NUM LOCK 
  361.         is "on") must be pressed, RELEASED, then the indicated COMMAND key 
  362.         pressed and released.  If the command needs more input (numbers or 
  363.         letters), enter them when you hear a beep.  Press ENTER when finished.  
  364.         If you press KEYPAD 5 by accident, press it AGAIN to cancel.
  365.  
  366. Page 7
  367.  
  368. KEYPAD 5, ESC: Sometimes can bring you back to the DOS prompt from a hung or 
  369.         crashed program.  When KEYPAD 5, ESC does succeed, when you have pre-
  370.         cious unsaved data on a ramdisk for example, POWERKIT will have earned 
  371.         its keep. 
  372.         
  373.         NOTE: A few programs have their own escape routines.  If they exist, 
  374.         they are invoked by either CTRL-BREAK or CTRL-C (usually). 
  375.  
  376. KEYPAD 5, W: At the beep, entering a number from 1 to 60, followed by ENTER, 
  377.         will set the delay before keystrokes begin to repeat to that many 
  378.         tenths of a second.  Enter zero if you wish to go back to your old, 
  379.         sluggish keyboard.  But then, POWERKIT tasks associated with KEYPAD 5 
  380.         W, F, S, A, and R will no longer work. 
  381.  
  382. KEYPAD 5, F: At the beep, entering a number from 5 to 255, followed by ENTER, 
  383.         will set the maximum speed a keystroke repeats to that many repeti-
  384.         tions per second, give or take 2 reps./second.  The actual repetition 
  385.         rate will be determined by how fast the application program can handle 
  386.         keystrokes (ANSI.SYS slows the repeat rate, for example).  Enter zero 
  387.         and the keyboard will work like an old-fashioned typewriter keyboard 
  388.         (no auto-repeat, a more comfortable mode for those with disabilities). 
  389.  
  390.         NOTE 1: Use KEYPAD 5, S (see below) for 1 rep./sec, or slower.
  391.  
  392.         NOTE 2: Some repeat speeds are smoother than others.  This is deter-
  393.         mined by the tick rate of the system clock.  For most PC compatibles, 
  394.         5, 10, 19, 37, 55, 74, 92, 110 reps./sec. are the smoothest.  Also, 
  395.         adding 2 or 3 lies/rep. (KEYPAD 5, B, 2 or 3) smooths things out.
  396.  
  397. KEYPAD 5, S: At the beep, entering a number from 1 to 255, followed by ENTER, 
  398.         will repeat a keystroke (or a sequence of keystrokes) every that many 
  399.         seconds.  This is used mainly with AutoPilot (KEYPAD 5, A below).
  400.  
  401. KEYPAD 5, A: Activates AutoPilot. At the beep, enter up to 18 keystrokes that 
  402.         you want repeated, then press ENTER.  If you want an ENTER keystroke 
  403.         to be part of the sequence, press RIGHT SHIFT-ENTER.  After ENTER is 
  404.         pressed, the sequence will repeat, unless CAPS = ON, in which case the 
  405.         sequence will execute only once (but will be saved for possible re-
  406.         use), like an ordinary MACRO.  To stop (and erase) the repeating se-
  407.         quence, press any key.  However, if you want to save this sequence, 
  408.         press the RIGHT SHIFT key, which stops the action and saves the 
  409.         keystroke sequence.  To reactivate AutoPilot (using these keystrokes), 
  410.         press KEYPAD 5, A.  If CAPS = ON as you press, AutoPilot will stop af-
  411.         ter doing the sequence only once.  To erase a keystroke sequence that 
  412.         has been saved by pressing RIGHT SHIFT, without restarting AutoPilot, 
  413.         press KEYPAD 5, RIGHT SHIFT-A. 
  414.  
  415.         NOTE: Because of the peculiar nature of the programs we have dubbed 
  416.         KIM's (page 4, or see KEYPAD 5, H, page 8), there are actually two 
  417.         AutoPilot routines.  Therefore, an AutoPilot sequence that has been 
  418.         defined outside a KIM won't work inside a KIM, and vice versa.  Use 
  419.         KEYPAD 5, A, with CAPS turned ON, to destroy saved keystrokes before 
  420.         "hooking" and entering a KIM, or before leaving a KIM.  PRESSING and 
  421.         RELEASING the CTRL, ALT, or SHIFT keys will count as ONE of the six-
  422.         teen permitted keystrokes while inside a KIM, while these key presses 
  423.         DON'T count against the sixteen when outside a KIM.
  424.  
  425. Page 8
  426.  
  427.         I am certain that AutoPilot will be used in ways I could never dream 
  428.         of.  If you must dump your "KEY" program to load a large application, 
  429.         AutoPilot will be there to restore some of its function by using 
  430.         AutoPilot together with the at least rudimentary MACRO capability 
  431.         most application programs now have.  A single PG DN keystroke can be 
  432.         set to repeat at a comfortable pace, to let you read a document in 
  433.         your word processor without touching the keyboard.  To snoop through 
  434.         the BIOS ROM using DEBUG's UNASSEMBLE command, set the keystrokes to 
  435.         U, and RIGHT SHIFT-ENTER.  When something interesting appears, press 
  436.         RIGHT SHIFT, examine it more closely, then continue snooping with 
  437.         KEYPAD 5, A.  Suppose you would like to eliminate an entire column of 
  438.         a table in one of your applications.  You know the application has a 
  439.         very slick method of doing this, but you can remember only how to 
  440.         eliminate one line of the column at a time.  You can go to the user's 
  441.         manual, or it might be quicker to go to AutoPilot, enter the single 
  442.         line commands, plus a DOWN ARROW keystroke. 
  443.  
  444. KEYPAD 5, R: At the beep, enter A or B.  This sets the "plan" to use to inhib-
  445.         it repeating key overshoot, when inside certain programs.  Plan "A" 
  446.         inserts unusable "null" keystrokes between each "real" keystroke. How-
  447.         ever, some programs are just too smart for their own good and discard 
  448.         these null keystrokes before they can fill its buffer and prevent 
  449.         "run-on".  Hence the need for Plan "B".  Plan "B" tells the program a 
  450.         "little white lie", but it's "for its own good".  It sends a "no key-
  451.         stroke in buffer" report back to the program, several times, before 
  452.         sending the "true" message.  You can use these two plans together.  If 
  453.         CAPS = ON when choosing a plan, the values for the other plan will not 
  454.         be erased.  After entering A or B (after the second beep), enter the 
  455.         number of null keystrokes (or fibs) to insert between each "real" 
  456.         keystroke, then press ENTER. 
  457.         
  458.         You may never use this command.  The majority of programs use the 
  459.         keystroke buffer supported by the BIOS (delineated by the two words at 
  460.         40h:80h).  POWERKIT sees to it that, while a key is repeating, this 
  461.         buffer never contains more than one keystroke. Hence, overshoot is 
  462.         impossible. 
  463.  
  464.         However, KIM's (see pages 4 or 8) and some non-KIM's maintain their 
  465.         own keystroke buffers and couldn't care less that your cursor keeps 
  466.         moving after you release it.  Experiment with combinations of KEYPAD 
  467.         5, F (repeat speed)  and KEYPAD 5, R, A, B, and n.  Overshoot may not 
  468.         be eliminated, but is almost always reduced.  For example, setting 
  469.         KEYPAD 5, F to 92 and KEYPAD 5, R to "A,3" eliminates overshoot in 
  470.         QuickBASIC 3.0, a non-KIM which, nevertheless, keeps its own 8 key-
  471.         stroke buffer.  Setting KEYPAD 5, F to 37 and KEYPAD 5, R to "A,5" 
  472.         only reduces overshoot in QuickBASIC 2.0, a KIM which must be "hooked" 
  473.         (see page 8), and which keeps a 16 keystroke buffer.  BRIEF (v2.01) 
  474.         works fine with POWERKIT's default setting (2 fibs, 0 nulls), but on 
  475.         slower machines, your cursor will move faster using 1 null, 0 fibs. 
  476.  
  477.         NOTE: Some programs object mightily to the null keystrokes Plan A uses 
  478.         to control overshoot.  PC-Write (and LIST), for example, sounds like a 
  479.         moonstruck cricket when nulls are set to greater than zero.  These 
  480.         plans may also be used to make repeats look smoother. 
  481.  
  482. KEYPAD 5, H: The HOOK command is designed to outwit those application programs 
  483.         I call Keyboard Interrupt Monopolizers, or KIM's for short.  You prob-
  484.  
  485. Page 9
  486.  
  487.         ably have a KIM in your library. It's a program such that after you 
  488.         load it, your favorite pop-up utilities won't work until you exit it.  
  489.         Activate HOOK just before you load the KIM.  If you hear a beep when 
  490.         the KIM starts to execute, then HOOK probably has intercepted the pro-
  491.         gram successfully and your pop-ups (including POWERKIT) should work. 
  492.         Deactivate HOOK after you leave the KIM by entering KEYPAD 5, H again.  
  493.         No beep this time. 
  494.  
  495.         FOR ADVANCED USERS: If CAPS LOCK is ON when you invoke HOOK, the KIM 
  496.         will be fed SCAN CODES determined from the table developed from data 
  497.         entered with the /K)eyboard redefine command.  See page 4 for a dis-
  498.         cussion of this command. This solves most of the problems many KIM's 
  499.         have with keyboards possessing more than the standard 83 "PC" keys. 
  500.         Some keyboards omit either the "make" or "break" signal when the 
  501.         lights (called LED's) in the CAPS or NUM LOCK keys are turned off or 
  502.         on.  These keys will still have to be pressed four times to put them 
  503.         through a complete cycle (while inside a KIM).
  504.  
  505.         SAD NOTE 1: No "keyboard macro" program (these programs usually have 
  506.         "KEY" somewhere in their name) that I am aware of will work inside a 
  507.         KIM, even a "hooked" KIM.  AutoPilot produces a (repeating) keyboard 
  508.         macro and that is why two separate AutoPilot routines were necessary.
  509.  
  510.         SAD NOTE 2: POWERKIT will not "hook" some KIM's.  These are KIM's that 
  511.         do not use DOS services to attach themselves to interrupts.  Also, 
  512.         hooking a non-KIM will sometimes hang the machine.
  513.  
  514.         QuickBASIC APPLICATIONS: Programs compiled with any QuickBASIC 
  515.         compiler, and which use the ON KEY command, must be "hooked" before 
  516.         pop-up utilities will work properly. 
  517.  
  518. KEYPAD 5, V: Opens (and closes) a view-port into the keystroke buffer.  Your 
  519.         most used applications probably have become so familiar to you, you 
  520.         know long beforehand what comes next and what you want to do about it.  
  521.         However, distractions occur and you can "lose your place" while typing 
  522.         "blind" into the keystroke buffer.  At these times a view-port is use-
  523.         ful. The view-port expands and contracts according to how many unused 
  524.         keystrokes are left in the buffer.  Reenter the command to close the 
  525.         view-port. 
  526.  
  527. KEYPAD 5, L: Lets you blank the screen and lock up the keyboard.  After 
  528.         pressing KEYPAD 5, L, the screen will blank (if you haven't disabled 
  529.         blanking).  At the beep, just press ENTER if you want no password pro-
  530.         tection, or enter up to a four keystroke password, then press ENTER.  
  531.         To get your machine back, PRESS and RELEASE the RIGHT SHIFT key and 
  532.         reenter the password.  Incidentally, your machine will go on computing 
  533.         while locked, if no keyboard input is needed. 
  534.  
  535. KEYPAD 5, D: At the beep, entering a number from 1 to 60, followed by ENTER, 
  536.         sets the display to turn off after one to sixty minutes of keyboard 
  537.         inactivity.  KEYPAD 5, D, 0 disables screen blanking.  Blanking is im-
  538.         portant for monochrome displays, to preserve their phosphor coatings.  
  539.         POWERKIT's default setting is screen blanking DISABLED.  See page 6, 
  540.         /Tn, for instructions on enabling Hercules brand MGA card blanking. 
  541.  
  542. KEYPAD 5, G:  At the beep, press the key you wish to use to signal POWERKIT.  
  543.         Some call this a HOT key.  Use KEYPAD 5, G before you load a program 
  544.         to which KEYPAD 5 means something.  The keys LEFT and RIGHT SHIFT, 
  545.  
  546. Page 10
  547.  
  548.         CTRL, ALT, CAPS, NUM LOCK, and HOLD won't work as HOT keys.  Also, if 
  549.         NUM LOCK is ON, you must hold SHIFT, then press the HOT key.
  550.  
  551. KEYPAD 5, P: Directs output normally destined for the printer, to the screen.  
  552.         This is handy when no printer is available and you must use a program 
  553.         that demands a printer be attached (when you are using a PC compatible 
  554.         laptop away from the office, for instance).  It also lets you preview 
  555.         the formatting of a document without wasting a lot of time and paper, 
  556.         if you don't have a WYSIWYG (what you see is what you get) text edi-
  557.         tor. Pressing KEYPAD 5, P a second time turns off this feature. 
  558.  
  559.         NOTE: I always boot up with /P1 on the "PK" command line (see below). 
  560.  
  561. KEYPAD 5, E: Exits an application program, and puts you at the DOS prompt.  
  562.         There, you can perhaps do some little thing that you forgot to do 
  563.         before you entered the application (like format a new disk if the disk 
  564.         you are using is full, and the application wants to write more data).  
  565.         To return to the application, type "exit" at a DOS prompt.  If you 
  566.         have a graphics adaptor (CGA, EGA, etc.), POWERKIT exits to a different 
  567.         display page, so as not to mess up your screen.  With a single page 
  568.         adaptor (MDA), there is no choice, sorry.  However, a less confusing 
  569.         display will result if you place the cursor at the bottom of the screen 
  570.         prior to exiting to DOS.  See also the switch, /N on page 4.
  571.         
  572.         POWERKIT has to find COMMAND.COM in order to do this little trick, and 
  573.         it is not very smart, it looks for COMMAND.COM only in a "root" direc-
  574.         tory (the directory you are in when you type "B:", say, at the DOS 
  575.         prompt).  The default is the "root" directory on drive "A", but you can 
  576.         change this drive at bootup with the "/E" switch (see page 3).  CAUTION:  
  577.         Don't shell to DOS at the DOS prompt, and especially, NOT at bootup. 
  578.  
  579. ATTRIBUTES of the HOLD and PrtSc keys: The two most dangerous keys on your 
  580.         keyboard are PrtSc (also called PRINT) and HOLD (this key sometimes 
  581.         labeled PAUSE or SCROLL LOCK).  If you happen to press SHIFT PrtSc 
  582.         (PrtSC sometimes) with no printer attached nor KEYPAD 5, P activated, 
  583.         your machine could go to sleep for quite some time ("MODE LPT1: SHORT" 
  584.         helps some).  Therefore, it's best to keep KEYPAD 5, P "on" all the 
  585.         time (except when you are using the printer). 
  586.  
  587.         On many machines, pressing the HOLD key freezes the display until you 
  588.         press HOLD again.  If you unknowingly press HOLD, you might press a 
  589.         few other keys before you press HOLD again, and those extra keystrokes 
  590.         could end up where you don't want them.  Now, a beep will let you know 
  591.         HOLD has frozen the display.  Press HOLD again to return to normal. If 
  592.         you didn't happen to hear the beep, you can escape with KEYPAD 5, ESC. 
  593.  
  594. CONFLICTS WITH OTHER PROGRAMS: Other times when POWERKIT and other TSR's or 
  595.         application programs don't work well together occur because the other 
  596.         program is trying to do some of the same things POWERKIT is doing, 
  597.         such things as enlarging the keystroke buffer, blanking the screen, or 
  598.         speeding up the cursor.  When this happens, disable the contested 
  599.         function, either in POWERKIT or in the other program (in the case of 
  600.         POWERKIT's extended keystroke buffer, simply don't enable it). 
  601.  
  602.         Finally, you must change POWERKIT's HOT key if it means something to 
  603.         the other program. 
  604.  
  605. Page 11
  606.  
  607. 101 KEY ENHANCED KEYBOARDS: I have completely rewritten POWERKIT's keyboard 
  608.         handler to make it compatible with most (90%) 101 key keyboards. How-
  609.         ever, if it doesn't work with yours and you would like it to, there is 
  610.         a 101 key enhanced keyboard driver (about 2k bytes) that WORKS with 
  611.         POWERKIT, included in this package. 
  612.  
  613. ONLINE SUPPORT FOR POWERKIT: If you have a modem, you can get prompt answers 
  614.         to your questions (several times a day), and download some interesting 
  615.         files by contacting me on the King's Bench BBS.  There is a POWERKIT 
  616.         support area on this BBS of the Compatible Computer Information 
  617.         Exchange.  The phone number is: (303) 377-6725.  You need not be a 
  618.         registered user to use this service. 
  619.  
  620. That's it, you're on your own.  Enjoy POWERKIT and please don't forget to send 
  621.     $9.95*. 
  622.  
  623. *   Introductory offer, price subject to change.
  624.  
  625.                                  CENTRAL DATA SERVICES
  626.                                    1641 WINONA COURT
  627.                                    DENVER, CO 80204
  628.                                     (303) 595-4218
  629.                                       or 595-4074
  630.  
  631.  
  632.  
  633.