MENU_NEW(3)             NetBSD Library Functions Manual            MENU_NEW(3)

NAME
     free_menu, new_menu -- create or delete a menu

LIBRARY
     Curses Menu Library (libmenu, -lmenu)

SYNOPSIS
     #include <menu.h>

     int
     free_menu(MENU *menu);

     MENU *
     new_menu(ITEMS **items);

DESCRIPTION
     The free_menu() menu function destroys the given menu and frees all allo-
     cated storage associated with the menu.  All items associated with the
     menu are detached from the menu before it is destroyed.  The new_menu()
     function allocates storage for a new menu and initializes all the values
     to the defined defaults.  If the items pointer passed is not a NULL then
     the given NULL terminated array of items is attached to the new menu.

RETURN VALUES
     The new_menu() function returns NULL on error, while the free_menu()
     function returns one of the following error values:

     E_OK            The function was successful.
     E_BAD_ARGUMENT  One or more of the arguments passed to the function was
                     incorrect.
     E_POSTED        The menu is already posted.

SEE ALSO
     curses(3), menus(3)

NOTES
     The header <menu.h> automatically includes both <curses.h> and <eti.h>.

NetBSD 5.0                    September 10, 1999                    NetBSD 5.0