                                   menu.pl
                                 Perl Menus
                                 Version 2.1
                              September 15, 1993

                               Steven L. Kunz
                         Networking & Communications
                  Iowa State University Computation Center
                            Iowa State University
                                 Ames,  Iowa
                  

Copyright (C) 1992-93  Iowa State University Computation Center
                       Ames, Iowa (USA)

menu.pl is free software; you can redistribute it and/or modify it under the 
terms of the GNU General Public License as published by the Free Software 
Foundation; either version 1, or (at your option) any later version.  

menu.pl is distributed in the hope that it will be useful, but WITHOUT ANY 
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more 
details.  

You should have received a copy of the GNU General Public License along with
menu.pl; see the file COPYING.  If not, write to: 
  
  The Free Software Foundation
  675 Mass Ave
  Cambridge, MA 02139, USA 

Distribution Contents:
----------------------

This is "menu.pl" - a set of perl routines that will perform full screen
menu functions using "curseperl".  What you should have after unpacking 
this package is the following:

  COPYING        GNU Public License

  README         (this file)

  RELEASE_NOTES  Differences between this version and previous versions.

  MENU_DOC       A user's guide to the menu.pl routines.

  demo           A simple menu demo showing all several types of menu
                 selection capabilities (simple single-page, simple
                 multiple-page, radio-button, and multiple-selection).

  demo_getstr    A simple menu demo using the "menu_getstr" routine.

  demo_top       A simple menu demo with "top" menus.

  ezview         A more involved demo showing how menus can be used to call
                 routines, select files, etc.

  menu.pl        The perl menu subroutines in a package (usually placed 
                 somewhere like /usr/local/lib/perl/menu.pl)

  ultpatch       Patches I had to apply to the bsdcurses.mus file to make 
                 it work on an ULTRIX (BSD based) system.

Installation:
-------------

  1) If you don't have curseperl working and installed somewhere, go into
     your perl.4.36 distribution (in the "usub" directory) and construct it
     following the instructions there.  Be forewarned that when I put it 
     together it didn't work on my ULTRIX 4.2a system - I had to install some
     patches I got off comp.lang.perl (posted by drw@nevanlinna.mit.edu)
     and some changes I had to add myself.  The file "ultpatch" is the
     diffs between what I run and what is distributed with perl.  Patch
     your original bsdcurses.mus with this if you are having trouble
     getting curseperl to work with ULTRIX.  These patches mainly involve
     commenting out routine calls absent in the ULTRIX curses package.

     Install your "curseperl" in the same location as your normal "perl"
     binary.

     You may need to modify the first line of the demo scripts ("demo",
     "demo_top" "demo_getstr", and "ezview") to point to where your
     "curseperl" is installed.  The are distributed assuming curseperl lives
     in "/usr/local/bin".  

  2) Put "menu.pl" with the rest of your perl packages (usually in something
     like "/usr/local/lib/perl").  The demo programs will work by just leaving
     a copy of "menu.pl" in the same directory as the demo scripts.

  3) Note that if you move the demo programs into a public area (and out of
     the distribution library), you should change the 'require "./menu.pl";'
     statements in all the demos to 'require "menu.pl";' (after moving the
     menu.pl package as outlined in the previous step).

---
Steven L. Kunz
Networked Applications
Iowa State University Computation Center, Iowa State University, Ames  IA
INET: skunz@iastate.edu     BITNET: gr.slk@isumvs.bitnet
