RE: defcustom and the stars.

[Drew Adams]

>     +               ;; If DOC starts with a `*' remove it.
>     +               (when (eq (aref doc 0) ?*)
>     +                 (setq doc (substring doc 1)))
>
> might be ok, but I am not sure it is really right -- it seems
> like a hard question.  So I would rather leave this alone, for now.

Yes. Here is a doc string I have, for instance.

 "**Completions* window is removed if fewer chars than this are input."

Perhaps vanilla Emacs would never have such a doc string, but why invite
trouble? Why not just leave any extra `*' there? What's the harm?