menu_new(3X)                     UNIX System V                     menu_new(3X)


NAME
      menunew:  newmenu, freemenu - create and destroy menus

SYNOPSIS
      #include <menu.h>

      MENU *newmenu(ITEM **items);
      int freemenu(MENU *menu);

DESCRIPTION
      newmenu creates a new menu connected to the item pointer array items and
      returns a pointer to the new menu.

      freemenu disconnects menu from its associated item pointer array and
      frees the storage allocated for the menu.

RETURN VALUE
      newmenu returns NULL on error.

      freemenu returns one of the following:
      E_OK           - The routine returned successfully.
      E_SYSTEM_ERROR - System error.
      E_BAD_ARGUMENT - An incorrect argument was passed to the routine.
      E_POSTED       - The menu is already posted.

NOTES
      The header file <menu.h> automatically includes the header files <eti.h>
      and <curses.h>.

SEE ALSO
      curses(3X), menus(3X)























10/89                                                                    Page 1