summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlan Mackenzie <acm@muc.de>2015-12-07 10:39:07 +0000
committerAlan Mackenzie <acm@muc.de>2015-12-07 10:39:07 +0000
commitf5c403d269f4f5079dc47853f16a51e9542ea238 (patch)
treefc2cd75cc227517ff727579d70ca1b35097b9361
parent72c20d0be811966afccdb7551d3341d10d3be9a9 (diff)
downloademacs-f5c403d269f4f5079dc47853f16a51e9542ea238.tar.gz
Amend doc of `mapconcat': it can take sequences, not merely strings.
* doc/lispref/functions.texi (Mapping Functions): Amend the doc of `mapconcat' to say that SEPARATOR and the results from FUNCTION may be any character sequences, not just strings. Add an @xref to "Sequences Arrays Vectors".
-rw-r--r--doc/lispref/functions.texi17
1 files changed, 10 insertions, 7 deletions
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index 8835667b82d..7cc041fa77e 100644
--- a/doc/lispref/functions.texi
+++ b/doc/lispref/functions.texi
@@ -861,15 +861,18 @@ into a list. @code{mapc} always returns @var{sequence}.
@defun mapconcat function sequence separator
@code{mapconcat} applies @var{function} to each element of
-@var{sequence}: the results, which must be strings, are concatenated.
-Between each pair of result strings, @code{mapconcat} inserts the string
-@var{separator}. Usually @var{separator} contains a space or comma or
-other suitable punctuation.
+@var{sequence}; the results, which must be sequences of characters
+(strings, vectors, or lists), are concatenated into a single string
+return value. Between each pair of result sequences, @code{mapconcat}
+inserts the characters from @var{separator}, which also must be a
+string, or a vector or list of characters. @xref{Sequences Arrays
+Vectors}.
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 except a char-table; that is, a list, a vector, a
-bool-vector, or a string.
+argument and returns a sequence of characters: a string, a vector, or
+a list. The argument @var{sequence} can be any kind of sequence
+except a char-table; that is, a list, a vector, a bool-vector, or a
+string.
@example
@group