[Emacs-diffs] /srv/bzr/emacs/trunk r107198: * etc/NEWS: Edit delayed-warnings-list entry.

[Glenn Morris]

------------------------------------------------------------
revno: 107198
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Wed 2012-02-08 22:02:33 -0800
message:
  * etc/NEWS: Edit delayed-warnings-list entry.
  * lisp/subr.el: Related comment.
modified:
  etc/NEWS
  lisp/subr.el

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-02-09 05:57:15 +0000
+++ b/etc/NEWS  2012-02-09 06:02:33 +0000
@@ -1459,8 +1459,14 @@
 ** New variable `revert-buffer-in-progress-p' is true while a buffer is
 being reverted, even if the buffer has a local `revert-buffer-function'.
 
-** New variables `delayed-warnings-list' and `delayed-warnings-hook' allow
-deferring warnings until the main command loop is executed.
+---
+** New variables `delayed-warnings-list' and `delayed-warnings-hook'.
+If delayed-warnings-list is non-nil, the command loop calls
+delayed-warnings-hook after post-command-hook.  At present, this is
+only used by Emacs on some platforms to display warnings during
+startup, which might otherwise not be noticed.  This uses the functions
+display-delayed-warnings and collapse-delayed-warnings.
+
 
 +++
 ** `set-auto-mode' now respects mode: local variables at the end of files,

=== modified file 'lisp/subr.el'
--- a/lisp/subr.el      2012-02-04 20:59:54 +0000
+++ b/lisp/subr.el      2012-02-09 06:02:33 +0000
@@ -1884,6 +1884,9 @@
         (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.