From 12359245f6b9651541e00e6d59e07d6a25a4df8a Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Thu, 7 Oct 2010 20:01:23 -0700 Subject: [PATCH] Minor cl.texi change. * doc/misc/cl.texi (Organization, Installation, Old CL Compatibility): Deprecate cl-compat for new code. --- doc/misc/ChangeLog | 5 +++++ doc/misc/cl.texi | 16 +++++++++------- 2 files changed, 14 insertions(+), 7 deletions(-) diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 785d3d425a..238cec8e82 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -1,3 +1,8 @@ +2010-10-08 Glenn Morris + + * cl.texi (Organization, Installation, Old CL Compatibility): + Deprecate cl-compat for new code. + 2010-10-07 Glenn Morris * eudc.texi (CCSO PH/QI, LDAP Requirements): Remove old information. diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi index 948ba78606..780d53c901 100644 --- 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 -- 2.20.1