Mercurial > emacs
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