Buffering BIO docs.

documentation.  We'll work on better documents after the release of
0.9.6.

to the NOTES section, and add references to the functions mentioned
(and perhaps a few more).

American variants.

which is redundant.  They are now in their own document.

Also, in the name section, all the functions described shoud be
enumerated.  This will also make it much simpler to generate softlinks
name like each function to man-pages containing the info.

indent there, especially since the pod2* scripts will regard that as
preformated text.  In one case, indent a code section one step.

Incomplete and possibly inaccurate. Hope somone is
checking these :-)