home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / willutil / willutil.doc < prev    next >
Encoding:
Text File  |  1993-10-04  |  7.6 KB  |  155 lines
  1. What is WILLUTIL?
  2. =================
  3.   WILLUTIL grew out of extensions to NumLock for OS/2, a shareware program
  4. I released a little while back.  NumLock was a pair of programs (one for DOS
  5. and one for OS/2 2.x) to overcome the annoying habit that OS/2 has of turning
  6. the NUMLOCK key off.  WILLUTIL contains all of the functionality of NumLock,
  7. but so much more that I had to change the name.  WILLUTIL is now the current
  8. version, available as a free upgrade to registered users of NumLock, and should
  9. replace any previous version of NumLock.  Development of NumLock as a separate
  10. program will be discontinued.
  11.  
  12.   WILLUTIL will let you customize many characteristics of OS/2, including
  13. window scrolling, system beeps (great for those without soundcards), menu
  14. operation, etc.
  15.   There are two executable programs in the shareware release of WILLUTIL,
  16. namely WILLUTIL.EXE and NUMLOCK.EXE.
  17.  
  18. Usage
  19. =================
  20.  
  21.   NUMLOCK.EXE remains from the previous release of NumLock.  It is a DOS
  22. executable to alter the state of the NUMLOCK key in a DOS session.  It
  23. has the syntax:  NUMLOCK on|off    The usage should be apparent.  It may
  24. be placed in your AUTOEXEC.BAT file as "NUMLOCK ON" and will effectively relieve
  25. the NUMLOCK problem as it pertains to DOS sessions.
  26.  
  27.   WILLUTIL.EXE is the main executable for OS/2.  It is a command-line utility
  28. that you control through command-line arguments.  As with NUMLOCK.EXE, once
  29. execution terminates, the code is cleared from memory.
  30.  
  31.   With the exception of the argument "help" all the functions of WILLUTIL take
  32. two arguments, in the form of a keyword and a value.  WILLUTIL is not case-
  33. sensitive.  The keyword specifies the function to be altered, the value
  34. specifies the amount.  All values are non-negative.
  35.  
  36.   For example, the keyword "ScrollDelay" sets the delay between clicking on
  37. a scrollbar and when autoscrolling begins.  Its argument is in milliseconds.
  38. So, to set the ScrollDelay to 500ms (1/2 second), you would execute:
  39.    WILLUTIL ScrollDelay 500
  40. This would set a 500ms delay before scrolling begins.  This would allow you
  41. to easily advance one row at a time.  Conversely, executing:
  42.    WILLUTIL ScrollDelay 0
  43. would allow scrolling to begin as soon as the scroll button is depressed.
  44.  
  45.   The "Numlock" option also takes an argument, 0 for off or 1 for on, such that:
  46.    WILLUTIL Numlock 1
  47. turns the NUMLOCK key on.
  48.  
  49. A complete list of options follows:
  50.  
  51. KEYWORD             VALUE          DESCRIPTION
  52. ===============================================================================
  53. Numlock             0 or 1         0 turns NUMLOCK off, 1 turns it on
  54. MenuShowDelay       milliseconds   The delay (for ALL cascading-menus) between
  55.                                    moving a depressed pointer onto the menu
  56.                                    name and the menu expanding.  A value of 0
  57.                                    restores the default PM menu activity.
  58. MenuHideDelay       milliseconds   Delay between moving a depressed pointer off
  59.                                    a cascaded menu and the menu rolling up.
  60. BlinkRate           milliseconds   The delay between PM cursor blinks.
  61. ScrollDelay         milliseconds   Delay between pressing a scroll button and
  62.                                    when autoscrolling begins.  A value of 0
  63.                                    means scrolling begins immediately.
  64. ScrollSpeed         milliseconds   The delay between PM-requested scroll
  65.                                    updates.  Larger values give slower
  66.                                    scrolling.  A value of 0 means PM requests
  67.                                    the application to scroll as fast as it can.
  68.                                    Note: different applications may have
  69.                                    different maximum scrolling speeds.
  70. WarningFreq         Hertz          The frequency for the PM warning beep.
  71. WarningDuration     milliseconds   Duration for the PM warning beep.
  72. NoteFreq            Hertz          Frequency for PM note beep.
  73. NoteDuration        milliseconds   Duration for PM note beep.
  74. ErrorFreq           Hertz          Frequency for PM error beep.
  75. Error Duration      milliseconds   Duration for PM error beep.
  76. Help                               Display help screen.
  77.  
  78. You should experiment a little to decide how you prefer the various values set.
  79. Don't be concerned about "messing up" OS/2 by changing these parameters.
  80.  
  81. WILLUTIL can be placed in your STARTUP.CMD file so that when you boot your
  82. system, PM is configured to your preferences (Especially that NUMLOCK key!)
  83. If you use 4OS2, you can place "WILLUTIL Numlock 1" in your 4START.BTM file
  84. so that the NUMLOCK key is on in all your full-screen OS/2 sessions, as well.
  85.  
  86.  
  87. REGISTRATION
  88. ========================
  89.  
  90.   WILLUTIL is being distributed as shareware. This means you are licensed to
  91. use it for a 14 day trial period without charge.  If you find it useful and
  92. would like to continue using it beyond the trial period, you must register
  93. the software.
  94.  
  95.   Registering the software has a number of advantages.  When you register,
  96. you will be sent the registered, enhanced version of WILLUTIL.  In addition
  97. to being faster and quieter, the registered version of WILLUTIL has the
  98. following enhancements:
  99.  
  100.   o  The registered version can use an INI file to retrieve your custom
  101.      all in one fell swoop.  No more running the program 3 or 4 times, typing
  102.      in the arguments each time.  Also much faster than a batch file.
  103.  
  104.   o  Due to the way OS/2 handles multiple sessions, current methods (including
  105.      Numlock for OS/2 and WILLUTIL) for controlling the NUMLOCK key may
  106.      occasionally exhibit a problem: the state of the key and the LED may
  107.      become desynchronized (i.e. NUMLOCK is on, but the LED is off).
  108.  
  109.      Well, no longer!  The registered version of WILLUTIL comes with a
  110.      companion program, numlockd.exe.  Yes, a NUMLOCK DAEMON!  NUMLOCKD will
  111.      keep your NUMLOCK key on and synchronized, no matter what.  If OS/2
  112.      turns it off, NUMLOCKD turns it back on.  It uses only 6KB of RAM, runs
  113.      transparently in the background, and won't interfere with screensavers or
  114.      seamless-WINOS2 operation.
  115.  
  116.      This represents the STATE OF THE ART in NUMLOCK TECHNOLOGY !!
  117.      Don't be fooled by imitations.  Available only to registered users!
  118.  
  119.  
  120.   Because the demand for an advanced NUMLOCK solution is so high, the price
  121. for registration can be very low.
  122.  
  123.   Registration is available in two different options:
  124.  
  125. For US$5.00, you can get the registered WILLUTIL for OS/2 package, including
  126. NUMLOCK for DOS and the NUMLOCK DAEMON, delivered to you electronically.
  127. This option is of course only available if you can receive electronic mail
  128. from the internet.  (You can on CompuServe.)  This also requires you to
  129. use UUDECODE to extract the software from you mail.
  130.  
  131. For US$7.00, you can get a disk containing the complete WILLUTIL package,
  132. including the NUMLOCK DAEMON, and the DOS executable, as well as some
  133. additional utilities and some nice OS/2 background bitmaps, if there's space.
  134.  
  135.  
  136. With either registration, you are entitled to free (excluding postage, if
  137. necessary) future updates and bug fixes to the complete WILLUTIL package,
  138. in perpetuity.  One call does it all.
  139.  
  140. To register, send the appropriate fee, along with the necessary shipping
  141. information to:
  142.  
  143.   Will E. Rose
  144.   Software Registration
  145.   1218 Leith Ave.
  146.   Waukegan, IL  60085
  147.   USA
  148.  
  149. If you have questions of comments about any part of this package, please feel
  150. free to contact me.
  151.  
  152. I can be reached by email as    wer5@midway.uchicago.edu
  153.  
  154.  
  155.