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

NAME

@@ -60,33 +64,40 @@
        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
+       that it  is  the  responsibility  of  the  application  to
+       release  the memory for the name or the description of the
        item.

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-
+            Routine detected an incorrect or  out-of-range  argu-
             ment.
 
        E_CONNECTED
             Item is connected to a menu.
 
+       E_SYSTEM_ERROR
+            System error occurred (see errno).
+

SEE ALSO

@@ -101,16 +112,18 @@

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.
 
 
+
+                                                          mitem_new(3x)