Re: [PATCH] make define-obsolete-* functions compatible with FSF
Michael Sperber writes:
Jeff Sparkes <jsparkes(a)gmail.com> writes:
> I ran into this while updating org-mode. The diff is also attached.
Excellent! Any chance of documentation for WHEN and DOCSTRING? (In
particular, shouldn't it *do* something with WHEN?)
I don't see why. AFAICS WHEN is a typical GNU-style undesigned hack
which only imposes a burden on developers or perhaps the release
engineer.
IIRC some of our define-*-alias functions already have functionality
equivalent to DOCSTRING, which is obviously useful when the API
changes incompatibly.
Ie, what users really need is some *appropriate warning* when we make
these changes. But WHEN doesn't really help with that AFAICS. (I
guess it can be used to make `describe-variable' more verbose, but I'm
not sure what the point is for obsolete variables which are already
marked by `describe-variable'.)
If *we* need to know, most likely the best resource is hg annotate.
I may be missing something, though.
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://lists.xemacs.org/mailman/listinfo/xemacs-patches