home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / news / 4569 / goodies8 / programr / xpndr.doc < prev   
Text File  |  1993-02-18  |  5KB  |  118 lines
  1. (Comp.sys.hp48)
  2. Item: 2434 by fee@waikato.ac.nz [Conan J. Fee]
  3. Subj: XPNDR - A menu & softkey expander util
  4. Date: 21 Dec 1992
  5.  
  6. Hello all.
  7.  
  8. Here is a Christmas present - a utility which I just finished developing
  9. (with the help of Detlef Muller). Basically, as the attached documentation
  10. shows, it is a utility for expanding the current menu and providing more
  11. than the standard 6 menu softkeys (up to 36, to be exact). It is VERY
  12. simple to operate (self-explanatory) and doesn't take up much room. Try it.
  13.  
  14. I posted this to comp.sources.hp48 but that newsgroup is empty right
  15. now, and there is no indication as to when it will be updated.
  16.  
  17. Enjoy.
  18.  
  19. Regards, 
  20. Conan.
  21.  
  22. [Note: Also see XMENU for an alternate approach.  -jkh-]
  23.  
  24. ---------------------------
  25. Begin XPNDR.DOC                       
  26.                                 XPNDR v1.0
  27.                                     by
  28.                                 Conan J. Fee                          
  29.                         University of Waikato, Hamilton,
  30.                                 New Zealand.                          
  31.                         email: fee@waikato.ac.nz  
  32.  
  33. DESCRIPTION:  XPNDR version 1.0 is a utility which shows all pages of
  34. the current menu on screen at once  and allows you to choose any of
  35. the menu functions by pressing a key ie: you now have up to  six rows
  36. of softkeys, not just the first row.
  37.  
  38. If you have ever had to search through several pages of an unfamiliar
  39. menu in search of the command you want, not known whether to press NXT
  40. or PREV to get the menu page you want, or not known whether the
  41. programming command you seek is in the TEST, BRANCH or CONTROL menu,
  42. let alone which page, then XPNDR is for you!
  43.  
  44. OPERATION:  Assign XPNDR to a user key (I use BLUE-NXT) and then
  45. whenever you execute XPNDR,  you will see all pages (six pages
  46. maximum) of the current menu, whether it is a library, a user
  47. directory or a built-in menu such as the MTH menu, shown on screen at
  48. once.
  49.  
  50. The first four rows of keys then act as softkeys for the corresponding
  51. functions.  If the menu has more than 4 pages (this is rare for
  52. built-in menus, but try it with the STATS  menu), on-screen
  53. instructions tell you what to do.  If you press a key that doesn't
  54. correspond to a function - no problem. XPNDR quits without  taking
  55. action.  XPNDR not only executes the function shown but works as a
  56. typing aid and works with all  shift planes.
  57.  
  58. Try it to convert units, to recall a variable's contents or to store an 
  59. object in a  user-variable. ie: it works the same as softkeys. 
  60.  
  61. It's that simple!  
  62.  
  63. INSTALLATION:  
  64. 1. Download XPNDR to your HP48.
  65. 2. Store the resulting directory wherever you like.
  66. 3. Enter the directory, recall the contents of XPNDR to the stack and store
  67.         it as XPNDR in the  home directory. 
  68. 4. Recall (don't evaluate) the contents of SETUP to the stack - you
  69.         should get the name  XPNDR on the stack. 
  70. 5. Assign the result of 4, above, to whatever key you like (I think BLUE-NXT
  71.         is a pretty  logical choice). 
  72. 6. Purge everything except the copy of XPNDR in the home directory.
  73.  
  74. Away you go!  
  75.  
  76. NOTE: Please use SETUP to put the name XPNDR on the stack for assigning to 
  77. a key -  merely entering the name 'XPNDR' from the keyboard will not 
  78. allow XPNDR to function  correctly. (The contents of SETUP are actually
  79. a sys_RPL routine with source code  comprised of :: TakeOver ID XPNDR ;) 
  80.  
  81. ACKNOWLEDGEMENT:  Thanks VERY much to Detlef Muller for his absolutely 
  82. invaluable help and suggestions in  working out this routine. Detlef - 
  83. you're a marvel!  
  84.  
  85. SUGGESTIONS: You'll notice the routine is a little slow (but still faster 
  86. than searching individual menu pages), especially for more than 4 menu pages. 
  87. This is virtually unavoidable for sys_RPL, since the menu grobs are not 
  88. stored internally but must be redrawn each time a new menu page is 
  89. displayed.  
  90.  
  91. Anyone who is a machine-code ace can probably speed this up a bit. 
  92. Feel free to do this and  please let me have a copy.  
  93.  
  94. The maximum number of menu pages is six - this is because the routine 
  95. would get  cumbersome, large, slow and require more interaction from the 
  96. user to get more than this number of functions on-screen at once. I 
  97. don't think the extra complexity is worth it for the  very few menus that 
  98. might have more than six pages. If you disagree, you are welcome to  modify 
  99. the routine. Just let me know if you do. 
  100.  
  101. DISCLAIMER:  This routine is provided free and without any warantee
  102. whatsoever.
  103.  
  104. You don't have to use this  and I don't want to be sued for providing 
  105. freeware!!! (On the other hand, if you're the litigious  type and you're 
  106. really bent on suing me despite this disclaimer, go ahead - you're welcome 
  107. to  take over every cent of my substantial overdraft.) 
  108.  
  109. REPORT: Bugs, comments and suggestions to me via email:fee@waikato.ac.nz
  110.  
  111.  
  112. -----------------------------------------------------------------
  113. Conan J. Fee                        _      fee@waikato.ac.nz
  114. Centre for Technology              (_)o    
  115. University of Waikato, Hamilton    /\  \   Phone: +(64)(7)8384206
  116. Private Bag 3105, New Zealand              Fax:   +(64)(7)8384324
  117. -----------------------------------------------------------------
  118.