X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fmitem_new.3x.html;h=43da44904b749fa6e806a5fafe7286829ffb66d5;hp=9918f6cf908626a219cf9e5f55acd69042f4c275;hb=302a066a01e4de40f08b397e87ca0e97f20870a7;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/doc/html/man/mitem_new.3x.html b/doc/html/man/mitem_new.3x.html index 9918f6cf..43da4490 100644 --- a/doc/html/man/mitem_new.3x.html +++ b/doc/html/man/mitem_new.3x.html @@ -1,82 +1,133 @@ + + + + + +mitem_new 3x + + + +

mitem_new 3x

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

NAME

-       mitem_new - create and destroy menu items
 
 
-
-

SYNOPSIS

-       #include <menu.h>
+
+

NAME

+       new_item, free_item - create and destroy menu items
+
+
+

SYNOPSIS

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

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
+

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
        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.
-       The function free_item de-allocates an item. Please notice
+       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
        item.
 
 
-
-

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

SEE ALSO

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

SEE ALSO

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

NOTES

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

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