summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChong Yidong <cyd@stupidchicken.com>2009-07-18 04:40:55 +0000
committerChong Yidong <cyd@stupidchicken.com>2009-07-18 04:40:55 +0000
commit7822292a9c86a6e999f7d83c3478d98a403a5ec9 (patch)
tree06e93a9cf28c8c7ce589db51f275cdd89fbc4440
parentf3f1ee8cc1532c7e4d2c517db14d3f5ace832645 (diff)
downloademacs-7822292a9c86a6e999f7d83c3478d98a403a5ec9.tar.gz
* processes.texi (Shell Arguments): Copyedits.
-rw-r--r--doc/lispref/ChangeLog4
-rw-r--r--doc/lispref/processes.texi27
2 files changed, 17 insertions, 14 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 2440f280936..9e4610bb47c 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -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.
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index b0d420ef07c..b80b49f38cb 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -195,33 +195,32 @@ a shell command:
@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