From 46291d111fe5c915099ab38cc54b07ebc82bcea0 Mon Sep 17 00:00:00 2001 From: Xue Fuqiao Date: Mon, 23 Dec 2013 15:55:08 +0800 Subject: [PATCH] Document TRIM in `split-string'. * doc/lispref/strings.texi (Creating Strings): Document TRIM in `split-string'. --- doc/lispref/ChangeLog | 4 ++++ doc/lispref/strings.texi | 7 ++++++- etc/NEWS | 1 + 3 files changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index aae5a1a6cc2..c598cf0f5aa 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,7 @@ +2013-12-23 Xue Fuqiao + + * strings.texi (Creating Strings): Document TRIM in `split-string'. + 2013-12-23 Chong Yidong * keymaps.texi (Controlling Active Maps): Renamed diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi index 340115062f9..0fe319d97fb 100644 --- a/doc/lispref/strings.texi +++ b/doc/lispref/strings.texi @@ -268,7 +268,7 @@ string to be used as a shell command, see @ref{Shell Arguments, combine-and-quote-strings}. @end defun -@defun split-string string &optional separators omit-nulls +@defun split-string string &optional separators omit-nulls trim This function splits @var{string} into substrings based on the regular expression @var{separators} (@pxref{Regular Expressions}). Each match for @var{separators} defines a splitting point; the substrings between @@ -350,6 +350,11 @@ practice: @result{} ("o" "o" "o") @end example +If the optional argument @var{trim} is non-@code{nil}, it should be a +regular expression to match text to trim from the beginning and end of +each substring. If trimming makes the substring empty, it is treated +as null. + If you need to split a string into a list of individual command-line arguments suitable for @code{call-process} or @code{start-process}, see @ref{Shell Arguments, split-string-and-unquote}. diff --git a/etc/NEWS b/etc/NEWS index 0496e0d8778..2b5644a2827 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -983,6 +983,7 @@ The few hooks that used with-wrapper-hook are replaced as follows: ** `byte-compile-interactive-only-functions' is now obsolete. It has been replaced by the symbol property 'interactive-only. ++++ ** `split-string' now takes an optional argument TRIM. The value, if non-nil, is a regexp that specifies what to trim from the start and end of each substring. -- 2.11.4.GIT