home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / sysutl / pkii_112.arc / MENU.DOC < prev    next >
Text File  |  1989-02-05  |  5KB  |  77 lines
  1. MENU MODULE DOCUMENTATION
  2.  
  3. There's not a whole lot to be said about the MENU module.  What it does is self 
  4. evident.  However, it presents a good example of the power of module format 
  5. programming.  MENU.MOD is a "workalike" to SlashBar, a fine little program 
  6. written by Robert L. Hummel, that appeared in PC Magazine, Vol. 6, No. 10.  To 
  7. do its thing, MENU.MOD uses 982 bytes, plus the buffers used to save the menu 
  8. file, incoming keystrokes, etc.  To do almost the same thing, SlashBar uses 
  9. 2024 bytes, plus the buffers, plus a 256 byte Program Segment Prefix, plus from 
  10. 160 to 32,767 bytes of environment space! 
  11.  
  12. However, MENU.MOD can do things SlashBar cannot do.  It can process "extended" 
  13. ASCII codes and can change menu files "on the fly" (you've probably seen your 
  14. drive light go on when selecting certain menu options).  Without the file 
  15. loading code (which allows menus to be split among several small files, thus 
  16. saving a bunch of memory), and the ability to take 2 byte ASCII codes as input, 
  17. MENU.MOD's (memory resident) size would be close to 800 bytes, far less than 
  18. half the size of SlashBar.  Now, I'm not that much better of a programmer than 
  19. Mr. Hummel, but I had the VAST resources of PowerConsole to draw upon, and that 
  20. made for the HUGE difference in size. 
  21.  
  22. Now YOU can get into the menu making act too.  Mr. Hummel's MAKEBAR is a menu 
  23. file "compiler", complete with its own (tiny) programming language, of about 10
  24. commands.  It's the perfect way to start to learn programming, and to produce 
  25. something useful within hours after you begin.  The MAKEBAR/SlashBar package 
  26. is available on many BBSes, or can be downloaded directly from PC Magazine's 
  27. own BBS.  I'm sure there are lots of helpful little "memory joggers" you'd 
  28. like to be able to view at the touch of a key.  A more advanced project would 
  29. be to build your own phone book, and use PowerConsole's communications capa-
  30. bility to dial the selected number for you.  Also, you could "standardize" all 
  31. your applications, by putting their command structures into menu files. 
  32.  
  33. MENU.MOD will accept menu files produced by MAKEBAR (the only change neces-
  34. sary, if you create a menu using MAKEBAR, use ALT-ENTER for CTRL-ENTER, MENU-
  35. .MOD interprets it as CTRL-ENTER), select the LOAD_A_MENU option, and load it 
  36. into MENU.MOD's buffer.  MENU.MOD is set up to handle menus no larger than 2000 
  37. bytes (to save space).  But, MENU.MOD's menu file buffer can be expanded to 
  38. about 64,000 bytes, by adding /XXXX after the "POWERKIT.MNU" on the "LOAD ... 
  39. MENU.MOD ..." line in your AUTOEXEC.BAT, or by typing: 
  40.  
  41. LOAD MENU.MOD MENU_NAME.MNU/XXXXX
  42.  
  43. The XXXXX is the size you need for your menu file.  Make sure to "UNLOAD" 
  44. MENU.MOD, before "LOAD"ing it again with the new buffer size.
  45.  
  46. THE MENUS:
  47.  
  48. After you have become familiar with the POWERKIT II system, you will no longer 
  49. need the menus that came with this package (you will also probably detach 
  50. PKII.MOD's help screen, and save another almost 1000 bytes).  What the menus do 
  51. for you are obvious, with the possible exception of "TERMINAL MODE" on the MOD-
  52. EM menu.  First, you can enter terminal mode, or just dial your phone without 
  53. terminal mode, inside "most" programs.  TERMINAL MODE creates two MACROS, ALT-t 
  54. and ALT-x, then asks for a phone #.  ALT-t turns on copy to and copy from the 
  55. Modem (ALT-ESC 2 i, and ALT-ESC 3 i), and ALT-x turns them back off (ALT-ESC 4 
  56. i, and ALT-ESC 7 i).   After entering terminal mode (ALT-t), you may wish to 
  57. clear the screen of what is being displayed by the application you are inside, 
  58. so type ALT-ESC 2 J (don't worry, the screen will return after you press ALT-
  59. x, and press a few more keys; also, that "J" is upper case). 
  60.  
  61. Page 2 
  62.  
  63. All you need now for a basic communications package is a "back-scroller" to 
  64. capture your online sessions as the data scroll off the screen (such a back-
  65. scroller is in a POWERKIT II module that also has a command line editor and a 
  66. "cut & paste" facility, soon to be released), and a means for error-free trans-
  67. fer of files (you must be out of terminal mode, and at the DOS prompt, to use 
  68. one of these, press ALT-x, then KEYPAD 5, E ).  There are several good, stand-
  69. alone file transfer programs in the public domain. 
  70.  
  71. MENU won't work properly if you call it while terminal is active, so press ALT-
  72. x FIRST, then press ALT-t to return to terminal mode. 
  73.  
  74. Finally, you cannot use a single quote (') when using the MACROS menu to 
  75. CREATE, DELETE, MOVE, or VIEW a MACRO. 
  76.  
  77.