Tidy up doc blocks.

These kind of changes make tidyier method summaries in apigen.