[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110793: More small cl.texi update
From: |
Glenn Morris |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110793: More small cl.texi updates |
Date: |
Mon, 05 Nov 2012 21:49:57 -0500 |
User-agent: |
Bazaar (2.5.0) |
------------------------------------------------------------
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/emacs-24 r110793: More small cl.texi updates,
Glenn Morris <=