emacs-28 a3dab1e621: Don't mention cl-cXXXr aliases in cl-lib manual

[Stefan Kangas]

branch: emacs-28
commit a3dab1e62132bb82ba943b1e7db0ef86f0c93d28
Author: Stefan Kangas <stefan@marxist.se>
Commit: Stefan Kangas <stefan@marxist.se>

    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 9bace48df4..4eb3d85d2b 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