changeset 110850:8cb2627c2b87

Minor cl.texi change. * doc/misc/cl.texi (Organization, Installation, Old CL Compatibility): Deprecate cl-compat for new code.
author Glenn Morris <rgm@gnu.org>
date Thu, 07 Oct 2010 20:01:23 -0700
parents 49bb2cbec1ea
children 3466369fdfcd
files doc/misc/ChangeLog doc/misc/cl.texi
diffstat 2 files changed, 14 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/doc/misc/ChangeLog	Fri Oct 08 11:23:52 2010 +0900
+++ b/doc/misc/ChangeLog	Thu Oct 07 20:01:23 2010 -0700
@@ -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.
--- a/doc/misc/cl.texi	Fri Oct 08 11:23:52 2010 +0900
+++ b/doc/misc/cl.texi	Thu Oct 07 20:01:23 2010 -0700
@@ -206,11 +206,12 @@
 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 @@
 
 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 @@
 @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