--- a/man/lispref/functions.texi	Mon Aug 13 11:19:22 2007 +0200
+++ b/man/lispref/functions.texi	Mon Aug 13 11:20:41 2007 +0200
@@ -680,21 +680,18 @@
 @cindex mapping functions
 
   A @dfn{mapping function} applies a given function to each element of a
-list or other collection.  XEmacs Lisp has several such functions;
+list or other collection.  XEmacs Lisp has three such functions;
 @code{mapcar} and @code{mapconcat}, which scan a list, are described
-here.   @xref{Creating Symbols}, for the function @code{mapatoms} which
-maps over the symbols in an obarray.
-
-Mapping functions should never modify the sequence being mapped over.
-The results are unpredictable.
+here.  For the third mapping function, @code{mapatoms}, see
+@ref{Creating Symbols}.
 
 @defun mapcar function sequence
 @code{mapcar} applies @var{function} to each element of @var{sequence}
 in turn, and returns a list of the results.
 
-The argument @var{sequence} can be any kind of sequence; that is, a
-list, a vector, a bit vector, or a string.  The result is always a list.
-The length of the result is the same as the length of @var{sequence}.
+The argument @var{sequence} may be a list, a vector, or a string.  The
+result is always a list.  The length of the result is the same as the
+length of @var{sequence}.
 
 @smallexample
 @group
@@ -719,7 +716,7 @@
 Return the list of results."
   ;; @r{If no list is exhausted,}
   (if (not (memq 'nil args))              
-      ;; @r{apply function to @sc{car}s.}
+      ;; @r{apply function to @sc{CAR}s.}
       (cons (apply f (mapcar 'car args))  
             (apply 'mapcar* f             
                    ;; @r{Recurse for rest of elements.}
@@ -741,8 +738,7 @@
 other suitable punctuation.
 
 The argument @var{function} must be a function that can take one
-argument and return a string.  The argument @var{sequence} can be any
-kind of sequence; that is, a list, a vector, a bit vector, or a string.
+argument and return a string.
   
 @smallexample
 @group