Re: delayed-warnings-list and delayed-warnings-hook

[Chong Yidong <cyd@gnu.org>]

Juanma Barranquero <lekktu@gmail.com> writes:

>> Is there any reason the NEWS entry for this is tagged `---'?  As far as
>> I can tell, it is an ordinary new feature and should be documented.
>
> Glenn added the --- and the following comment in the code:
>
> +;; At present this is only really useful for Emacs internals.
> +;; Document in the lispref if it becomes generally useful.
> +;; Ref http://lists.gnu.org/archive/html/emacs-devel/2012-02/msg00085.html
>
> It is only used for Emacs internals, but I think it is useful in general.

`delayed-warnings-list' should certainly be documented; I will work on
that.

As for `delayed-warnings-hook', maybe we should mark it explicitly as
internal, because it seems a bit delicate with respect to third party
usage.  Because of the default value (collapse-delayed-warnings
display-delayed-warnings), in order not to deal with uncollapsed
messages, third party code needs to append to the hook, and must not
prepend to it.  But this makes it difficult for one third party package
to give its function priority over other third party packages.  This
design kind of bothers me.

To clarify the situation a little, could you explain what kind of
functions you envision third party code adding to this hook?