[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110793: More small cl.texi updates

[Glenn Morris]

------------------------------------------------------------
revno: 110793
committer: Glenn Morris <address@hidden>
branch nick: emacs-24
timestamp: Mon 2012-11-05 21:49:57 -0500
message:
  More small cl.texi updates
  
  * doc/misc/cl.texi (Setf Extensions): Remove obsolete reference.
  (Obsolete Setf Customization):
  Mention simple defsetf replaced by gv-define-simple-setter.
modified:
  doc/misc/ChangeLog
  doc/misc/cl.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2012-11-06 02:28:48 +0000
+++ b/doc/misc/ChangeLog        2012-11-06 02:49:57 +0000
@@ -1,9 +1,11 @@
 2012-11-06  Glenn Morris  <address@hidden>
 
        * cl.texi (Overview): Mention EIEIO here, as well as the appendix.
+       (Setf Extensions): Remove obsolete reference.
        (Obsolete Setf Customization):
        Move note on lack of setf functions to lispref/variables.texi.
        Undocument get-setf-method, since it no longer exists.
+       Mention simple defsetf replaced by gv-define-simple-setter.
 
 2012-11-03  Glenn Morris  <address@hidden>
 

=== modified file 'doc/misc/cl.texi'
--- a/doc/misc/cl.texi  2012-11-06 02:30:16 +0000
+++ b/doc/misc/cl.texi  2012-11-06 02:49:57 +0000
@@ -975,7 +975,7 @@
 The generalized variable @code{buffer-substring}, listed above,
 also works in this way by replacing a portion of the current buffer.
 
address@hidden FIXME? Also `eq'? (see cl-lib.el)
address@hidden FIXME?  Also `eq'? (see cl-lib.el)
 
 @c Currently commented out in cl.el.
 @ignore
@@ -990,13 +990,10 @@
 @xref{Obsolete Setf Customization}.
 @end ignore
 
address@hidden FIXME?  Is this still true?
 @item
 A macro call, in which case the macro is expanded and @code{setf}
 is applied to the resulting form.
-
address@hidden
-Any form for which a @code{defsetf} or @code{define-setf-method}
-has been made.  @xref{Obsolete Setf Customization}.
 @end itemize
 
 @c FIXME should this be in lispref?  It seems self-evident.
@@ -4953,10 +4950,14 @@
 @end defmac
 
 @defmac defsetf access-fn update-fn
-This is the simpler of two @code{defsetf} forms.  Where
address@hidden is the name of a function which accesses a place,
-this declares @var{update-fn} to be the corresponding store
-function.  From now on,
+This is the simpler of two @code{defsetf} forms, and is entirely
+obsolete, being replaced by @code{gv-define-simple-setter} in Emacs
+24.3.
address@hidden Generalized Variables,,,elisp,GNU Emacs Lisp Reference Manual}.
+
+Where @var{access-fn} is the name of a function that accesses a place,
+this declares @var{update-fn} to be the corresponding store function.
+From now on,
 
 @example
 (setf (@var{access-fn} @var{arg1} @var{arg2} @var{arg3}) @var{value})
@@ -4971,7 +4972,7 @@
 
 @noindent
 The @var{update-fn} is required to be either a true function, or
-a macro which evaluates its arguments in a function-like way.  Also,
+a macro that evaluates its arguments in a function-like way.  Also,
 the @var{update-fn} is expected to return @var{value} as its result.
 Otherwise, the above expansion would not obey the rules for the way
 @code{setf} is supposed to behave.
@@ -4982,17 +4983,14 @@
 something more like
 
 @example
-(let ((temp @var{value}))
-  (@var{update-fn} @var{arg1} @var{arg2} @var{arg3} temp)
-  temp)
+(prog1 @var{value}
+  (@var{update-fn} @var{arg1} @var{arg2} @var{arg3} @var{value}))
 @end example
 
-Some examples of the use of @code{defsetf}, drawn from the standard
-suite of setf methods, are:
+Some examples are:
 
 @example
 (defsetf car setcar)
-(defsetf symbol-value set)
 (defsetf buffer-name rename-buffer t)
 @end example
 @end defmac