1 files changed, 3 insertions, 0 deletions

diff --git a/lisp/subr.el b/lisp/subr.el
index e735fd9577d..6c79b3f88e2 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -1884,6 +1884,9 @@ Used from `delayed-warnings-hook' (which see)."
         (push warning collapsed)))
     (setq delayed-warnings-list (nreverse collapsed))))
 
+;; 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
 (defvar delayed-warnings-hook '(collapse-delayed-warnings
                                 display-delayed-warnings)
   "Normal hook run to process delayed warnings.