Doc fixes.

This commit contains fixes to doc strings, both to make the
documentation on godoc.org look nicer, and to follow the rule that the
documentation for a method should start with the method name.

The commit does not change any of the Go code itself.