[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] scratch/follow f5c403d: Amend doc of `mapconcat': it can t
From: |
Alan Mackenzie |
Subject: |
[Emacs-diffs] scratch/follow f5c403d: Amend doc of `mapconcat': it can take sequences, not merely strings. |
Date: |
Mon, 07 Dec 2015 10:38:29 +0000 |
branch: scratch/follow
commit f5c403d269f4f5079dc47853f16a51e9542ea238
Author: Alan Mackenzie <address@hidden>
Commit: Alan Mackenzie <address@hidden>
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".
---
doc/lispref/functions.texi | 17 ++++++++++-------
1 files changed, 10 insertions(+), 7 deletions(-)
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index 8835667..7cc041fa7 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
address@hidden: the results, which must be strings, are concatenated.
-Between each pair of result strings, @code{mapconcat} inserts the string
address@hidden Usually @var{separator} contains a space or comma or
-other suitable punctuation.
address@hidden; 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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] scratch/follow f5c403d: Amend doc of `mapconcat': it can take sequences, not merely strings.,
Alan Mackenzie <=