Add doc comments and extra guards to bindings

[Mabi19]

This is the doc comments commit cherry-picked out of #127, with a couple extra fixes and an implicit conversion warning added on.

Incidentally, this is my first time using git cherry-pick, but it seems I've done it correctly (I think).