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