home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-1.iso / Files / Util / F / FunKey.sit / FunKey Docs next >
Encoding:
Text File  |  1990-01-11  |  3.8 KB  |  93 lines  |  [TEXT/KAHL]
  1. /*
  2.  
  3. FunKey 0.1
  4.  
  5. by Alex D. Chaffee
  6.     chaffee@reed.uucp
  7.     Compuserve: 71210,1117
  8.     Reed College Box 259, Portland, OR 97202
  9.     
  10. Copyright © 1990.  All Rights Reserved.  Permission is granted to
  11. distribute freely, as long as this document and copyright information
  12. remain intact and are distributed along with the program.
  13.  
  14. FunKey is a replacement for Carlos Weber's old (but excellent) Pop-Keys 
  15. INIT.  Like Pop-Keys, it allows you to pull up a popup menu from which 
  16. you can select  any installed FKEYs.  Unlike Pop-Keys, the menu is not 
  17. selected by moving to a part of the screen.  Instead, when you hold down 
  18. the familiar Command and Shift keys, FunKeys changes the pointer to its 
  19. own "F" cursor.  The menu pops up when you click the mouse button.  FunKey 
  20. also overcomes some bugs and shortcomings of Pop-Keys.
  21.  
  22. Installation:
  23.     FunKey is a standard INIT, complete with startup icon.  To install it,
  24.     simply drag it into the system folder and reboot.  If you hold down
  25.     the mouse button during startup, FunKey will not install.
  26.  
  27. Usage:
  28.     Like the man said - hold down Command and Shift at any point after
  29.     startup, and you will see the Funky Cursor.  You can then select a
  30.     function key the normal way - by pressing a number from zero to nine -
  31.     or the Funky way - by holding down the mouse button.  A menu will
  32.     appear, containing the names and ID#s of all FKEYs in the system
  33.     folder, installed with Suitcase or the like, and in any open files.  
  34.     Selecting an FKEY from the menu will activate it, just as if you had 
  35.     pressed the associated key.  The FKEYs which are installed on the 
  36.     keyboard are denoted by command-key equivalents (although pressing 
  37.     these keys while the menu is up won't do anything).  FKEYs with no 
  38.     name are named "Untitled."
  39.     In the "About Box" is a checkbox allowing you to select whether or
  40.     not you'd like to see the ID numbers in the menu.  Untitled FKEYs will
  41.     always show their numbers, so that you can tell them apart.  (It's
  42.     not a bug...)
  43.     
  44. Known Bugs and Limitations:
  45.  
  46. •    FunKey doesn't work quite right under MultiFinder: if you click above
  47.     a window that's not in the current layer, the menu will work all
  48.     right, but before it comes up or after it goes away, MultiFinder will 
  49.     *sometimes* switch layers.  (Note that normally, the mouse clicks are 
  50.     invisible to the  current application -- but keystrokes are revceived
  51.     by the application, to accomodate the Cmd-Shift menu items of 
  52.     some applications.)
  53.  
  54. •    If you have a lot of FKEYs installed, it may take a second or two
  55.     for the menu to come up after you click the mouse.  I'm working on
  56.     a way to make it faster, but it may be more trouble than it's worth...
  57.     If you find that it's unusable at its present speed, let me know
  58.     and I'll be more motivated to fix it.
  59.  
  60. Wish List:
  61.  
  62. •    Make it a CDEV, or at least add a better "Configure" item
  63. •    Allow for user-configurable "hot" keys (other than Command-Shift)
  64. •    "Open" command
  65. •    Sort by name or number
  66. •    Add a "hot rect" feature like Pop-Keys
  67. •    "Where Is" function - to show the file a given FKEY is from
  68. •    ...Suggestions?
  69.  
  70. Technical Info:
  71.  
  72. FunKey patches the low-memory global jGNEFilter to install its own
  73. GetNextEvent filtering routine.  This routine checks GetKeys to set the
  74. cursor, then if the event is a mouseDown, pops the menu.  FunKey also 
  75. patches SetCursor and InitCursor so that the Funky Cursor isn't changed 
  76. while Command and Shift are down.
  77.  
  78. A Request:
  79.     
  80.     I am not asking for any remuneration for FunKey, other than the
  81.     following:  if you like it, if you find a bug, if you have any
  82.     suggestions or gripes, or if you want to say "Hi," please let me know.  
  83.     I'm not in this for the money (at least not yet), only for the 
  84.     satisfaction of knowing that my (enjoyable) efforts have also been
  85.     enjoyed by others.
  86.  
  87. Version History:
  88.  
  89. 10/89    Prototype written
  90. 1/90    After finals and break, version 0.1 is ready to roll
  91.  
  92. */
  93.