]> git.eshelyaron.com Git - emacs.git/commitdiff
Don't mention cl-cXXXr aliases in cl-lib manual
authorStefan Kangas <stefan@marxist.se>
Tue, 12 Jul 2022 11:41:28 +0000 (13:41 +0200)
committerStefan Kangas <stefan@marxist.se>
Tue, 12 Jul 2022 11:42:00 +0000 (13:42 +0200)
* 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

index 9bace48df4fccc4ba4f8fa49d589191ea3730489..4eb3d85d2ba7aeec7362b3bc65ddb9d4ae0a9222 100644 (file)
@@ -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