(Creating Strings): Add xrefs to `split-string-and-unquote' and

`combine-and-quote-strings'.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index ade2722..4effa16 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,10 @@
+2008-10-20  Eli Zaretskii  <eliz@gnu.org>
+
+       * processes.texi (Shell Arguments): Document `split-string-and-unquote'
+       and `combine-and-quote-strings'.
+
+       * strings.texi (Creating Strings): Add xrefs for them.
+
 2008-10-19  Eli Zaretskii  <eliz@gnu.org>
 
        * elisp.texi (Top): Make descriptive text for "Reading File Names"

diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi
index 37c19fc..1b57e66 100644 (file)
--- a/doc/lispref/strings.texi
+++ b/doc/lispref/strings.texi
@@ -272,7 +272,9 @@ printed form is with @code{format} (@pxref{Formatting Strings}) or
 For information about other concatenation functions, see the
 description of @code{mapconcat} in @ref{Mapping Functions},
 @code{vconcat} in @ref{Vector Functions}, and @code{append} in @ref{Building
-Lists}.
+Lists}.  For concatenating individual command-line arguments into a
+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
@@ -357,6 +359,10 @@ practice:
 (split-string "ooo" "\\|o+" t)
      @result{} ("o" "o" "o")
 @end example
+
+If you need to split a string that is a shell command, where
+individual arguments could be quoted, see @ref{Shell Arguments,
+split-string-and-unquote}.
 @end defun
 
 @defvar split-string-default-separators

diff --git a/etc/NEWS b/etc/NEWS
index e811f99..9d088e9 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1599,9 +1599,16 @@ attributes of a given face.
 *** `window-full-width-p' returns t if a window is as wide as its
 frame.
 
-*** `split-string-and-unquote' does (what?)
++++
+*** `split-string-and-unquote' splits a string into a list of substrings
+on the boundaries of a given delimiter, and unquotes the substrings that
+are quoted.  Useful for taking apart shell commands.
 
-*** `combine-and-quote-strings' does (what?)
++++
+*** `combine-and-quote-strings' produces a single string from a list of strings
+sticking a separator string in between each pair, and quoting those
+strings that include the separator as their substring.  Useful for
+consing shell command lines from the individual arguments.
 
 *** `image-refresh' refreshes all images associated with a given image
 specification.