fix prototypes and descriptions, remove old stuff no longer present, add some new interfaces, tweak markup, etcetc