Lots of new inline documentation is goin …

Lots of new inline documentation is going in courtesy of Jacob Santos.

#phpdoc