form_new(3X)                                                   form_new(3X)


   NAME
         formnew:  newform, freeform - create and destroy forms

   SYNOPSIS
         #include <form.h>

         FORM *newform(FIELD **fields);
         int freeform(FORM *form);

   DESCRIPTION
         newform creates a new form connected to the designated fields and
         returns a pointer to the form.

         freeform disconnects the form from its associated field pointer
         array and deallocates the space for the form.

   RETURN VALUE
         newform always returns NULL on error.  freeform returns one of the
         following:
         EOK           - The function returned successfully.
         EBADARGUMENT - An argument is incorrect.
         EPOSTED       - The form is posted.

   NOTES
         The header file <form.h> automatically includes the header files
         <eti.h> and <curses.h>.

   SEE ALSO
         curses(3X), forms(3X).
























   8/91                                                                 Page 1