changeset 103953:b09c14dc3a8e

* processes.texi (Shell Arguments): Copyedits.
author Chong Yidong <cyd@stupidchicken.com>
date Sat, 18 Jul 2009 04:42:25 +0000
parents c59b9da550fc
children acbf8748cf4b
files doc/lispref/ChangeLog doc/lispref/processes.texi
diffstat 2 files changed, 17 insertions(+), 14 deletions(-) [+]
line wrap: on
line diff
--- a/doc/lispref/ChangeLog	Sat Jul 18 04:37:52 2009 +0000
+++ b/doc/lispref/ChangeLog	Sat Jul 18 04:42:25 2009 +0000
@@ -1,3 +1,7 @@
+2009-07-18  Chong Yidong  <cyd@stupidchicken.com>
+
+	* processes.texi (Shell Arguments): Copyedits.
+
 2009-07-18  Glenn Morris  <rgm@gnu.org>
 
 	* loading.texi (Repeated Loading): Fix typo.
--- a/doc/lispref/processes.texi	Sat Jul 18 04:37:52 2009 +0000
+++ b/doc/lispref/processes.texi	Sat Jul 18 04:42:25 2009 +0000
@@ -195,33 +195,32 @@
 @end defun
 
 @cindex quoting and unquoting shell command line
-  The following two functions help creating shell commands from
-individual argument strings and taking shell command lines apart into
-individual arguments.
+  The following two functions are useful for creating shell commands
+from individual argument strings, and taking shell command lines apart
+into individual arguments.
 
 @defun split-string-and-unquote string &optional separators
 This function splits @var{string} into substrings at matches for the
 regular expression @var{separators}, like @code{split-string} does
-(@pxref{Creating Strings}), but it additionally removes quoting from
-the substrings.  It then makes a list of the substrings and returns
-it.
+(@pxref{Creating Strings}); in addition, it removes quoting from the
+substrings.  It then makes a list of the substrings and returns it.
 
 If @var{separators} is omitted or @code{nil}, it defaults to
 @code{"\\s-+"}, which is a regular expression that matches one or more
 characters with whitespace syntax (@pxref{Syntax Class Table}).
 
-The quoting this function supports is of 2 styles: by enclosing a
-whole string in double quotes @code{"@dots{}"}, or by quoting
-individual characters with a backslash escape @samp{\}.  The latter is
-also used in Lisp strings, so this function can handle those as well.
+This function performs two types of quoting: enclosing a whole string
+in double quotes @code{"@dots{}"}, and quoting individual characters
+with a backslash escape @samp{\}.  The latter is also used in Lisp
+strings, so this function can handle those as well.
 @end defun
 
 @defun combine-and-quote-strings list-of-strings &optional separator
 This function concatenates @var{list-of-strings} into a single string,
-quoting each string in the list that needs quoting as it goes.  It
-also sticks the @var{separator} string in between each pair of strings
-in the result, and returns that result.  If @var{separator} is omitted
-or @code{nil}, it defaults to a blank @code{" "}.
+quoting each string as necessary.  It also sticks the @var{separator}
+string between each pair of strings; if @var{separator} is omitted or
+@code{nil}, it defaults to @code{" "}.  The return value is the
+resulting string.
 
 The strings in @var{list-of-strings} that need quoting are those that
 include @var{separator} as their substring.  Quoting a string encloses