The form library provides terminal-independent facilities
for composing form screens on character-cell terminals.
The library includes: field routines, which create and
@@ -65,112 +62,122 @@
into forms, display forms on the screen, and handle inter-
action with the user.
- The form library uses the curses libraries, and a curses
- initialization routine such as initscr must be called
- before using any of these functions. To use the form
- library, link with the options -lform-lcurses.
+ The form library uses the curses libraries. To use the
+ form library, link with the options -lform-lcurses.
+
+ Your program should set up the locale, e.g.,
+
+ setlocale(LC_ALL,"");
+
+ so that input/output processing will work.
+
+ A curses initialization routine such as initscr must be
+ called before using any of these functions.
- CurrentDefaultValuesforFieldAttributes
- The form library maintains a default value for field
- attributes. You can get or set this default by calling
- the appropriate set_ or retrieval routine with a NULL
+
+
+ Routines that return pointers return NULL on error, and
+ set errno to the corresponding error-code returned by
+ functions returning an integer. Routines that return an
integer return one of the following error codes:
E_OK The routine succeeded.
E_BAD_ARGUMENT
- Routine detected an incorrect or out-of-range argu-
+ Routine detected an incorrect or out-of-range argu-
ment.
E_BAD_STATE
@@ -205,47 +212,55 @@
The form driver code saw an unknown request code.
-
-
SEE ALSO
- curses(3x) and related pages whose names begin "form_" for
- detailed descriptions of the entry points.
-
-
-
The header file <form.h> automatically includes the header
files <curses.h> and <eti.h>.
In your library list, libform.a should be before libn-
- curses.a; that is, you want to say `-lform -lncurses', not
+ curses.a; that is, you want to say "-lform -lncurses", not
the other way around (which would give you a link error
- using most linkers).
+ when using static libraries).
-
These routines emulate the System V forms library. They
were not supported on Version 7 or BSD versions.
+ A few functions are extensions added for ncurses, e.g.,
+ form_driver_w, unfocus_current_field.
-
-
AUTHORS
- Juergen Pfeifer. Manual pages and adaptation for ncurses
+
+
+ curses(3x) and related pages whose names begin "form_" for
+ detailed descriptions of the entry points.
+
+ This describes ncurses version 6.0 (patch 20170304).
form(3x)