X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_new.3x.html;h=8bcc99067a0921ad8e7cac644713da7e17bf470e;hp=7b0d91bbdd073ce8a1b17fa48305f909ecc32f81;hb=b0b1980be11bba618d84beb8b30ac94e2c820602;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/doc/html/man/form_new.3x.html b/doc/html/man/form_new.3x.html index 7b0d91bb..8bcc9906 100644 --- a/doc/html/man/form_new.3x.html +++ b/doc/html/man/form_new.3x.html @@ -1,58 +1,111 @@ + + + +form_new 3x + + + +

form_new 3x

 
+form_new(3x)                                               form_new(3x)
+
+
+

NAME

-       form_new - create and destroy forms
+       form_new - create and destroy forms

SYNOPSIS

-       #include <form.h>
+       #include <form.h>
        FORM *new_form(FIELD **fields);
        int free_form(FORM *form);

DESCRIPTION

-       The  function  new_form  creates a new form connected to a
-       specified field pointer array (which must  be  NULL-termi-
+       The  function  new_form  creates a new form connected to a
+       specified field pointer array (which must  be  NULL-termi-
        nated).
 
-       The  function  free_form  disconnects  form from its field
+       The  function  free_form  disconnects  form from its field
        array and frees the storage allocated for the form.

RETURN VALUE

-       The function new_form returns NULL on error.
+       The function new_form returns  NULL  on  error.   It  sets
+       errno according to the function's success:
+
+       E_OK The routine succeeded.
+
+       E_BAD_ARGUMENT
+            Routine  detected  an incorrect or out-of-range argu-
+            ment.
+
+       E_CONNECTED
+            The field is already connected to a form.
 
-       The function free_form returns one of the following:
+       E_SYSTEM_ERROR
+            System error occurred, e.g., malloc failure.
 
-       E_OK The routine succeeded.
+       The function free_form returns one of the following:
 
-       E_SYSTEM_ERROR
-            System error occurred (see errno).
+       E_OK The routine succeeded.
 
-       E_BAD_ARGUMENT
+       E_BAD_ARGUMENT
             Routine detected an incorrect or  out-of-range  argu-
             ment.
 
-       E_POSTED
+       E_POSTED
             The form has already been posted.

NOTES

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

@@ -68,15 +121,9 @@ - - - - + form_new(3x)

-Man(1) output converted with -man2html -