X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fmitem_new.3x.html;h=4b6e1f378ba42eedb2224006ab8e7fc7bbaab6ac;hp=40f6e930a4dd059cff7e3ac16dfc3dd88cdf6527;hb=e2d7d0028f4298dca2b0edaf2dc8ce30518d9218;hpb=a8987e73ec254703634802b4f7ee30d3a485524d diff --git a/doc/html/man/mitem_new.3x.html b/doc/html/man/mitem_new.3x.html index 40f6e930..4b6e1f37 100644 --- a/doc/html/man/mitem_new.3x.html +++ b/doc/html/man/mitem_new.3x.html @@ -2,7 +2,7 @@ @@ -41,7 +41,7 @@
 
-mitem_new(3x)                                       mitem_new(3x)
+mitem_new(3x)                                             mitem_new(3x)
 
 
 
@@ -61,35 +61,43 @@
 

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 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

@@ -104,18 +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)
+                                                          mitem_new(3x)