From 7822292a9c86a6e999f7d83c3478d98a403a5ec9 Mon Sep 17 00:00:00 2001 From: Chong Yidong Date: Sat, 18 Jul 2009 04:40:55 +0000 Subject: [PATCH] * processes.texi (Shell Arguments): Copyedits. --- doc/lispref/ChangeLog | 4 ++++ doc/lispref/processes.texi | 27 +++++++++++++-------------- 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 + + * processes.texi (Shell Arguments): Copyedits. + 2009-07-18 Glenn Morris * 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 -- 2.39.2