                                   menu.pl
                                 Perl Menus
                                 Version 2.1
                                Release Notes
                             September 15, 1993

                               Steven L. Kunz
                           Networked Applications
                  Iowa State University Computation Center
                            Iowa State University
                                 Ames,  Iowa


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


Changes between menu.pl version 2.1 and version 2.0:

- Several bugfixes provided by Greg Kresko (National Research Council
  Canada).  Greg found some problems with "endwin" statement placement (or
  lack thereof).  Also suggested some minor changes to the demo programs. 

Changes between menu.pl version 2.0 and version 1.4:

- Added multiple selection capability (new "menu_display_mult" call). 
  Includes new menu options "a" (select "all"), "m" (select based on a string
  "match") and "c" ("clear" all selections).
- Added "radio button" selection capability (new "menu_display_radio" call).
- Removed "f" and "b" ("forward" and "backward") as page movement.  Replaced
  by existing (but unadvertised) "n" and "p" ("next" and "previous" page).
- Added "b" and "e" ("begin" and "end") as fast page movement to the items
  at the beginning and end of a menu.
- Added "h" to provide a help screen explaining all available menu actions.
- Changed default menu prompt formats.
- Added ability to let users spawn off a sub-shell (and get a command
  prompt) from any menu (using the "!" hot-key) and later continue (upon
  shell exit).  This feature is normally disabled.
- Added "menu_getstr" utility routine call (lets you get a string from std
  input with C-shell-like editing)
- Documentation changes (new features, some typos)

Changes between menu.pl version 1.4 and version 1.3:

- Added "r=refresh" to bottom menu line (when it fits).
- A few (minor) documentation changes

Changes between menu.pl version 1.1 and version 1.3:

- Fixed bug in the "numeric direct entry code".  Once a number was entered 
  it was not cleared if an arrow key was used to move the pointer off the
  selection.
- Added the "top menu" feature.  Allows for a "t" ("top") menu hot-key to
  move to the top (first displayed) menu.
- Added the "latched" menu feature.  Allows calls to "menu_display" to have
  two additional parameters that remember the screen/arrow location upon
  return from the call.  When recalling "menu_display" (with the same
  parameters) the menu will be restored to the original location/selection.

Changes between menu.pl version .9 (beta) and version 1.1:

- Declaration of "curses_application" fixed ("main`" prepended).
- Cleanup of "cbreak" and "echo" handling.  Calls to "menu_display"
  always return with "echo" and "cbreak" set.
- Return key now functions on systems that do not have termcap entries
  for either a "newline" or "return" key.
- "menu_display" will return "%EMPTY%" if no calls to "menu_item" were
  done between a "menu_init" call and a "menu_display" call.
- Hitting the "space bar" is now the same as "f" or "n" for forward movement
  within a multi-page selection menu.
- The title strings in "menu_init" calls can now begin with a "-" to suppress
  the "standout" attribute (normally a bold or reverse-video rendition).
- menu_display will no longer return "%QUIT%" - returns "%UP" instead.  The
  menu routines process a "q" (for "quit") locally and will exit from
  there (after the user responds to a "Do you really want to quit?" prompt).
- Direct number entry for selecting entries "pops" the arrow to the 
  "best fit" selection on the screen, indicating what selection will be 
  made when return is hit.
- The "ezview" demo now displays the correct modification date on its file
  display.

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