[Emacs-diffs] Changes to emacs/doc/lispref/advice.texi,v

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      08/10/22 19:53:33

Index: advice.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/advice.texi,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- advice.texi 8 Jan 2008 20:45:51 -0000       1.4
+++ advice.texi 22 Oct 2008 19:53:33 -0000      1.5
@@ -321,19 +321,29 @@
 (@var{name} @var{protected} @var{enabled} @var{definition})
 @end example
 
-Here @var{protected} and @var{enabled} are flags, and @var{definition}
-is the expression that says what the advice should do.  If @var{enabled}
-is @code{nil}, this piece of advice is initially disabled
-(@pxref{Enabling Advice}).
-
-If @var{function} already has one or more pieces of advice in the
-specified @var{class}, then @var{position} specifies where in the list
-to put the new piece of advice.  The value of @var{position} can either
-be @code{first}, @code{last}, or a number (counting from 0 at the
-beginning of the list).  Numbers outside the range are mapped to the
-beginning or the end of the range, whichever is closer.  The
address@hidden value is ignored when redefining an existing piece of
-advice.
address@hidden
+Here, @var{protected} and @var{enabled} are flags; if @var{protected}
+is address@hidden, the advice is protected against non-local exits
+(@pxref{Defining Advice}), and if @var{enabled} is @code{nil} the
+advice is initially disabled (@pxref{Enabling Advice}).
address@hidden should have the form
+
address@hidden
+(advice . @var{LAMBDA})
address@hidden example
+
address@hidden
+where @var{LAMBDA} is a lambda expression that is evaluated to run the
+advice.  @xref{Lambda Expressions}.
+
+If the @var{function} argument to @code{ad-add-advice} already has one
+or more pieces of advice in the specified @var{class}, then
address@hidden specifies where in the list to put the new piece of
+advice.  The value of @var{position} can either be @code{first},
address@hidden, or a number (counting from 0 at the beginning of the
+list).  Numbers outside the range are mapped to the beginning or the
+end of the range, whichever is closer.  The @var{position} value is
+ignored when redefining an existing piece of advice.
 
 If @var{function} already has a piece of @var{advice} with the same
 name, then the position argument is ignored and the old advice is