On 18 Mar 2002, Stephen J. Turnbull wrote:
Simon> I can't find anything similar in XEmacs, but I
think it
Simon> would be nice if the same docstring rules applied to both
Simon> emacsen. Maybe the above could be added to the XEmacs
Simon> elisp manual?
Really we should fix the idea of * globally then. The definition of *
says it marks user options. I have used this distinction in a
different way for customizable variables elsewhere (I have some alists
that normally users should not play with, which are customizable
because _I_ need to play with them, but not marked with a *). I don't
see why not having a * should prevent set-variable from being used. I
don't see why Boolean variables which could plausibly be set with
set-variable should necessarily have them.
So this is very confusing.
Yes. I brought this up with the patch for browse-url.el for Emacs as
well, maybe the current documentation isn't as clear as I thought. Let's
see if anyone in the Emacs camp has any opinion. I don't really care, as
long as it is consistent. One solution might be to drop this * stuff
alltogheter, it seems to serve little purpose.