Documentation For UserMenu CopyRight (C) 1987 by ZAP Software and Robert W. Albrecht. All Rights Reserved. ZAP Software Introduction UserMenu is an interactive personalized menuing system that simplifies the use of the CLI on Amiga Computers. It can execute most, but not all, programs that can be run on the Amiga. UserMenu and it's companion program are designed to use as little RAM as possible and still be functional and user-friendly. They will allocate almost all memory they need from your computer's "Fast" RAM (if available), the exception being the tiny window created by UserMenu. M is the program that processes the commands that are sent to UserMenu. By processing the commands M frees UserMenu of this task, thereby keeping the amount of memory used by usermenu to a minimum. Commands can be sent to UserMenu through a command file allowing you to save different menu configurations. Command Syntax run usermenu - This step is needed to make UserMenu RAM resident. A small window will appear in the upper left corner of your screen. m - This will display help for M and UserMenu. m add menu - This will add a new Menu to UserMenu. It also adds the first Menu Item, and it's associated action. The name of the Menu you want to add. Menu names with Menus are the words that appear acorss the title-bar of a window. The menu name can consist of spaces or tabs if it is surrounded by double quotes. Menu names, Item names, and sub-Item names are all case sensitive, meaning that upper-case and lower-case letters are treated differently by the program. The name of the first Menu Item for this menu. Menus can have Menu Items with identical names that do different things. This is the optional action that is associated with the menu item. An action is any command that can be executed from the CLI. For example "dir df0:" or "cc AnyProg". m add item - Adds a Menu Item to the specified Menu. The name of an existing Menu that you want to add the Menu Item to. The name of the Menu Item you want to add. see above m add sub - Adds a sub-Item to the specified Menu Item. This is the name of an existing Menu that you want to add the sub-Item to. The name of an existing Menu Item that you want to attach the sub-Item to. see "" above m del menu - Deletes a Menu, it's Menu Items, and their sub-Items. Memory is returned to the system. The name of an existing Menu. m del item - Deletes a Menu Item and it's sub-Items. The name of an existing Menu. The name of an existing Menu Item within the above Menu. m del sub - Deletes a sub-Item. The name of an existing Menu. The name of an existing Menu Item within the above Menu. The name of an existing sub-Item within the above Menu Item. m set pri - Sets task priority. This command sets the priority of tasks that are executed from Usermenu. Recomeded priorities range from 3 to -3. The standard Amiga tasks run at 0 priority. m file - Allows any of the above commands to be stored in a command file. The "m" should be removed from the command. For example: del menu MENUS. Other command files can be used inside a command file. Command files that are called from inside a command file are executed in the order they appear. A name of an Amiga Dos file. This file can be created with the Amiga editor "ed" or any other editor that can make ASCII files. Hints 1) If you are going to execute M from UserMenu you must ALWAYS "run" it. (eg. "run m file anyfile"). The reason for this is that M sends messages to UserMenu and waits for a reply. If UserMenu, in turn, is waiting for M to finish executing, a deadlock situation exists. 2) You can use an Amiga Dos command file to run UserMenu and then run M to set the Menus up. An intervening call to "Wait" is needed so that UserMenu has enough time to set up shop. Example: run usermenu Wait 1 secs m file anyfile 3) Programs that I couldn't get to work using UserMenu are; Dpaint, Ed, and Diskcopy. It might work for you though! 4) Programs that accept INPUT from the CLI may have problems with UserMenu. For example; Format will format a disk IMMEDIATLY without asking you if it's okay. 5) You can set up a master Menu that you can load all of the other menus from. For Example; add menu Master PRINT "run m file print.mnu" add item Master COMPILE "run m file compile.mnu" add item Master EDIT "run m file edit.mnu" 6) Each Menu can contain a Menu Item that deletes the Menu. For Example; add menu Master PRINT "run m file print.mnu" add item Master COMPILE "run m file compile.mnu" add item Master EDIT "run m file edit.mnu" add item Master Remove "run m del menu Master" <-- TRADEAMARKS UserMenu is a tredemark of ZAP Software. Amiga and Amiga Dos are trademarks of Commodore Amiga, Inc. LICENSE ZAP Software and Robert W. Albrecht are exclusive owners of the enclosed Software and Documentation. You are granted non-exclusive license to use the Software and Documentation, but you are not the owner of them. Your right to use the Software and Documentation under this agreement is the "License". "You" means the individual or legal entity whose agent uploads this software and accepts this Agreement. "Software" means the computer program recorded on the floppy-disk or other media, any update to them ZAP Software may later provide you, any back-up copies made, and the floppy-disk. "Documentation" means the user manual and other materials packaged with this Software. Transfer You may transfer the license for the use of the Software or Documentation to another person. Backup Copies Make as many copies as you want. Term The license is effective for twenty (20) years from the time you upload the software. You may terminate the license at any time. ZAP Software's rights. The ZAP Software and Documentation is protected by copyright, trade secret and trademark laws. You may not disclose the Software or Documentation to others, except as allowed in this license agreement, or remove or alter our ownership, trademark and copyright notices on our floppy-disks or Documentation. YOU MUST MAKE A GOOD FAITH EFFORT TO PREVENT ANY UNAUTHORIZED USE, COPYING, OR DISCLOSURE OF THE SOFTWARE OR DOCUMENTATION. THESE OBLIGATIONS WILL SURVIVE ANY TERMINATION OF THE LICENSE AGREEMENT. Disclaimer of other Warranties, and Liabilities. THERE ARE NO WARRANTIES, EITHER EXPRESSED OR IMPLIED, FOR THE SOFTWARE OR DOCUMENTATION, WHICH ARE BOTH LICENSED TO YOU "AS IS". ZAP SOFTWARE AND ROBERT W. ALBRECHT EXPRESSLY DISCLAIM ANY WARRANTY AS TO THE PERFORMANCE OF THE SOFTWARE, OR DOCUMENTATION. WE ALSO DISCLAIM ALL OTHER WARRANTIES, INCLUDING (WITHOUT LIMITATION) IMPLIED WARRANTIES OF MERCANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ZAP SOFTWARE, OR ANYONE ELSE INVOLVED IN THE CREATION, PRODUCTION, OR DISTRIBUTION, OF THE SOFTWARE OR DOCUMENTATION BE LIABLE FOR ANY INDIRECT, SPECIAL, INCEDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF THE SOFTWARE OR DOCUMENTATION OR ARISING FROM ANY BREACH OF ANY WARRANTY. Some states do not allow the exclusion or limitation of implied warranties or liability for incedental or consequential damages so the above exclusion and limitation may not apply to you. IN ADDITON TO THE ABOVE LIMITATION, OUR LIABILITY TO YOU OR TO ANYONE ELSE FOR DAMAGES SHALL NOT EXCEED THE LICENSE FEE PAID BY YOU FOR THE SOFTWARE AND DOCUMENTATION.