X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform.3x.html;h=0f1bc621e1de554e406eccc874c44652a8b31eef;hp=fea6d4b36fb6bc529a500113d6f24cb1a3a48962;hb=e2e9c09c48b19b24979cafb2d4864f538b5ddd1c;hpb=027ae42953e3186daed8f3882da73de48291b606;ds=sidebyside diff --git a/doc/html/man/form.3x.html b/doc/html/man/form.3x.html index fea6d4b3..0f1bc621 100644 --- a/doc/html/man/form.3x.html +++ b/doc/html/man/form.3x.html @@ -1,8 +1,7 @@ - +
+ +- form(3x) form(3x) --
+
form - curses extension for programming forms --
+
#include <form.h> --
+
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 +62,30 @@ 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. - 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 + 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 @@ -88,7 +94,7 @@ data_ahead form_data(3x) data_behind form_data(3x) dup_field form_field_new(3x) - dynamic_fieldinfo form_field_info(3x) + dynamic_field_info form_field_info(3x) field_arg form_field_validation(3x) field_back form_field_attributes(3x) field_buffer form_field_buffer(3x) @@ -105,14 +111,15 @@ 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_driver_w form_driver(3x)* form_fields form_field(3x) form_init form_hook(3x) 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) @@ -160,17 +167,16 @@ unpost_form form_post(3x) --
- 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 @@ -205,14 +211,7 @@ The form driver code saw an unknown request code. --
- 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>. @@ -222,30 +221,42 @@ using most linkers). --
+
These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions. --
+
Juergen Pfeifer. Manual pages and adaptation for ncurses by Eric S. Raymond. --
- This describes ncurses version 5.5 (patch 20061209). +
+ curses(3x) and related pages whose names begin "form_" for + detailed descriptions of the entry points. + + This describes ncurses version 6.0 (patch 20160910). form(3x)-