home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 575.lha / MenuKey_v1.0 / MenuKey.doc.pp / MenuKey.doc
Encoding:
Text File  |  1991-12-05  |  4.2 KB  |  80 lines
  1. Documentation for MenuKey 1.0
  2.  
  3. Written by Mark Thomas
  4. Copyright © 1991 by Mark Thomas.
  5. All rights reserved.
  6.  
  7. This program is freely distributable.
  8.  
  9. Purpose:
  10.  
  11.      MenuKey was written as a response to a couple of my co-workers at New
  12. Horizons Software, Inc. and as an extension on an idea expressed in CygnusEd
  13. Professional.  It is an attempt to get more use out of the Left Amiga key.
  14. The role that CygnusEd plays in this is that within CygnusEd you can use
  15. either Amiga key for the menu key equivalents.  This is not supported by
  16. Commodore as only the Right Amiga key is to be used for menu equivalents.
  17. Also, a couple of people as work wanted to be able to cut, copy, and paste
  18. from either Amiga key.  With these two things in mind, and a determination
  19. to be compatible with the system, I designed this 2.0 Commodity.
  20.  
  21. Requirements:
  22.  
  23.      Any Amiga computer running AmigaDOS 2.0.
  24.  
  25. Functionality:
  26.  
  27.      MenuKey is a commodity that simply waits for the Left Amiga key to be
  28. pressed in combination with some keyboard key, at which time, it changes the
  29. Left Amiga qualifier to a Right Amiga qualifier.  There are exceptions to this
  30. rule, for compatibility reasons.  First, if that keyboard key happens to be a
  31. system key then the qualifier is left alone.  The system keys are the four
  32. keys that when hit in combination with the Left Amiga key, do one of four
  33. things: Retry on a requester (usually V), Cancel a on requester (usually B),
  34. Flip to Workbench Screen (usually N), and Flip to next screen (usually M).
  35. Menu key does read in from preferences what the real equivalents are for these
  36. keys, when it starts up.  I had originally intended for MenuKey to
  37. automagically adjust to new key settings when preferences is changed, but I
  38. am having a little trouble finding the right magic to do that.  So, the system
  39. keys are read in when the program is first executed, and only when the program
  40. is first executed.  If preferences are changed, MenuKey will have to be killed
  41. and then restarted in order to recognize the new preference settings of the
  42. system keys.  I will try to fix this in a later version.
  43.  
  44.      Also of importance for persons worried about key bindings involving the
  45. Left Amiga key in combination with other qualifiers, such as CTRL, SHIFT,
  46. ALT, and others, if MenuKey detects that another qualifier key is being held
  47. down in combination with the Left Amiga key, then the Left Amiga key will
  48. still be the Left Amiga key.
  49.  
  50.      NewShellCX, Mach II and III, and other utilities users, here is a
  51. warning.  Left Amiga and ESC together will get remapped by MenuKey.  Some
  52. programs use this key combination to open a new shell for you.  Here is the
  53. good news: you can use MenuKey and these programs together just fine.  Here's
  54. what to do.  For a program like NewShellCX that is another commodity, all you
  55. have to do to get NewShellCX to recognize Left Amiga - ESC is to run it first,
  56. then run MenuKey.  If you put NewShellCX and MenuKey in your WBStartup drawer,
  57. the easiest way to get one to run before another is to use the STARTPRI
  58. tooltype.  Put 'STARTPRI=1' in the tooltypes of NewShellCX and 'STARTPRI=0' in
  59. the tooltypes of MenuKey.
  60.      Another option that works just as well for commodities as for other non-
  61. commodity programs is to use the CX_PRIORITY tooltype.  This tooltype allows
  62. you to change at which point MenuKey 'sees' an input event.  I don't know, but
  63. say that Mach II has it's input handler at a priority of 15, then just running
  64. MenuKey and specifying no priority will suffice as the default priority for
  65. MenuKey is 0.  However, say that Mach II was at a priority of 0, then either
  66. run Mach II before you run MenuKey, or add 'CX_PRIORITY=-1' to the tooltypes
  67. of MenuKey.  Also, remember that when running other commodities, the
  68. CX_PRIORITY tooltype will override the STARTPRI tooltype.  None of the above
  69. on Mach II has been tested, but it is my belief that it will work as stated.
  70. If not, sorry, no guarantes.  Also, if it doesn't work, let me know and I'll
  71. change the documentation.  The information on NewShellCX, however, does work
  72. fine, as I have that and use it.
  73.  
  74.  
  75. Where to reach me:
  76. Internet: amigamat@ccwf.cc.utexas.edu
  77. GEnie   : M.THOMAS24
  78. USMail  : Mark Thomas
  79.           2005 Willow Creek Dr. #2117
  80.           Austin, Texas  78741