formnew(3X)                                                      formnew(3X)



NAME
       formnew - create and destroy forms

SYNOPSIS
       ##include <>
       FORM *newform(FIELD **fields);
       int freeform(FORM *form);

DESCRIPTION
       The function newform creates a new form connected to a specified field
       pointer array (which must be NUL-terminated).

       The function freeform disconnects form from its field array and  frees
       the storage allocated for the form.

RETURN VALUE
       The function newform returns NUL on error.

       The function freeform returns one of the following:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

       EBADARGUMENT
            Routine detected an incorrect or out-of-range argument.

       EPOSTED
            The form has already been posted.

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

NOTES
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PORTABILITY
       These routines emulate the System V forms library.  They were not  sup-
       ported on Version 7 or BSD versions.

AUTHORS
       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                  formnew(3X)