UMENU - The Universal Menu System Interface by Steve Litt.

Copyright (c) 1999  Steve Litt, Orlando, FL. USA.
slitt@troubleshooters.com.

PROJECT WEBSITE: http://www.troubleshooters.com/umenu/index.htm

LICENSE:

    AS-IS: NO WARRANTEE!
    This software is Open Source licensed under the GNU GPL
    license. See the file named COPYING in the program 
    directory for a copy of the GNU GPL
    (General Public License), version 2.
    If, for some reason it's not there, you
    can obtain a copy from the Free Software Foundation:
    Free Software Foundation, Inc. 
    59 Temple Place, Suite 330 
    Boston, MA  02111-1307  USA 
    http://www.fsf.org/copyleft/gpl.html.

RECENT NEWS:

    The alpha version has just been released.

SYSTEM REQUIREMENTS:
    * Linux
    * Perl 5 or better

INSTALLATION:

    * unzip or gunzip/tar --extract to a directory tree
        * Go to the directory below which you want to install the UMENU tree (let's call it whatever) 
        * place umenu-0.5.0.tar.gz there
            * If the browser swaps underscores for some of the dots, i.e. umenu-0_5_0_tar.gz
              just work with the filenames it gives you in the following steps.
        * gunzip umenu-0.5.0.tar.gz to obtain umenu-0.5.0.tar
        * tar -p --extract --file=umenu-0.5.0.tar --verbose 
    * Go to the program directory just under the tree's root
    * Issue the command  perl -w ./umenu.pl x
    * The included x menu should run. Troubleshoot as necessary.
    * Try the command ./umenu.pl. x 
        * If it doesn't work when the same command preceeded by perl did,
          there's probably a problem with the #!/usr/bin/perl -w line at the top of
          umenu.pl, getch, and/or some of the other .pl files. You can find 
          the location of perl on your system by doing the which perl command.
          Fix the source files as necessary. 
    * If you wish an easy way to access UMENU from any directory, modify line 1 of shellscript
      whatever/umenu/program/mm so it changes to the program directory, then copy it to
      a directory on your path (like /usr/bin), and make it executable. On multiuser
      systems, get permission from the administrator to do this.

DEFAULT DIRECTORY STRUCTURE
    whatever/umenu
        |
        |--program
        |     |--COPYING    (The license agreement)
        |     |--umenu.cnf  (Universal Menu System config file, default)
        |     |--umenu.pl   (Main program)
        |     |--OS.pm      (OS object encapsulates OS dependencies)
        |     |--CONFIG.pm  (CONFIG object encapsulates configuration)
        |     |--CHOICE.pm  (CHOICE objects handle all aspects of a menu choice)
        |     |--getch      (tiny perl program to capture single user keystroke)
        |     |--mm         (Shellscript to invoke menu, to be configured and placed on the exe path)
        |     `--get,add,new,put,chng pl's for configuring menus
        |
        |--menudir
        |     |--org        (directory containing original copy of starter menu def files)
        |     `--x*.mnu     (starter menu definition files)
        |
        `--doc
              |--index.htm  (html docs shipped UMENU distribution)
              |--config.htm (installation/configuration howto)
              `--README     (This file)

CONFIGURATION:

    See in the whatever/umenu/doc/htmldoc/config.htm in this UMENU distribution.
    See the project website at http://www.troubleshooters.com/umenu/index.htm.

IF YOU HAVE PROBLEMS:

    See the Troubleshooting section of whatever/umenu/doc/htmldoc/config.htm
    See the project website at http://www.troubleshooters.com/umenu/index.htm    

MAINTAINERS:

    Steve Litt: slitt@troubleshooters.com
    More soon to come.

Regards,
Steve Litt.

=======================================================================


End.