menu_item_new(3X)                                         menu_item_new(3X)


   NAME
         menuitemnew:  newitem, freeitem - create and destroy menus items

   SYNOPSIS
         #include <menu.h>

         ITEM *newitem(char *name, char *desc);
         int freeitem(ITEM *item);

   DESCRIPTION
         newitem creates a new item from name and description, and returns a
         pointer to the new item.

         freeitem frees the storage allocated for item.  Once an item is
         freed, the user can no longer connect it to a menu.

   RETURN VALUE
         newitem returns NULL on error.

         freeitem returns one of the following:
         EOK           - The routine returned successfully.
         ESYSTEMERROR - System error.
         EBADARGUMENT - An incorrect argument was passed to the routine.
         ECONNECTED    - One or more items are already connected
                          to another menu.

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

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





















   8/91                                                                 Page 1