Make docstrings comply with emacs standard style

Also elaborate the documentation a bit.