Make sure all public methods are documented

[slarson]

Go through the source and add any explanations to any public methods (those not starting with '_') that ended up undocumented.