Update documentation to be closer to Emacs conventions

This patch changes the documentation strings to be closer to
conventions listed in “D.6 Tips for Documentation Strings” of the
Emacs Lisp manual.  It also corrects the capitalization of ‘Lisp’ in
one comment.