[Emacs-diffs] /srv/bzr/emacs/trunk r110758: * doc/misc/cl.texi (Modify Macros, Function Bindings): Add some xrefs.

[Glenn Morris]

------------------------------------------------------------
revno: 110758
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Wed 2012-10-31 17:04:28 -0400
message:
  * doc/misc/cl.texi (Modify Macros, Function Bindings): Add some xrefs.
modified:
  doc/misc/ChangeLog
  doc/misc/cl.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2012-10-31 21:02:51 +0000
+++ b/doc/misc/ChangeLog        2012-10-31 21:04:28 +0000
@@ -7,6 +7,7 @@
        (Obsolete Lexical Binding): Rename section from "Lexical Bindings".
        (Obsolete Macros): Rename section from "Obsolete Lexical Macros".
        Reword, and add details of flet and labels.
+       (Modify Macros, Function Bindings): Add some xrefs.
 
 2012-10-30  Glenn Morris  <address@hidden>
 

=== modified file 'doc/misc/cl.texi'
--- a/doc/misc/cl.texi  2012-10-31 19:23:06 +0000
+++ b/doc/misc/cl.texi  2012-10-31 21:04:28 +0000
@@ -1193,6 +1193,9 @@
 bound on entry, it is simply made unbound by @code{makunbound} or
 @code{fmakunbound} on exit.
 @end ignore
+
+Note that the @file{cl.el} version of this macro behaves slightly
+differently.  @xref{Obsolete Macros}.
 @end defmac
 
 @defmac cl-letf* (address@hidden) address@hidden
@@ -1283,11 +1286,13 @@
 the old function definition, or lack thereof, is restored.
 
 You can use @code{cl-flet} to disable or modify the behavior of a
-function in a temporary fashion.  This will even work on Emacs
-primitives, although note that some calls to primitive functions
-internal to Emacs are made without going through the symbol's
-function cell, and so will not be affected by @code{cl-flet}.  For
-example,
+function in a temporary fashion.  (Compare this with the idea
+of advising functions.
address@hidden Functions,,,elisp,GNU Emacs Lisp Reference Manual}.)
+This will even work on Emacs primitives, although note that some calls
+to primitive functions internal to Emacs are made without going
+through the symbol's function cell, and so will not be affected by
address@hidden  For example,
 
 @example
 (cl-flet ((message (&rest args) (push args saved-msgs)))
@@ -1307,6 +1312,9 @@
 argument notation supported by @code{cl-defun}; also, the function
 body is enclosed in an implicit block as if by @code{cl-defun}.
 @xref{Program Structure}.
+
+Note that the @file{cl.el} version of this macro behaves slightly
+differently.  @xref{Obsolete Macros}.
 @end defmac
 
 @defmac cl-labels (address@hidden) address@hidden
@@ -1327,6 +1335,9 @@
 A ``reference'' to a function name is either a call to that
 function, or a use of its name quoted by @code{quote} or
 @code{function} to be passed on to, say, @code{mapcar}.
+
+Note that the @file{cl.el} version of this macro behaves slightly
+differently.  @xref{Obsolete Macros}.
 @end defmac
 
 @node Macro Bindings