menunew(3X)                                                      menunew(3X)



NAME
       menunew - create and destroy menus

SYNOPSIS
       ##include <>
       MENU *newmenu(ITEM **items);
       int freemenu(MENU *menu);

DESCRIPTION
       The  function newmenu creates a new menu connected to a specified item
       pointer array (which must be NUL-terminated).

       The function freemenu disconnects menu from its item array  and  frees
       the storage allocated for the menu.

RETURN VALUE
       The function newmenu returns NUL on error.

       The function freemenu returns one of the following:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

       EBADARGUMENT
            Routine detected an incorrect or out-of-range argument.

       EPOSTED
            The menu has already been posted.

SEE ALSO
       curses(3X), menu(3X).

NOTES
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PORTABILITY
       These routines emulate the System V menu library.  They were  not  sup-
       ported on Version 7 or BSD versions.

AUTHORS
       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                  menunew(3X)