X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fmitem_new.3x.html;h=58ceafa7afec319988a06bceb0d1ce7677f4286c;hp=86603d1abe15f034e135b5e8a7f8301360b7117b;hb=db5f7f4f146a91ba8ec7f1df8e9d7f9d2d7c74fd;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01 diff --git a/doc/html/man/mitem_new.3x.html b/doc/html/man/mitem_new.3x.html index 86603d1a..58ceafa7 100644 --- a/doc/html/man/mitem_new.3x.html +++ b/doc/html/man/mitem_new.3x.html @@ -1,8 +1,7 @@ - + + + mitem_new 3x -

mitem_new 3x

-
+

mitem_new 3x

-
+mitem_new(3x)                                             mitem_new(3x)
+
+
+
-

NAME

+
NAME
        mitem_new - create and destroy menu items
 
 
 

-
SYNOPSIS
+
SYNOPSIS
        #include <menu.h>
        ITEM *new_item(const char *name, const char *description);
        int free_item(ITEM *item);
 
 
 

-
DESCRIPTION
+
DESCRIPTION
        The function new_item allocates a new item and initializes
-       it  from  the name and description pointers. Please notice
-       that the item stores only the pointers  to  the  name  and
+       it from the name and description pointers.  Please  notice
+       that  the  item  stores  only the pointers to the name and
        description. Those pointers must be valid during the life-
-       time of the item. So you  should  be  very  carefull  with
-       names  or descriptions allocated on the stack of some rou-
-       tines.
+       time of the item. So you should be very careful with names
+       or descriptions allocated on the stack of some routines.
        The function free_item de-allocates an item. Please notice
        that  it  is  the  responsibility  of  the  application to
        release the memory for the name or the description of  the
@@ -70,16 +73,21 @@
 
 
 

-
RETURN VALUE
-       The function new_item returns NULL on error.
+
RETURN VALUE
+       The  function  new_item  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_SYSTEM_ERROR
+            System error occurred, e.g., malloc failure.
 
        The function free_item returns one of the following:
 
        E_OK The routine succeeded.
 
-       E_SYSTEM_ERROR
-            System error occurred (see errno).
-
        E_BAD_ARGUMENT
             Routine  detected  an incorrect or out-of-range argu-
             ment.
@@ -87,35 +95,47 @@
        E_CONNECTED
             Item is connected to a menu.
 
+       E_SYSTEM_ERROR
+            System error occurred (see errno).
+
 
 

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

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

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

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

-

-

-Man(1) output converted with
-man2html
-

+

+
+