add buffer_putsa, buffer_get_token_sa, buffer_getline_sa, stralloc_chomp

and stralloc_chop

buffer/buffer_get_token_sa.3

@@ -0,0 +1,23 @@
+.TH buffer_get_token_sa 3
+.SH NAME
+buffer_get_token_sa \- read token from buffer
+.SH SYNTAX
+.nf
+.B #include <stralloc.h>
+.B #include <buffer.h>
+
+int \fBbuffer_get_token_sa\fP(buffer* \fIb\fR,stralloc* \fIsa\fR,
+                    const char* \fIcharset\fR,unsigned int \fIsetlen\fR);
+.SH DESCRIPTION
+buffer_get_token_sa copies data from the \fIb\fR to \fIsa\fR until one
+of the delimiters in \fIcharset\fR is found, overwriting the previous
+content of \fIsa\fR.  That delimiter is also appended to \fIsa\fR.
+
+If reading from the buffer or allocating memory fails,
+buffer_get_token_sa returns -1 and sets \fIerrno\fR appropriately.  At
+that point \fIsa\fR may be empty or it may already contain a partial
+token.
+
+On success, buffer_get_token_sa returns 0.
+.SH "SEE ALSO"
+buffer_getline_sa(3), buffer_get_token(3), buffer(3)