Get caught up on some documentation, reflecting the work we are doing.

Especially README and sample.ebrc, which were many versions out of date.
Credit to Adam in the users guide, and finally get Cleverson's name
and email right.
CHANGES describe the changes for the next version.