]> git.eshelyaron.com Git - emacs.git/commitdiff
; Delete obsolete commented out parts from cl.texi
authorStefan Kangas <stefankangas@gmail.com>
Sat, 22 Feb 2025 16:18:01 +0000 (17:18 +0100)
committerEshel Yaron <me@eshelyaron.com>
Sun, 23 Feb 2025 08:18:20 +0000 (09:18 +0100)
* doc/misc/cl.texi (Modify Macros, Obsolete Setf Customization): Delete
commented out documentation that is no longer true, and documentation of
a function that was removed in Emacs 24.3.

(cherry picked from commit 4aae820a017faab47662d0fa82cb5e39d8728d8c)

doc/misc/cl.texi

index 4e757daab1e9bab6469276281282024ef88ee39b..0b45ae2e231890a5c1ef7b3faa916420ec35214e 100644 (file)
@@ -1257,26 +1257,13 @@ However, a @var{binding} specifier may be a one-element list
 @var{place})}.  In other words, the @var{place} is not disturbed
 on entry to the body, and the only effect of the @code{cl-letf} is
 to restore the original value of @var{place} afterwards.
-@c I suspect this may no longer be true; either way it's
-@c implementation detail and so not essential to document.
-@ignore
-(The redundant access-and-store suggested by the @code{(@var{place}
-@var{place})} example does not actually occur.)
-@end ignore
 
 Note that in this case, and in fact almost every case, @var{place}
 must have a well-defined value outside the @code{cl-letf} body.
 There is essentially only one exception to this, which is @var{place}
 a plain variable with a specified @var{value} (such as @code{(a 17)}
 in the above example).
-@c See https://debbugs.gnu.org/12758
-@c Some or all of this was true for cl.el, but not for cl-lib.el.
-@ignore
-The only exceptions are plain variables and calls to
-@code{symbol-value} and @code{symbol-function}.  If the symbol is not
-bound on entry, it is simply made unbound by @code{makunbound} or
-@code{fmakunbound} on exit.
-@end ignore
+
 @end defmac
 
 @defmac cl-letf* (bindings@dots{}) forms@dots{}
@@ -5297,24 +5284,6 @@ turn out to be unnecessary, so there is little reason for the
 setf-method itself to optimize.
 @end defmac
 
-@c Removed in Emacs 24.3, not possible to make a compatible replacement.
-@ignore
-@defun get-setf-method place &optional env
-This function returns the setf-method for @var{place}, by
-invoking the definition previously recorded by @code{defsetf}
-or @code{define-setf-method}.  The result is a list of five
-values as described above.  You can use this function to build
-your own @code{cl-incf}-like modify macros.
-
-The argument @var{env} specifies the ``environment'' to be
-passed on to @code{macroexpand} if @code{get-setf-method} should
-need to expand a macro in @var{place}.  It should come from
-an @code{&environment} argument to the macro or setf-method
-that called @code{get-setf-method}.
-@end defun
-@end ignore
-
-
 @node GNU Free Documentation License
 @appendix GNU Free Documentation License
 @include doclicense.texi