home *** CD-ROM | disk | FTP | other *** search
/ Computer Panoráma / computer_panorama_1997-12-hibas.iso / SHARE / Util / POWER-10.ZIP / PWRMENU.TXT < prev   
Text File  |  1997-08-14  |  6KB  |  120 lines
  1. Power Menu v1.0
  2. Copyright (c) 1997, Jem E. Berkes
  3.  
  4. bP Software
  5. bpsoft@bigfoot.com
  6. http://atc.nethosting.com/starlink/bp/
  7.  
  8. --------------------------------------
  9. Power Menu was written in 100% assembly language, using the Borland Turbo
  10. Assembler.  It is small, simple, fast, and uses very little memory (1.4 KB).
  11.  
  12. If you like this freeware program, you might want to purchase a customized
  13. version and/or site license. This will let you use a version of Power Menu
  14. with your choice of colours, your choice of screen mode (such as an enhanced
  15. text mode with 30 rows) and anything else which is possible. Prices depend
  16. on what you would like customized. A site license IS REQUIRED to run this
  17. software on multiple PCs. See the bottom of this file for contact info.
  18.  
  19. I know that when I want to try out a menu system or DOS Shell I start up the
  20. program immediately and take it for a test drive ... but PLEASE, read these
  21. short instructions first (exactly 2 pages printed out).
  22.  
  23. Power Menu is a menu system for IBM PCs and 100% compatible sytems running
  24. at least DOS version 2.  Unlike the popular DOS Shell program that came
  25. with DOS versions 4 and later, Power Menu will run on other DOS systems that
  26. are not genuine Microsoft products (e.g. Caldera OpenDOS / DR-DOS). Power
  27. menu is easy to set up and offers many advantages, particularly in the way
  28. of speed and memory usage.  A colour-capable display card is required, and
  29. some knowledge (on the user's part) of the DOS system also helps a little!
  30.  
  31. Power Menu's interface is very simple: a colourful textmode interface with
  32. a list of up to 255 menu items.  When selected, a command will run and then
  33. you will return back to your current position in the menu.  The menu system
  34. scrolls smoothly up or down (there is no choppy page up/down required).  A
  35. lightbar will highlight the current selection and a counter in the corner of
  36. the screen will remind you which item number you are on (out of a total of x
  37. items). Your original screen mode is restored whenever you leave the menu.
  38.  
  39. The real advantage of Power Menu becomes apparent when you execute a command
  40. from the menu system.  Power Menu will run the command and will only keep
  41. a 1504 byte "stub" in memory.  Power Menu does not use any annoying tricks
  42. such as creating temporary batch files.  This makes it possible to run Power
  43. Menu on a network drive, where you do not always have write access.
  44.  
  45. --------------------------------------
  46. HOW TO GET IT WORKING:
  47.  
  48. Create a file called PWRMENU.INI (or edit the supplied example file).  Let's
  49. say that you want to make a menu item called "Wolfenstein 3D" which will
  50. run the Wolfenstein 3D game, whose executable file is located at the path
  51. "c:\games\wolf3d\wolf3d.exe".  You would insert a line into PWRMENU.INI which
  52. reads exactly like this:
  53.  
  54. {Wolfenstein 3D}c:\games\wolf3d\wolf3d.exe
  55.  
  56. You can see that the format is {Menu item name}d:\path\filename.exe. Keep in
  57. mind that even though at the DOS prompt you can type "MEM", for the menu
  58. system you have to specify the full path, in this case c:\dos\mem.exe.
  59.  
  60. One very important note is that you can not run batch files directly. Batch 
  61. files are not real programs, but rather the special "programming language" of
  62. COMMAND.COM.  So (for example), to run a batch file called TEST.BAT in the 
  63. C:\BATS directory, this would be the entry in PWRMENU.INI:
  64.  
  65. {Run a test batch file}c:\command.com /c c:\bats\test.bat
  66.  
  67. Internal commands (DIR, COPY, MD, DEL, etc.) are also internal commands and
  68. must be run through COMMAND.COM using /C, i.e. c:\command.com /c dir
  69.  
  70. An entire menu is simply made by putting together many such lines.  You can
  71. have up to and including 255 entries. End the line after the } to make a do-
  72. nothing entry (e.g. a sub-heading). You can also insert comments into the INI
  73. file, which are ignored provided they don't start with the "{" character.
  74.  
  75. Now make sure that PWRMENU.EXE and PWRMENU.INI are in the same directory. I
  76. have copied mine into C:\DOS, which is a directory that is in my system's
  77. PATH (this means that the files in C:\DOS can be called from any directory).
  78. To start up the menu, I just type PWRMENU. I can do this from anywhere in
  79. my system.
  80.  
  81. Use the up and down arrow keys to move the lightbar throughout the menu. Then
  82. press ENTER to start up a selection or press Esc to exit the menu system.
  83.  
  84. --------------------------------------
  85. EXTRA STUFF:
  86.  
  87. Power Menu will run under practically any system conditions. It only requires
  88. 66 KB of memory to start up and will shrink to 1504 bytes when you run a
  89. command. It includes a checksum mechanism which will usually catch a problem
  90. in the program, for example if it has been illegally modified or infected by
  91. a computer virus. So it's pretty safe and very stable.
  92.  
  93. It is not possible to configure this freeware version of Power Menu in any
  94. great detail. But if you like this freeware version and would like to have a
  95. customized copy, you can get one for a small fee. Type PWRMENU /? at the DOS
  96. prompt for more information about obtaining a site license/customized version.
  97.  
  98. Here are a few more important notes:
  99.  
  100. - PWRMENU.INI must be less than 64 KB in length
  101. - The INI file must have the same name as the executable, i.e. if you rename
  102.   PWRMENU.EXE to MENU.EXE, the initialization file must be named MENU.INI
  103. - The INI file must be in regular ASCII format. Lines must end with the
  104.   conventional CR/LF (ASCII 13/10) combination
  105. - It is OK to shell out to DOS (by creating a {Command Prompt} menu item, for
  106.   example), and edit the INI file. Power Menu always reloads the INI file.
  107. - If your command has extra parameters, a space must separate them from the
  108.   command itself, i.e. C:\DOS\MEM.EXE /C
  109. - ERRORLEVELs returned by Power Menu are 0=OK, 1=Not enough memory, 2=INI file
  110.   not found or incorrectly set up (e.g. too many entries), 3=Checksum failure.
  111.  
  112. --------------------------------------
  113. AUTHOR'S POSTAL ADDRESS (e-mail address is bpsoft@bigfoot.com)
  114.  
  115.         Jem E. Berkes
  116.         185 Waverley Street
  117.         Winnipeg, Manitoba
  118.         R3M 3K4
  119.         Canada
  120.