As discussed devel.  Feedback appreciated as I'm not accustomed to
writing docstrings for Emacs functions.