some comment fixes suggested by godoc lint