Please find attached a documentation patch for consideration.  This
implements some suggestions from M-x checkdoc.

Any feedback welcome.

Jeremy