Signed-off-by: Cary Phillips <[email protected]>

- All methods now have comments
- Some methods have been rearranged to fit into better logical groups

Still to do:
- Sphinx reports errors on some functions
- half not yet commented

Signed-off-by: Cary Phillips <[email protected]>

Breathe/sphinx ignores @file doxygen comments, so they're now straight
C++ comments intended for the reader of the header file. Where
appropriate, relevent details are covered in the class/function
doxygen comments.

Also restores some comments lost in the translation, and fixes some typos.

Signed-off-by: Cary Phillips <[email protected]>

Signed-off-by: Cary Phillips <[email protected]>