+
The form library provides terminal-independent facilities
for composing form screens on character-cell terminals.
The library includes: field routines, which create and
@@ -65,21 +65,32 @@
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.
- Current Default Values for Field Attributes
- 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
+ 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.
+
+
+
+
+ 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
field pointer. Changing this default with a set_ function
- affects future field creations, but does not change the
+ affects future field creations, but does not change the
rendering of fields already created.
- Routine Name Index
- The following table lists each form routine and the name
+
+
+
+ The following table lists each form routine and the name
of the manual page on which it is described.
curses Routine Name Manual Page Name
@@ -105,6 +116,7 @@
field_status form_field_buffer(3x)
field_term form_hook(3x)
field_type form_field_validation(3x)
+
field_userptr form_field_userptr(3x)
form_driver form_driver(3x)
form_fields form_field(3x)
@@ -112,7 +124,6 @@
form_opts form_opts(3x)
form_opts_off form_opts(3x)
form_opts_on form_opts(3x)
-
form_page form_page(3x)
form_request_by_name form_requestname(3x)
form_request_name form_requestname(3x)
@@ -161,16 +172,16 @@
-RETURN VALUE
- 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
+
+ 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
@@ -206,13 +217,7 @@
-SEE ALSO
- curses(3x) and related pages whose names begin "form_" for
- detailed descriptions of the entry points.
-
-
-
-NOTES
+
The header file <form.h> automatically includes the header
files <curses.h> and <eti.h>.
@@ -223,29 +228,44 @@
-PORTABILITY
+
These routines emulate the System V forms library. They
were not supported on Version 7 or BSD versions.
-AUTHORS
+
Juergen Pfeifer. Manual pages and adaptation for ncurses
by Eric S. Raymond.
-SEE ALSO
- This describes ncurses version 5.6 (patch 20080621).
+
+ curses(3x) and related pages whose names begin "form_" for
+ detailed descriptions of the entry points.
+
+ This describes ncurses version 5.9 (patch 20150523).
form(3x)
-
-
-Man(1) output converted with
-man2html
-
+