These checkdoc fixes are mostly converting comments to docstrings for defuns.  A
couple of capitalizations.
This helps with readablility and Emacs Lisp conventions.

Any further checkdoc changes to the docstrings could be separate
patches, such as more systematically capitalizations of args.

Feedback welcome.