menu_new(3curses)                                  menu_new(3curses)


       NAME
             menu_new: new_menu, free_menu - create and destroy menus

       SYNOPSIS
             cc [flag . . .] file -lmenu -lcurses [library . . .]
             #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.

       NOTICES
             The header file menu.h automatically includes the header files
             eti.h and curses.h.

       REFERENCES
             curses(3curses), menus(3curses)

















                           Copyright 1994 Novell, Inc.               Page 1