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


NAME
      menu_new:  new_menu, free_menu - create and destroy menus

SYNOPSIS
      #include <menu.h>

      MENU *new_menu(ITEM **items);
      int free_menu(MENU *menu);

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

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

RETURN VALUE
      new_menu returns NULL on error.

      free_menu 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