]> code.delx.au - gnu-emacs/commitdiff
cl-mapc small fixes
authorGlenn Morris <rgm@gnu.org>
Tue, 30 Oct 2012 08:03:22 +0000 (01:03 -0700)
committerGlenn Morris <rgm@gnu.org>
Tue, 30 Oct 2012 08:03:22 +0000 (01:03 -0700)
* lisp/emacs-lisp/cl-extra.el (cl-mapc): Add autoload cookie.  Doc fix.

* doc/misc/cl.texi (Mapping over Sequences): Mention cl-mapc naming oddity.

doc/misc/ChangeLog
doc/misc/cl.texi
lisp/ChangeLog
lisp/emacs-lisp/cl-extra.el

index fa58cd958db6d5ac06499a291cafd4ab90029c74..941c430ce7492818dd2a6e02a1526555b9da5654 100644 (file)
@@ -5,6 +5,7 @@
        (Setf Extensions): Partially restore note about cl-getf,
        mainly moved to lispref/variables.texi.
        (Property Lists): Fix cl-getf typos.
+       (Mapping over Sequences): Mention cl-mapc naming oddity.
 
 2012-10-29  Glenn Morris  <rgm@gnu.org>
 
index 4105ac349ec3f5a7afd5deb793c176897abb280f..8cee1cf9639df4a31a5271025496f7093cb45518 100644 (file)
@@ -199,6 +199,8 @@ because they are replaced by other standard Emacs Lisp features.
 Finally, in a very few cases the old @file{cl.el} versions do not
 behave in exactly the same way as the @file{cl-lib.el} versions.
 @xref{Obsolete Features}.
+@c There is also cl-mapc, which was called cl-mapc even before cl-lib.el.
+@c But not autoloaded, so maybe not much used?
 
 Since the old @file{cl.el} does not use a clean namespace, Emacs has a
 policy that packages distributed with Emacs must not load @code{cl} at
@@ -3309,13 +3311,15 @@ that it passes in the list pointers themselves rather than the
 @code{car}s of the advancing pointers.
 @end defun
 
-@c FIXME does not exist?
 @defun cl-mapc function seq &rest more-seqs
 This function is like @code{cl-mapcar}, except that the values returned
 by @var{function} are ignored and thrown away rather than being
 collected into a list.  The return value of @code{cl-mapc} is @var{seq},
 the first sequence.  This function is more general than the Emacs
-primitive @code{mapc}.
+primitive @code{mapc}.  (Note that this function is called
+@code{cl-mapc} even in @file{cl.el}, rather than @code{map*} as you
+might expect.)
+@c http://debbugs.gnu.org/6575
 @end defun
 
 @defun cl-mapl function list &rest more-lists
index c5c3b93d1955623d30884a8560bc3f75f0fccd82..bd535894cdfd0cfb33329ea59d155e3ffb60542f 100644 (file)
@@ -1,5 +1,7 @@
 2012-10-30  Glenn Morris  <rgm@gnu.org>
 
+       * emacs-lisp/cl-extra.el (cl-mapc): Add autoload cookie.  Doc fix.
+
        * emacs-lisp/cl.el (letf): Doc fix.  (Bug#12760)
 
 2012-10-29  Chong Yidong  <cyd@gnu.org>
index 913ebf2015f325b623d124766710c89ef0374094..c72e33426482a335739786c20bc3859d3fe8d47f 100644 (file)
@@ -149,8 +149,9 @@ the elements themselves.
        (setq cl-list (cdr cl-list)))
       (nreverse cl-res))))
 
+;;;###autoload
 (defun cl-mapc (cl-func cl-seq &rest cl-rest)
-  "Like `mapcar', but does not accumulate values returned by the function.
+  "Like `cl-mapcar', but does not accumulate values returned by the function.
 \n(fn FUNCTION SEQUENCE...)"
   (if cl-rest
       (progn (apply 'cl-map nil cl-func cl-seq cl-rest)