form_new(3X)                     UNIX System V                     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:
      E_OK           - The function returned successfully.
      E_BAD_ARGUMENT - An argument is incorrect.
      E_POSTED       - 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)

























10/89                                                                    Page 1