Tidy up doc blocks.

These kind of changes make tidyier method summaries in apigen.
Fix formatting and expand find() docs.