Make docstrings comply with emacs standard style, elaborate the
documentation a bit.