X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fmitem_new.3x.html;h=927c3d075e4887010ad3bb0525f68b7e13e0abe5;hp=86603d1abe15f034e135b5e8a7f8301360b7117b;hb=761e4f0825b330e970558e82a4bd638383914429;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01;ds=sidebyside diff --git a/doc/html/man/mitem_new.3x.html b/doc/html/man/mitem_new.3x.html index 86603d1a..927c3d07 100644 --- a/doc/html/man/mitem_new.3x.html +++ b/doc/html/man/mitem_new.3x.html @@ -1,8 +1,8 @@ - + @@ -41,6 +41,10 @@ 
 
+mitem_new(3x)                                             mitem_new(3x)
+
+
+

NAME

@@ -57,12 +61,11 @@

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
@@ -71,15 +74,20 @@

RETURN VALUE

-       The function new_item returns NULL on error.
+       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,6 +95,9 @@
        E_CONNECTED
             Item is connected to a menu.
 
+       E_SYSTEM_ERROR
+            System error occurred (see errno).
+

SEE ALSO

@@ -111,6 +122,8 @@
        curses by Eric S. Raymond.
 
 
+
+                                                          mitem_new(3x)