Mention some missing libevent macros.

ok jmc@, benno@, "yes" deraadt@

add missing and correct misspelled names, most in NAME sections;
found with regress/usr.bin/mandoc/db/dbm_dump;
OK jmc@

evbuffer_read will return 0 one an end of file condition.

zap some stray commas;

add evbuffer_expand to NAME;

document the only macro i find useful when working with evbuffers.

im not good at grammar things.

from schwarze@

use .Va to say errno is a variable.

from schwarze@

fix erroneous capitalisation of a word in the middle of a sentence.

from schwarze again

less worse escapes for \ from ingo. im sure there's a much nicer way to
represent newlines still.

use .In to specify includes.

ingo also points out we're documenting things that work with
evbuffers, not evbufbuffers.

ingo points out

.Fo evbuffer_readln
.Fa "struct evbuffer *buf"
.Fa "size_t *read_out"
.Fa "enum evbuffer_eol_style eol_style"
.Fc

is more readable mdoc for very long prototypes than lines like

.Fn

ingo points out

.Fo evbuffer_readln
.Fa "struct evbuffer *buf"
.Fa "size_t *read_out"
.Fa "enum evbuffer_eol_style eol_style"
.Fc

is more readable mdoc for very long prototypes than lines like

.Fn "evbuffer_readln" "struct evbuffer *buf" "size_t *read_out" "enum evbuffer_eol_style eol_style"

show more ...

i got sick of having to read the source code to know what the
evbuffer_foo functions do. reyk, nicm, jmc, and schwarze seem to
support a manpage as a reasonable solution to this problem.

im putting

i got sick of having to read the source code to know what the
evbuffer_foo functions do. reyk, nicm, jmc, and schwarze seem to
support a manpage as a reasonable solution to this problem.

im putting this in a separate manpage because i find they get too
cumbersome when they get too big. ingo agrees (and suggests even
this might be too big).

the file is evbuffer_new.3 rather than evbuffer.3 because we document
functions.

ok reyk@ nicm@ jmc@ schwarze@
this is rough, everyone has tweaks coming.

show more ...