mapc

2 files changed, 10 insertions, 0 deletions

diff --git a/etc/NEWS b/etc/NEWS
index cf16b62c8c2..c9a18fa4369 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1102,6 +1102,9 @@ Note that +++ before an item means the Lisp manual has been updated.
 When you add a new item, please add it without either +++ or ---
 so I will know I still need to look at it -- rms.
 
+** The new function `mapc' is like `mapcar' but doesn't collect the
+argument function's results.
+
 ** The functions base64-decode-region and base64-decode-string now
 signal an error instead of returning nil if decoding fails.
 
diff --git a/lispref/functions.texi b/lispref/functions.texi
index e4241d9a967..6cdcb6bce1b 100644
--- a/lispref/functions.texi
+++ b/lispref/functions.texi
@@ -748,6 +748,13 @@ Return the list of results."
 @end smallexample
 @end defun
 
+@defun mapc function sequence
+@tindex mapc
+@code{mapc} is like @code{mapcar} except that @var{function} is used for
+side-effects only---the values it returns are ignored, not collected
+into a list.  @code{mapc} always returns @var{sequence}.
+@end defun
+
 @defun mapconcat function sequence separator
 @code{mapconcat} applies @var{function} to each element of
 @var{sequence}: the results, which must be strings, are concatenated.