.\" @lbuf_close
.\" @lbuf_free
.\" @lbuf_snarf
+.\" @lbuf_setsize
.\" @lbuf_init
+.\" @lbuf_destroy
.SH "SYNOPSIS"
.nf
.B "#include <mLib/lbuf.h>"
initializes a line buffer ready for use. It is given three arguments:
.TP
.BI "lbuf *" b
-A pointer to the block of memory to use for the line buffer. This is
-all the memory the line buffer requires.
+A pointer to the block of memory to use for the line buffer. The line
+buffer will allocate memory to store incoming data automatically: this
+structure just contains bookkeeping information.
.TP
.BI "void (*" func ")(char *" s ", void *" p )
The
function returns the address and size of a free portion of the line
buffer's memory into which data may be written. The function is passed
the address
-.I l
+.I b
of the line buffer. Its result is the size of the free area, and it
writes the base address of this free space to the location pointed to by
the argument