X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fmenu_new.3x.html;h=0d6e9fb4dc89b0d8391ca2f22182570275797b6b;hp=33e39ad9d4457848702ea3c0a69af3c1a059f0eb;hb=ed646e3f683083e787c6ba773364401dc9fa9d40;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/doc/html/man/menu_new.3x.html b/doc/html/man/menu_new.3x.html index 33e39ad9..0d6e9fb4 100644 --- a/doc/html/man/menu_new.3x.html +++ b/doc/html/man/menu_new.3x.html @@ -1,82 +1,126 @@ + + + + + +menu_new 3x + + + +

menu_new 3x

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

NAME

-       menu_new - create and destroy menus
 
 
-
-

SYNOPSIS

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

NAME

+       new_menu, free_menu - create and destroy menus
 
-
-

DESCRIPTION

-       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
-       array and frees the storage allocated for the menu.
+

SYNOPSIS

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

RETURN VALUE

-       The function new_menu returns NULL on error.
+

DESCRIPTION

+       The  function new_menu creates a new menu connected to a specified item
+       pointer array (which must be NULL-terminated).
 
-       The function free_menu returns one of the following:
+       The function free_menu disconnects menu from its item array  and  frees
+       the storage allocated for the menu.
 
-       E_OK The routine succeeded.
 
-       E_SYSTEM_ERROR
-            System error occurred (see errno).
+

RETURN VALUE

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

SEE ALSO

-       curses(3x), menu(3x).
+       E_OK The routine succeeded.
 
+       E_SYSTEM_ERROR
+            System error occurred (see errno).
 
-
-

NOTES

-       The header file <menu.h> automatically includes the header
-       file <curses.h>.
+       E_BAD_ARGUMENT
+            Routine detected an incorrect or out-of-range argument.
 
+       E_POSTED
+            The menu has already been posted.
 
-
-

PORTABILITY

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

SEE ALSO

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

AUTHORS

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

NOTES

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

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.
 
 
 
+                                                                  menu_new(3x)
-
-
-Man(1) output converted with -man2html -
+
+ +