X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_field_new.3x.html;h=b266a7e956b0fb904d26b92e9bc4e962cf57ec26;hp=911c10712c97fc6532c603bbb36c72ec71292aa7;hb=2a32bee362db64f5a06b2124976b928ac3faa578;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/doc/html/man/form_field_new.3x.html b/doc/html/man/form_field_new.3x.html index 911c1071..b266a7e9 100644 --- a/doc/html/man/form_field_new.3x.html +++ b/doc/html/man/form_field_new.3x.html @@ -1,8 +1,7 @@ - + + + form_field_new 3x -

form_field_new 3x

-
+

form_field_new 3x

-
 form_field_new(3x)                                   form_field_new(3x)
 
 
 
 
-
-

NAME

-       form_field_new - create and destroy form fields
+

NAME

+       new_field,  dup_field, link_field, free_field - create and
+       destroy form fields
 
 
-
-

SYNOPSIS

+

SYNOPSIS

        #include <form.h>
        FIELD *new_field(int height, int width,
                         int toprow, int leftcol,
@@ -62,11 +61,10 @@
        int free_field(FIELD *field);
 
 
-
-

DESCRIPTION

-       The  function new_field allocates a new field and initial-
-       izes it from the parameters given: height, width,  row  of
-       upper-left  corner,  column  of  upper-left corner, number
+

DESCRIPTION

+       The function new_field allocates a new field and  initial-
+       izes  it  from the parameters given: height, width, row of
+       upper-left corner, column  of  upper-left  corner,  number
        off-screen rows, and number of additional working buffers.
 
        The  function  dup_field duplicates a field at a new loca-
@@ -84,58 +82,69 @@
        with a field.
 
 
-
-

RETURN VALUE

+

RETURN VALUE

        The function, new_field, dup_field, link_field return NULL
-       on error.
-
-       The function free_field returns one of the following:
+       on error.  They set errno according to their success:
 
        E_OK The routine succeeded.
 
+       E_BAD_ARGUMENT
+            Routine detected an incorrect or  out-of-range  argu-
+            ment.
+
        E_SYSTEM_ERROR
-            System error occurred (see errno).
+            System error occurred, e.g., malloc failure.
+
+       The function free_field returns one of the following:
+
+       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_CONNECTED
+            field is connected.
 
-
-

SEE ALSO

+
+

SEE ALSO

        curses(3x), form(3x).
 
 
-
-

NOTES

+

NOTES

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

PORTABILITY

-       These routines emulate the System V forms  library.   They
+

PORTABILITY

+       These  routines  emulate the System V forms library.  They
        were not supported on Version 7 or BSD versions.
 
-       It  may be unwise to count on the set of attributes copied
-       by  dup_field(3x)  being  portable;  the  System  V  forms
-       library  documents  are  not very explicit about what gets
-       copied and what doesn't.
+       It may be unwise to count on the set of attributes  copied
+       by  dup_field  being  portable; the System V forms library
+       documents are not very explicit about what gets copied and
+       what does not.
 
 
-
-

AUTHORS

-       Juergen Pfeifer.  Manual  pages  and  adaptation  for  new
+

AUTHORS

+       Juergen  Pfeifer.   Manual  pages  and  adaptation for new
        curses by Eric S. Raymond.
 
 
 
                                                      form_field_new(3x)
-
-
-Man(1) output converted with -man2html -
+
+ +