[Emacs-diffs] trunk r115704: Document TRIM in `split-string'.

[Xue Fuqiao]

------------------------------------------------------------
revno: 115704
revision-id: address@hidden
parent: address@hidden
committer: Xue Fuqiao <address@hidden>
branch nick: trunk
timestamp: Mon 2013-12-23 15:55:08 +0800
message:
  Document TRIM in `split-string'.
  
  * doc/lispref/strings.texi (Creating Strings): Document TRIM in
  `split-string'.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/strings.texi       
strings.texi-20091113204419-o5vbwnq5f7feedwu-6212
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-12-23 03:59:10 +0000
+++ b/doc/lispref/ChangeLog     2013-12-23 07:55:08 +0000
@@ -1,3 +1,7 @@
+2013-12-23  Xue Fuqiao  <address@hidden>
+
+       * strings.texi (Creating Strings): Document TRIM in `split-string'.
+
 2013-12-23  Chong Yidong  <address@hidden>
 
        * keymaps.texi (Controlling Active Maps): Renamed

=== modified file 'doc/lispref/strings.texi'
--- a/doc/lispref/strings.texi  2013-01-01 09:11:05 +0000
+++ b/doc/lispref/strings.texi  2013-12-23 07:55:08 +0000
@@ -268,7 +268,7 @@
 combine-and-quote-strings}.
 @end defun
 
address@hidden split-string string &optional separators omit-nulls
address@hidden 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 @@
      @result{} ("o" "o" "o")
 @end example
 
+If the optional argument @var{trim} is address@hidden, 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}.

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2013-12-23 03:59:10 +0000
+++ b/etc/NEWS  2013-12-23 07:55:08 +0000
@@ -983,6 +983,7 @@
 ** `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.