X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fmenu_new.3x.html;h=10f30e775413e64fd52ba561a0e20d6c51538cfe;hp=33e39ad9d4457848702ea3c0a69af3c1a059f0eb;hb=e6f4ffe150c7d919792f29a70b4f031cfab5ef06;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/doc/html/man/menu_new.3x.html b/doc/html/man/menu_new.3x.html index 33e39ad9..10f30e77 100644 --- a/doc/html/man/menu_new.3x.html +++ b/doc/html/man/menu_new.3x.html @@ -1,77 +1,124 @@ + + + +menu_new 3x + + + +

menu_new 3x

+
 
+menu_new(3x)                                               menu_new(3x)
+
+
+

NAME

-       menu_new - create and destroy menus
+       menu_new - create and destroy menus

SYNOPSIS

-       #include <menu.h>
+       #include <menu.h>
        MENU *new_menu(ITEM **items);
        int free_menu(MENU *menu);

DESCRIPTION

-       The  function  new_menu  creates a new menu connected to a
-       specified item pointer array (which  must  be  NULL-termi-
+       The  function  new_menu  creates a new menu connected to a
+       specified item pointer array (which  must  be  NULL-termi-
        nated).
 
-       The  function  free_menu  disconnects  menu  from its item
+       The  function  free_menu  disconnects  menu  from its item
        array and frees the storage allocated for the menu.

RETURN VALUE

-       The function new_menu returns NULL on error.
+       The function new_menu returns  NULL  on  error.   It  sets
+       errno according to the function's failure:
+
+       E_NOT_CONNECTED
+            No items are connected to the menu.
 
-       The function free_menu returns one of the following:
+       E_SYSTEM_ERROR
+            System error occurred, e.g., malloc failure.
 
-       E_OK The routine succeeded.
+       The function free_menu returns one of the following:
 
-       E_SYSTEM_ERROR
-            System error occurred (see errno).
+       E_OK The routine succeeded.
 
-       E_BAD_ARGUMENT
-            Routine detected an incorrect or  out-of-range  argu-
+       E_SYSTEM_ERROR
+            System error occurred (see errno).
+
+       E_BAD_ARGUMENT
+            Routine  detected  an incorrect or out-of-range argu-
             ment.
 
-       E_POSTED
+       E_POSTED
             The menu has already been posted.

SEE ALSO

-       curses(3x), menu(3x).
+       curses(3x), menu(3x).

NOTES

-       The header file <menu.h> automatically includes the header
-       file <curses.h>.
+       The header file <menu.h> automatically includes the header
+       file <curses.h>.

PORTABILITY

-       These routines emulate the System V  menu  library.   They
+       These  routines  emulate  the System V menu library.  They
        were not supported on Version 7 or BSD versions.

AUTHORS

-       Juergen  Pfeifer.   Manual  pages  and  adaptation for new
+       Juergen Pfeifer.  Manual  pages  and  adaptation  for  new
        curses by Eric S. Raymond.
 
 
 
-
-
-
-
+                                                           menu_new(3x)