emacs-diffs
[Top][All Lists]
Advanced

[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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]