UMENU 0.7.0 installation instructions NO WARRANTY -- See GPL license! Be aware that this version does NOT default choices beginning with Q to a menu exit. Menu exits must now be explicitly declared with the following command string: C_^ Any choices not having a command string starting with C_ will display the string "nop" before the menu letter. "nop" stands for No OPeration. 1. These installation instructions are for single user installation. Each user can perform his/her own single user installation. For other installation types, see the online documentation at http://www.troubleshooters.com/umenu/index.htm, specifically the project specifications. 2. UMENU 0.7.0 requires Node.pm, which can be downloaded from http://www.troubleshooters.com/projects/Node/index.htm. Node.pm installation is very easy -- basically untar the tarball into the directory of your choice -- typically /usr/local. If you untar it in /usr/local, the Node directory will be /usr/local/Node. Wherever you install it, remember the Node directory, as you will need to remember it to set up UMENU. 3. If you have a directory called umenu and/or .umenu in your home directory, rename it/them to something other than umenu or .umenu. 4. From inside your home directory, perform the following command: tar -xzvf umenu-0.7.0.tar.gz The preceding command creates the .umenu tree. 5. Edit $HOME/.umenu/program/umenu.cnf. A typical setup would be this: ###### nodedir=/usr/local/umenu menudir=../menudir/ scriptdir=$HOME/ getch_style=1 os=unix ###### Set nodedir to wherever your Node program resides (step 2 of these instructions). Your os variable should remain at unix unless you install UMENU on a Windows computer, and please bear in mind that UMENU needs extensive modification before it will work on Windows. The getch_style variable invokes slightly different ways of acquiring a keystroke without pressing Enter. If UMENU seems to run until it asks for a keystroke, consider changing getch_style to 0. Valid values for this variable are 1 and 0. 6. From the $HOME/.umenu/program directory, perform the following command: ./umenu.pl x The preceding should bring up the menu on a minimal menu system using menu files starting with x. If not, troubleshoot. !!!WARNING!!! The x menu system was created in 1999. It is very old, and some of the commands no longer work right. Therefore some of them might be dangerous. Use with care. 7. Copy the starter scripts to a directory on the execution path. Some appropriate places would be /usr/local/bin or $HOME/bin, if they are on your execution path. 8. Invoke the X menu as follows: mmm x mm_startmenu_specific x The first method invokes a persistent menu, while the second invokes a menu that terminates after you choose a command (not a submenu). If either of these don't work, troubleshoot. Note that you'll need major modifications to all the mm* scripts if you install UMENU any place other than $HOME/.umenu. 9. You now have a working UMENU. For vastly simplified menu management, you should download and install the EMDL (Easy Menu Definition Language) system from http://www.troubleshooters.com/projects/emdl/index.htm. Otherwise, you can edit UMENU's .mnu files manually with an editor.