Minor cl.texi change.

* doc/misc/cl.texi (Organization, Installation, Old CL Compatibility):
Deprecate cl-compat for new code.

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 785d3d425a0f1653f6aa5bd9a740968587c2c4c0..238cec8e82bc349cf37bb9eeb0e0a09f703155ad 100644 (file)
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,8 @@
+2010-10-08  Glenn Morris  <rgm@gnu.org>
+
+       * cl.texi (Organization, Installation, Old CL Compatibility):
+       Deprecate cl-compat for new code.
+
 2010-10-07  Glenn Morris  <rgm@gnu.org>
 
        * eudc.texi (CCSO PH/QI, LDAP Requirements): Remove old information.

diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi
index 948ba78606638b5f68ea7ce8aab67b908cab991e..780d53c90179f201004fc41ca333edcafdc463b8 100644 (file)
--- a/doc/misc/cl.texi
+++ b/doc/misc/cl.texi
@@ -206,11 +206,12 @@ will take care of pulling in the other files when they are
 needed.
 
 There is another file, @file{cl-compat.el}, which defines some
-routines from the older @file{cl.el} package that are no longer
+routines from the older @file{cl.el} package that are not otherwise
 present in the new package.  This includes internal routines
 like @code{setelt} and @code{zip-lists}, deprecated features
 like @code{defkeyword}, and an emulation of the old-style
-multiple-values feature.  @xref{Old CL Compatibility}.
+multiple-values feature.  This file is obsolete and should not be used
+in new code.  @xref{Old CL Compatibility}.
 
 @node Installation, Naming Conventions, Organization, Overview
 @section Installation
@@ -221,9 +222,10 @@ to install anything.
 
 If you do need to install it, just put the byte-compiled files
 @file{cl.elc}, @file{cl-extra.elc}, @file{cl-seq.elc},
-@file{cl-macs.elc}, and @file{cl-compat.elc} into a directory on your
-@code{load-path}.  Also, format the @file{cl.texi} file and put the
-resulting Info files into a directory in your @code{Info-directory-list}.
+@file{cl-macs.elc}, and (if necessary) @file{cl-compat.elc} into a
+directory on your @code{load-path}.  Also, format the @file{cl.texi}
+file and put the resulting Info files into a directory in your
+@code{Info-directory-list}.
 
 @node Naming Conventions,  , Installation, Overview
 @section Naming Conventions
@@ -5048,8 +5050,8 @@ Lisp.
 @noindent
 The @dfn{CL} package includes emulations of some features of the
 old @file{cl.el}, in the form of a compatibility package
-@code{cl-compat}.  To use it, put @code{(require 'cl-compat)} in
-your program.
+@code{cl-compat}.  This file is obsolete and may be removed in future,
+so it should not be used in new code.
 
 The old package defined a number of internal routines without
 @code{cl-} prefixes or other annotations.  Call to these routines