Review and update the exported API documentation

[masih]

Review all the API docs, make sure all the exported APIs have documentation and follow the golang conventions (i.e. start with the API name). Check that lists are rendered correctly in godoc, i.e. are prefixed with enough spaces.