Controversial: Add comments to exported functions for godoc

This has the added benefit of adding additional comments to the documentation generated by go doc.