X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_field_new.3x.html;h=2c97459631975eca3987574a7fe5918e41fff877;hp=911c10712c97fc6532c603bbb36c72ec71292aa7;hb=761e4f0825b330e970558e82a4bd638383914429;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8
diff --git a/doc/html/man/form_field_new.3x.html b/doc/html/man/form_field_new.3x.html
index 911c1071..2c974596 100644
--- a/doc/html/man/form_field_new.3x.html
+++ b/doc/html/man/form_field_new.3x.html
@@ -1,8 +1,8 @@
-
+
@@ -69,37 +69,46 @@
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-
- tion. Most attributes (including current contents, size,
- validation type, buffer count, growth threshold, justifi-
- cation, foreground, background, pad character, options,
- and user pointer) are copied. Field status and the field
+ The function dup_field duplicates a field at a new loca-
+ tion. Most attributes (including current contents, size,
+ validation type, buffer count, growth threshold, justifi-
+ cation, foreground, background, pad character, options,
+ and user pointer) are copied. Field status and the field
page bit are not copied.
- The function link_field acts like dup_field, but the new
- field shares buffers with its parent. Attribute data is
+ The function link_field acts like dup_field, but the new
+ field shares buffers with its parent. Attribute data is
separate.
- The function free_field de-allocates storage associated
+ The function free_field de-allocates storage associated
with a field.
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-
ment.
+ E_CONNECTED
+ field is connected.
+
SEE ALSO
@@ -118,9 +127,9 @@
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.
+ by dup_field being portable; the System V forms library
+ documents are not very explicit about what gets copied and
+ what does not.