[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/doc/lispref/advice.texi,v
From: |
Chong Yidong |
Subject: |
[Emacs-diffs] Changes to emacs/doc/lispref/advice.texi,v |
Date: |
Wed, 22 Oct 2008 19:53:34 +0000 |
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
- [Emacs-diffs] Changes to emacs/doc/lispref/advice.texi,v,
Chong Yidong <=