home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / c128 / utilities / menu128v200.sfx / readme.1st < prev    next >
Encoding:
Text File  |  1990-02-12  |  13.6 KB  |  286 lines
  1.                             POWERMENU 128 v2.00
  2.                            (c)1998 by Ben Holmes
  3.  
  4.  
  5. INTRODUCTION:
  6.  
  7. When I finally received my SCPU128 from CMD, my first ambition was to change
  8. the menu program I was using to work efficiently with the SCPU.  I searched
  9. around the different menu programs available, and finally came to the
  10. conclusion that I'd have to write my own.  No-one else seemed to be interested
  11. in supporting the 'Power-User', and with the features that I wanted.
  12.  
  13. This is a list of equipment supported:
  14.  
  15. JiffyDos [Required]
  16. RamLink  [Highly Recommended]
  17. SCPU128  [Highly Recommended]
  18. CMD HD   [What, you don't have one?]
  19. All Drive types are supported.
  20.  
  21. Now, if you don't have JiffyDos, (Chip, RamLink, or SCPU), this program simply
  22. will not work.  If you don't have a RamLink, it'll take awhile to boot.  If
  23. you don't have a SCPU128, it will run slow.  If you don't have 16 MEG's in your
  24. RamLink, or a CMD HD... what do you need a menu program for?
  25.  
  26. -------------------------------------------------------------------------------
  27.  
  28. PROGRAM INSTALLATION:
  29.  
  30. After running 'powermenu-vX.sfx', it will dissolve itself into the following
  31. files:
  32.  
  33. powermenu-128    :This is the main menu program
  34. readme.1st       :This text file.
  35. pm help          :The help file... 'memo' format. (Press 'H' to see)
  36. pm parm          :Parameter File for Powermenu
  37. pm basic         :This file will be loaded and run if you hit 'ESC'
  38. pm data-1        :This is the data file for the first (F1) area.
  39. pm data-2        :         "         "         second (F3) area.  
  40. pm data-3        :         "         "          third (F5) area. 
  41. pm data-4        :         "         "         fourth (F7) area.  
  42. pm memo-0        :Memo file... you can create up to 10 memo's, named
  43. pm memo-1        :memo-0 through memo-9
  44.  
  45.  
  46. The ideal place for this program is in your RamLink... if you don't have a 
  47. RamLink, then place these files in your CMD HD's 1st partition. (Or perhaps
  48. more correctly - the 'default' partition)
  49.  
  50. RamLink: Run the RamLink utility - AutoFile.  This will allow 'PowerMenu' to
  51.          be autobooting.
  52. CMD HD   Create a boot partition to boot this program.
  53.  
  54.  
  55. Here is what PowerMenu128 looks like, and what the different areas mean:
  56.  
  57.          Page number {$60}{$60}{$60}{CBM-S} 
  58.                         {$7d}
  59.         {CBM-A}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{CBM-R}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{CBM-S}
  60.         {$7d} PowerMenu128  X    {$7d}     Date/Clock and DOS Area        {$7d}
  61.         {CBM-Q}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$7b}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{CBM-W}
  62.         {$7d}                    {$7d}                                    {$7d}
  63.         {$7d}  This is the area  {$7d}                                    {$7d}
  64.         {$7d}  for your program  {$7d}                                    {$7d}
  65.         {$7d}  lists. There is   {$7d}        Help File Area              {$7d}
  66.         {$7d}  room for 15 items {$7d}        'Dated' memo's              {$7d}
  67.         {$7d}  on each 'page',   {$7d}             and                    {$7d}
  68.         {$7d}  and you have four {$7d}   Normal memo's #0 through 9       {$7d}
  69.         {$7d}  pages. (F1,F3,F5  {$7d}                                    {$7d}
  70.         {$7d}  and F7).          {$7d}   This area is also for any        {$7d}
  71.         {$7d}                    {$7d}   directory listings that you      {$7d}
  72.         {$7d}                    {$7d}   may request.                     {$7d}
  73.         {CBM-Q}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{CBM-W}                                    {$7d}
  74.         {$7d}  Disk Drives area  {$7d}                                    {$7d}
  75.         {$7d}  Up to 5 drives    {$7d}                                    {$7d}
  76.         {$7d}  will be auto-     {$7d}                                    {$7d}
  77.         {$7d}  detected & listed {$7d}                                    {$7d}
  78.         {CBM-Z}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{CBM-E}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{$60}{CBM-X}
  79.  
  80. When you first run this program, you will see *MY* data files, after you
  81. play around with the program, just type this: 'scratch"pm data*', this will
  82. scratch all the data files, and allow you to start creating your own.  You
  83. can actually do this within the program - use the DOS command '@', then
  84. type 's0:pm data*' and hit return.
  85.  
  86. WARNING: Be careful where you press the 'RETURN' key... in many cases, the
  87. PowerMenu program will IMMEDIATELY load & run a program.
  88.  
  89. Now, first, you'll notice that all of your drives that you have connected are
  90. listed in the bottom left corner.  Press the Cursor Up/Down key, and see the
  91. highlight bar move to the different programs.  If you press the Cursor left
  92. or Right, the highlight bar will jump down to the Disk Drive area.  If you
  93. hit return while the highlight bar is on a Disk Drive, PowerMenu will clear
  94. itself, and set your default drive as the highlighted one.
  95.  
  96. Now that you know what the Cursor keys do, try pressing 'H'.  This will bring
  97. up a 'Help' screen, that lists all the different functions of PowerMenu. The
  98. first function you will want to work with, is 'E' (Shift 'e')...
  99.  
  100. ------------------------------------------------------------------------------
  101.  
  102. EDIT POWERMENU PARAMETERS:
  103.  
  104. Entered by pressing shifted 'e'.  First question is 'Are you using the Xetec
  105. Gold Printer Interface?'  Some interfaces, notably the Xetec Gold, will
  106. confuse the program, as it will react to commands on the 'command channel'.
  107. (Device 14).  If you answer yes to this question, the program will skip device
  108. 14 during it's drive search.
  109.  
  110. Second question is '10-Second autorun program number?'  Hit any key to rotate
  111. from 0 to 15.  If set to zero, this will do nothing.  If you set it to a non-
  112. zero number, PowerMenu will automatically load and run that program after
  113. a 10 second delay.  Even if you have enabled this feature, if you press ANY
  114. key in the first 10 seconds, PowerMenu will abort this feature.  I have it
  115. set to run my first program 'Ace Term', as the first thing I do every day
  116. when I get home from work, is to log onto the Internet.  This way, I walk
  117. in the door and turn on my Computer, head to the fridge, and when I get back,
  118. my Ace environment is loaded and waiting.
  119.  
  120. Third question is 'Change Key Definitions.'  If you press the 'ESC' key,
  121. PowerMenu will clear itself, and load & run a program called 'pm basic'.
  122. This program will normally change the function keys to my favorite settings,
  123. but if you don't like the change, either toggle this to 'No', or edit the
  124. program 'pm basic'.  Although PowerMenu is compiled for speed, 'pm basic'
  125. is left in basic for any changes you'd care to make.
  126.  
  127. The next three questions will ask about the device/partition/path of the main
  128. PowerMenu program and data files.  Please be sure this is set to your setup,
  129. as otherwise, there may be times when the program cannot update it's files
  130. correctly.
  131.  
  132. Once you answer all the questions correctly, the program will save the info
  133. in a data file called 'pm parm'.  Moving on to the next set of functions, we
  134. will learn how to list our own programs in PowerMenu.
  135.  
  136. -----------------------------------------------------------------------------
  137.  
  138. ADDING PROGRAM LISTINGS:
  139.  
  140. To add a program to PowerMenu, let's first discuss HOW it saves it's files.
  141. Everything is held in four files 'pm data-1' through 'pm data-4'.  If you
  142. press the F1, F3, F5, or F7 keys, you will see the four areas.  You can set
  143. these areas up any way you want... myself, I have it configured this way:
  144.  
  145. F1 - Terminal programs
  146. F3 - Word Processing & Graphics
  147. F5 - Utility Programs (FCopy, CS-Dos, etc)
  148. F7 - Archive & Compression (Omega-Q, Unzip, etc)
  149.  
  150. Each area can ONLY have 15 files... sorry, I had to draw the line somewhere.
  151. This still gives you 60 files per menu, and one PowerMenu can load & run
  152. another PowerMenu (as long as it's located in another drive, partition, or
  153. path).
  154.  
  155. If you add, move, edit, or kill a program listing, the 'pm data-x' file is
  156. changed IMMEDIATELY.  But this is not a liability, since it is SO quick to 
  157. change!  Now, to add files, be sure that you've already set the PowerMenu
  158. Parameters... Hit the F1/F3/F5/F7 area key that you want the program to be
  159. listed in.  Now, to help you in answering the questions when you 'Add' a
  160. file, you can use the DOS features to examine the drive.
  161.  
  162. Press Cursor left/right to move the highlight bar to the appropriate drive.
  163. If necessary, you can now press '@' and change partition or path info...
  164. Now, just press 'd' to list a directory.  You can use the 'No Scroll' key
  165. to pause long listings.  Now that you know where a file is, and the precise
  166. disk name, you're ready to 'Add' a file to PowerMenu.
  167.  
  168. Press 'A' - You'll now have to answer some questions about the file you want
  169. listed in PowerMenu.  These are the questions:
  170.  
  171. #1. 'Menu Name?'  This is the name that you want to show up on PowerMenu. It
  172. can be up to 25 letters long (longer than the disk filename limit of 16) Make
  173. sure that this name is descriptive enough for you to remember what it is.
  174.  
  175. #2. 'Disk Name?'  This is the filename on the disk that you want PowerMenu to 
  176. load and run.  Be sure to type it in EXACTLY as it is on the disk directory!
  177.  
  178. #3. 'Drive?' Defaults to '8'.
  179.  
  180. #4. 'Partition?' and...
  181.  
  182. #5. 'Path?'      Enter the partition number or path name ONLY.  Don't put
  183. 'cp', 'cd', '://', or anything of that nature.... PowerMenu handles that.
  184. If the drive you are loading from is not a CMD device, just leave this blank.
  185.  
  186. #6. 'Load Method?'  Hit any key (I use space bar) to toggle between the three
  187. methods listed.  Hit return when chosen.
  188.  
  189. #7. 'Mode?'  Hit any key to toggle between the listed modes.  Hit return when
  190. you've chosen.
  191.  
  192. #8. 'Bank Number?'  If you don't know about this... ignore it.  Hit return.
  193.  
  194. #9. 'SYS Call?'  This is for the 128 mode only... Perhaps in a later version
  195. I can implement this for 64 mode as well.
  196.  
  197. #10. 'SCPU'  This is for the SCPU128... any key will toggle the different
  198. optimization modes.  Many programs can use full Optimization, try it first!
  199. (Ignored if you don't have a SCPU...)
  200.  
  201. #11. 'Gosub Calls'  Currently only two possible calls.  Any key toggles,
  202. return when chosen.  (HD Tools 128 - for the CMD HD, *requires* the parallel
  203. cable be turned off before operating correctly)
  204.  
  205. After answer all the above questions, the PowerMenu program will save the
  206. new information, then list the new program in -last- place. If you want the
  207. list ordered differently, you can move the files around by using the 'm'
  208. command.  Just move the highlight bar to the file you want moved, press 'm',
  209. now move the highlight bar where you *want* the file, and press return.
  210.  
  211. You can 'kill' the file highlighted (remove it from your PowerMenu) by hitting
  212. 'k'.  You can edit the data for a highlighted file by pressing 'e'.
  213.  
  214. -------------------------------------------------------------------------------
  215.  
  216. SCREENSAVER MODE:
  217.  
  218. By the time you've read this far, you may have noticed that PowerMenu has a
  219. 'ScreenSaver' mode.  If you don't do anything for one minute, the screen
  220. saver will come on... just press shift 'F8' to get back the screen.
  221.  
  222. -------------------------------------------------------------------------------
  223.  
  224. MEMO's:
  225.  
  226. You can create your own memo's... 'pm memo-0' automatically loads, and if you
  227. press the number keys 1-9, that memo will load and display.  I use CS-Dos to 
  228. create my memo's... just remember the 50 column limit when creating your
  229. memos.  The 'Help' screen is just another memo with a different name on the
  230. disk.  You could change the help screen if you had a reason to.
  231.  
  232. -------------------------------------------------------------------------------
  233.  
  234. DIRECTORY & DOS FEATURES:
  235.  
  236. Here is a very powerful part of the PowerMenu repetoire... you can do all 
  237. normal DOS functions such as viewing directories, scratching files, validating
  238. disks, and so on.  Just press '@', and the window in the upper right corner
  239. will display '@0:' and wait for your entry.
  240.  
  241. Hitting 'd' will display the directory of the active device (normally 8).
  242. Moving the cursor to the drive section first, will then display the directory
  243. of the device your cursor bar is on. (lower left corner of display).
  244.  
  245. If you press shift 'd' (Capitol 'D'), you will see another menu appear in the
  246. right side of the screen.  It is self explanatory.  If you don't have a clock
  247. in one of your CMD drives, it will not be as useful.  Another feature for use
  248. with CMD devices only is 'p' for partition display.
  249.  
  250. -------------------------------------------------------------------------------
  251.  
  252. DROP TO BASIC:
  253.  
  254. Sometimes, nothing you have on the menu is what you want to do... no problem!
  255. You can 'Drop to Basic' by pressing just one key.  To drop to 128 mode, press
  256. the ESC key.  PowerMenu will then load and run a basic program called 'pm
  257. basic'.  This program will change screen colors, change the function key
  258. definitions, and clear everything out of memory before aborting itself.  You
  259. can make your own modifications to this program if you wish!  (If you make any
  260. good ones, let me know!)
  261.  
  262. You can also drop to 64 mode by pressing the TAB key.  At this time, PowerMenu
  263. doesn't load any other program as it does in the 128 mode.  This may change
  264. in a future version, if there is enough need....  
  265.  
  266. If you wish to drop (in 128 mode only) to a particular drive, move the cursor
  267. bar to the drive, and then hit return.  This bypasses the 'pm basic' program.
  268. Powermenu will just switch to that drive, and delete itself.
  269.  
  270. -------------------------------------------------------------------------------
  271.  
  272. AUTHOR'S NOTES:
  273.  
  274. I hope you enjoy this program, I've enjoyed creating it, and I use it on a 
  275. daily basis.  If you don't have both a RAMLink and SCPU128, you may find
  276. this program too slow for daily use... sorry!!  I wrote this because no-one
  277. else had written what I needed.  If you *do* enjoy using this, I'd be happy
  278. to hear from you.  I'm the SYSOP of Civic 64/128 Users Group BBS, at (805)
  279. 382-1125.  Running a 1.28 GIG Hard Drive filled with useful programming
  280. utilities, tied to a 33.6 Modem, and 1st time users can download!  You can
  281. log on and leave me a note there.  Or, if you're on the Internet, just 
  282. email me at 'bnholmes@rain.org'.  Comments, ideas for improvements, and bug
  283. reports are all welcome.
  284.  
  285.  
  286.