X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_page.3x.html;h=4a45dd1870775f2341ddc728619f736978f32f79;hp=dafa3f02005cd3ca4bb9f6bef257fb2be287e21c;hb=ed646e3f683083e787c6ba773364401dc9fa9d40;hpb=6208c89f98f1cf9fe0980bd8e791846ce007a13d diff --git a/doc/html/man/form_page.3x.html b/doc/html/man/form_page.3x.html index dafa3f02..4a45dd18 100644 --- a/doc/html/man/form_page.3x.html +++ b/doc/html/man/form_page.3x.html @@ -1,7 +1,7 @@ @@ -41,7 +41,7 @@

form_page 3x

-form_page(3x)                                             form_page(3x)
+form_page(3x)                                                    form_page(3x)
 
 
 
@@ -54,41 +54,40 @@
        #include <form.h>
        int set_current_field(FORM *form, FIELD *field);
        FIELD *current_field(const FORM *);
+       int unfocus_current_field(FORM *form);
        int set_form_page(FORM *form, int n);
        int form_page(const FORM *form);
        int field_index(const FIELD *field);

DESCRIPTION

-       The  function  set_current field sets the current field of
-       the given form; current_field returns the current field of
-       the given form.
+       The  function  set_current_field  sets  the  current field of the given
+       form; current_field returns the current field of the given form.
 
-       The  function  set_form_page  sets  the form's page number
-       (goes to page n of the form).
+       The function unfocus_current_field removes the focus from  the  current
+       field  of  the  form.  In such state, inquiries via current_field shall
+       return a NULL pointer.
 
-       The function form_page returns  the  form's  current  page
-       number.
+       The function set_form_page sets the form's page number (goes to page  n
+       of the form).
 
-       The function field_index returns the index of the field in
-       the field array of the form it is connected to. It returns
-       ERR  if  the  argument is the null pointer or the field is
-       not connected.
+       The function form_page returns the form's current page number.
+
+       The  function  field_index  returns the index of the field in the field
+       array of the form it is connected to. It returns ERR if the argument is
+       the null pointer or the field is not connected.

RETURN VALUE

-       Except for form_page, each routine returns one of the fol-
-       lowing:
+       Except for form_page, each routine returns one of the following:
 
        E_OK The routine succeeded.
 
        E_BAD_ARGUMENT
-            Routine  detected  an incorrect or out-of-range argu-
-            ment.
+            Routine detected an incorrect or out-of-range argument.
 
        E_BAD_STATE
-            Routine was called from an initialization or termina-
-            tion function.
+            Routine was called from an initialization or termination function.
 
        E_INVALID_FIELD
             Contents of a field are not valid.
@@ -105,22 +104,24 @@

NOTES

-       The header file <form.h> automatically includes the header
-       file <curses.h>.
+       The  header  file  <form.h>  automatically  includes  the  header  file
+       <curses.h>.

PORTABILITY

-       These routines emulate the System V forms  library.   They
-       were not supported on Version 7 or BSD versions.
+       These routines emulate the System V forms library.  They were not  sup-
+       ported on Version 7 or BSD versions.
+
+       The unfocus_current_field function is an ncurses extension.

AUTHORS

-       Juergen  Pfeifer.   Manual  pages  and  adaptation for new
-       curses by Eric S. Raymond.
+       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
+       Raymond.
 
 
 
-                                                          form_page(3x)
+                                                                 form_page(3x)