Fix some omissions and mistakes in the API docs.

Hi,

Does what it says. I haven't actually rebuilt the docs but I'm pretty sure I didn't hose anything ...

Cheers,

Peter