summaryrefslogtreecommitdiff
path: root/lib/libform/form_field_buffer.3
diff options
context:
space:
mode:
authorblymn <blymn@NetBSD.org>2004-11-24 11:57:09 +0000
committerblymn <blymn@NetBSD.org>2004-11-24 11:57:09 +0000
commit19f07fb20adbf5bb99b42a09aaa70e4f80f5690b (patch)
tree12944085309802e6591559e6f71cf8e6f4d30b08 /lib/libform/form_field_buffer.3
parent3aeabb25dc645ec6d30e2ddbbe53b47c44eecb77 (diff)
* Rewrote internal handling of multiline field line data to fix a bug
where a newly opened line would immediately get wrapped out of existence. The old method of handling lines in a multiline field did not cope with this elegantly. * Added new field flag O_REFORMAT which, when set, returns the field buffer with newlines inserted where the line wrapped. Previously, there was no way of preserving the on screen format of a multiline field. * Added new file gdbinit which contains a macro to verify and print the multiline field line data structure. * Bumped libform major number due to changes in the _form_field structure.
Diffstat (limited to 'lib/libform/form_field_buffer.3')
-rw-r--r--lib/libform/form_field_buffer.39
1 files changed, 8 insertions, 1 deletions
diff --git a/lib/libform/form_field_buffer.3 b/lib/libform/form_field_buffer.3
index e83b8a0ffca..d23fa9d90a0 100644
--- a/lib/libform/form_field_buffer.3
+++ b/lib/libform/form_field_buffer.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: form_field_buffer.3,v 1.8 2003/04/16 13:35:02 wiz Exp $
+.\" $NetBSD: form_field_buffer.3,v 1.9 2004/11/24 11:57:09 blymn Exp $
.\"
.\" Copyright (c) 2001
.\" Brett Lymn - blymn@baea.com.au, brett_lymn@yahoo.com.au
@@ -62,6 +62,13 @@ function returns the contents of the buffer number specified by
for the given field.
If the requested buffer number exceeds the
number of buffers attached to the field then NULL will be returned.
+If the field option O_REFORMAT is enabled on the given field then
+storage will be allocated to hold the reformatted buffer.
+This storage must be release by calling
+.Xr free 3
+when it is no longer required.
+If the O_REFORMAT field option is not set then no extra storage is
+allocated.
The field buffer may be set by calling
.Fn set_field_buffer
which will set the given buffer number to the contents of the string