From a3dab1e62132bb82ba943b1e7db0ef86f0c93d28 Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Tue, 12 Jul 2022 13:41:28 +0200 Subject: [PATCH] Don't mention cl-cXXXr aliases in cl-lib manual * doc/misc/cl.texi (Lists, List Functions, Efficiency Concerns): Don't mention 'cl-cXXXr' compatibility aliases for built-in 'cXXXr' functions. They shouldn't be used in new code. --- doc/misc/cl.texi | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi index 9bace48df4f..4eb3d85d2ba 100644 --- a/doc/misc/cl.texi +++ b/doc/misc/cl.texi @@ -3668,7 +3668,7 @@ a merged sequence which is (stably) sorted according to The functions described here operate on lists. @menu -* List Functions:: @code{cl-caddr}, @code{cl-first}, @code{cl-list*}, etc. +* List Functions:: @code{cl-first}, @code{cl-list*}, etc. * Substitution of Expressions:: @code{cl-subst}, @code{cl-sublis}, etc. * Lists as Sets:: @code{cl-member}, @code{cl-adjoin}, @code{cl-union}, etc. * Association Lists:: @code{cl-assoc}, @code{cl-acons}, @code{cl-pairlis}, etc. @@ -3681,14 +3681,6 @@ The functions described here operate on lists. This section describes a number of simple operations on lists, i.e., chains of cons cells. -@defun cl-caddr x -This function is equivalent to @code{(car (cdr (cdr @var{x})))}. -Likewise, this package aliases all 24 @code{c@var{xxx}r} functions -where @var{xxx} is up to four @samp{a}s and/or @samp{d}s. -All of these functions are @code{setf}-able, and calls to them -are expanded inline by the byte-compiler for maximum efficiency. -@end defun - @defun cl-first x This function is a synonym for @code{(car @var{x})}. Likewise, the functions @code{cl-second}, @code{cl-third}, @dots{}, through @@ -4465,8 +4457,8 @@ For example, @end example @end ignore -Note that @code{cl-adjoin}, @code{cl-caddr}, and @code{cl-member} all -have built-in compiler macros to optimize them in common cases. +Note that @code{cl-adjoin} and @code{cl-member} have built-in compiler +macros to optimize them in common cases. @end defun @appendixsec Error Checking -- 2.39.5