[Emacs-diffs] /srv/bzr/emacs/trunk r107127: * doc/lispref/modes.texi (Running Hooks): Mention run-hook-wrapped.

[Glenn Morris]

------------------------------------------------------------
revno: 107127
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sun 2012-02-05 16:58:38 -0800
message:
  * doc/lispref/modes.texi (Running Hooks): Mention run-hook-wrapped.
  * etc/NEWS: Related edit.
modified:
  doc/lispref/ChangeLog
  doc/lispref/modes.texi
  etc/NEWS

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-02-06 00:48:02 +0000
+++ b/doc/lispref/ChangeLog     2012-02-06 00:58:38 +0000
@@ -1,5 +1,7 @@
 2012-02-06  Glenn Morris  <address@hidden>
 
+       * modes.texi (Running Hooks): Mention run-hook-wrapped.
+
        * control.texi (Handling Errors):
        Mention condition-case-no-debug and with-demoted-errors.
 

=== modified file 'doc/lispref/modes.texi'
--- a/doc/lispref/modes.texi    2012-02-04 20:59:54 +0000
+++ b/doc/lispref/modes.texi    2012-02-06 00:58:38 +0000
@@ -163,6 +163,14 @@
 default definition (by not calling @var{fun}).
 @end defmac
 
address@hidden run-hook-wrapped hook wrap-function &rest args
+This function is similar to @code{run-hook-with-args-until-success}.
+Like that function, it runs the functions on the abnormal hook
address@hidden, stopping at the first one that returns address@hidden
+Instead of calling the hook functions directly, though, it actually
+calls @code{wrap-function} with arguments @code{fun} and @code{args}.
address@hidden defun
+
 @node Setting Hooks
 @subsection Setting Hooks
 

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-02-06 00:48:02 +0000
+++ b/etc/NEWS  2012-02-06 00:58:38 +0000
@@ -1236,8 +1236,12 @@
 
 ** New hook types
 
++++
 *** New function `run-hook-wrapped' for running an abnormal hook by
 passing the hook functions as arguments to a "wrapping" function.
+Like `run-hook-with-args-until-success', it stops at the first
+non-nil retun value.
+
 +++
 *** New macro `with-wrapper-hook' for running an abnormal hook as a
 set of "wrapping" filters, similar to around advice.