home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / amigalib / d983 / capslockext.lha / CapsLockExt / CapsLockExtender.doc < prev    next >
Encoding:
Text File  |  1994-04-05  |  3.5 KB  |  75 lines
  1.  
  2.                               CapsLockExtender
  3.                                 Version  1.0
  4.  
  5. WHAT IT DOES
  6. °°°°°°°°°°°°
  7.      CapsLockExtender is a Commodity with two actions.  First, it extends
  8. the action of the CapsLock to every key on the keyboard, including the arrow
  9. keys, the function keys, backspace, Del, and the numeric keypad.  Second, it
  10. allows the user to temporarily cancel the action of CapsLock by holding down
  11. either SHIFT key.  This causes CapsLock to act like a SHIFT-lock key on a
  12. typewriter.  CapsLockExtender requires AmigaDOS 2.04 or higher.
  13.  
  14. USAGE
  15. °°°°°
  16.      From the Shell, CapsLockExtender has this usage:
  17.  
  18.           Format:  CapsLockExtender [CX_PRIORITY=] [NOKEYPAD] [HOT]
  19.           Template:  CX_PRIORITY/K/N, NOKEYPAD/S, HOT/S
  20.  
  21.      [CX_PRIORITY=] is the usual Commodities priority.  I suggest you keep
  22. this low to avoid any problems with programs that use HotKeys (unless you
  23. are using the HOT option).  The default value is zero.
  24.  
  25.       [NOKEYPAD] causes CapsLockExtender to ignore keys in the numeric
  26. keypad, so they are not SHIFTed when CapsLock is on.  Most programs treat
  27. SHIFTed keypad keys identically to unSHIFTed ones, so this option has little
  28. use.  However, if you have a program that responds differently to SHIFTed
  29. keypad keys, you may want to use this.
  30.  
  31.       [HOT] requires a little technical explanation.  When you press a key
  32. on the keyboard, the system generates an InputEvent that records which key
  33. was pressed and also which qualifier keys (such as SHIFT, Alt, CapsLock,
  34. etc.) were down.  In default mode, when CapsLockExtender finds an InputEvent
  35. in which CapsLock is on and SHIFT is not, it alters the InputEvent to
  36. indicate that CapsLock is on and the left SHIFT key is down.  In HOT mode,
  37. it alters the InputEvent to indicate that the left SHIFT key is down and
  38. CapsLock is not on.
  39.      Most programs will treat these two different InputEvents identically.
  40. The exception is a program that uses a HotKey.  Let us take the system
  41. Commodity Blanker as an example.  It uses SHIFT-f1 as a HotKey that causes
  42. it to open its control window.  Consider what happens if you run
  43. CapsLockExtender, turn CapsLock on, and press f1.  When CapsLockExtender is
  44. in default mode, Blanker will see an InputEvent with the qualifiers
  45. left-SHIFT and CapsLock, and it will NOT open its window.  Blanker is
  46. looking for a specific qualifier for its HotKey, and the presence of the
  47. CapsLock qualifier means that this InputEvent does not meet the
  48. specification.  On the other hand, if CapsLockExtender is in HOT mode, then
  49. Blanker will see an InputEvent with just the left-SHIFT qualifier, and it
  50. WILL open its window.
  51.      So, if you want the CapsLock key treated as the equivalent of a SHIFT
  52. key for HotKey programs, then run CapsLockExtender in HOT mode.  You will
  53. also need to set CapsLockExtender's CX_PRIORITY higher than the CX_PRIORITY
  54. of the HotKey programs.
  55.  
  56.      To run CapsLockExtender from the Workbench, just double-click its icon.
  57. It uses the ToolTypes CX_PRIORITY=, NOKEYPAD, and HOT, which are the same as
  58. the Shell options.  As usual, if you put CapsLockExtender in the WBStartup
  59. drawer, remember to use the ToolType DONOTWAIT.
  60.  
  61.      To kill CapsLockExtender, either run it again, or use the Exchange
  62. program, or send it a CTRL-C or CTRL-E.
  63.  
  64. HERE'S LOOKING AT YOU, KID
  65. °°°°°°°°°°°°°°°°°°°°°°°°°°
  66.      Send your comments and complaints to
  67.  
  68.           Douglas Nelson
  69.           2006 N. 49 Avenue
  70.           Omaha NE 68104
  71.           USA
  72.  
  73. By the way, this program is freely distributable, for your dining and
  74. dancing pleasure.
  75.