# HG changeset patch # User Chong Yidong # Date 1247892145 0 # Node ID b09c14dc3a8e390e796a303c5efdbc9fddd13bd9 # Parent c59b9da550fc93237c2b0c7617bc261681cda7b9 * processes.texi (Shell Arguments): Copyedits. diff -r c59b9da550fc -r b09c14dc3a8e doc/lispref/ChangeLog --- 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 + + * processes.texi (Shell Arguments): Copyedits. + 2009-07-18 Glenn Morris * loading.texi (Repeated Loading): Fix typo. diff -r c59b9da550fc -r b09c14dc3a8e doc/lispref/processes.texi --- 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