[Emacs-diffs] Changes to emacs/lispref/advice.texi [lexbind]

[Miles Bader]

Index: emacs/lispref/advice.texi
diff -c emacs/lispref/advice.texi:1.13.8.2 emacs/lispref/advice.texi:1.13.8.3
*** emacs/lispref/advice.texi:1.13.8.2  Tue Oct 14 23:10:11 2003
--- emacs/lispref/advice.texi   Fri Oct 29 02:05:13 2004
***************
*** 51,57 ****
  
    Suppose you wanted to add a similar feature to @code{previous-line},
  which would insert a new line at the beginning of the buffer for the
! command to move to.  How could you do this?
  
    You could do it by redefining the whole function, but that is not
  modular.  The advice feature provides a cleaner alternative: you can
--- 51,58 ----
  
    Suppose you wanted to add a similar feature to @code{previous-line},
  which would insert a new line at the beginning of the buffer for the
! command to move to (when @code{next-line-add-newlines} is
! address@hidden).  How could you do this?
  
    You could do it by redefining the whole function, but that is not
  modular.  The advice feature provides a cleaner alternative: you can
***************
*** 273,281 ****
  searches when the original definition of @code{foo} is run.
  
  @defvar ad-do-it
! This is not really a variable, but it is somewhat used like one
! in around-advice.  It specifies the place to run the function's
! original definition and other ``earlier'' around-advice.
  @end defvar
  
  If the around-advice does not use @code{ad-do-it}, then it does not run
--- 274,282 ----
  searches when the original definition of @code{foo} is run.
  
  @defvar ad-do-it
! This is not really a variable, rather a place-holder that looks like a
! variable.  You use it in around-advice to specify the place to run the
! function's original definition and other ``earlier'' around-advice.
  @end defvar
  
  If the around-advice does not use @code{ad-do-it}, then it does not run
***************
*** 360,369 ****
  This command activates all the advice defined for @var{function}.
  @end deffn
  
! To activate advice for a function whose advice is already active is not
! a no-op.  It is a useful operation which puts into effect any changes in
! that function's advice since the previous activation of advice for that
! function.
  
  @deffn Command ad-deactivate function
  This command deactivates the advice for @var{function}.
--- 361,369 ----
  This command activates all the advice defined for @var{function}.
  @end deffn
  
!   Activating advice does nothing if @var{function}'s advice is already
! active.  But if there is new advice, added since the previous time you
! activated advice for @var{function}, it activates the new advice.
  
  @deffn Command ad-deactivate function
  This command deactivates the advice for @var{function}.
***************
*** 430,436 ****
  that results from activating advice for a function.
  
  A value of @code{always} specifies to compile unconditionally.
! A value of @code{nil} specifies never compile the advice.
  
  A value of @code{maybe} specifies to compile if the byte-compiler is
  already loaded.  A value of @code{like-original} specifies to compile
--- 430,436 ----
  that results from activating advice for a function.
  
  A value of @code{always} specifies to compile unconditionally.
! A value of @code{never} specifies never compile the advice.
  
  A value of @code{maybe} specifies to compile if the byte-compiler is
  already loaded.  A value of @code{like-original} specifies to compile