Commit 0999039c authored by Chong Yidong's avatar Chong Yidong

* processes.texi (Shell Arguments): Copyedits.

parent 0013b70f
2009-07-18 Chong Yidong <cyd@stupidchicken.com>
* processes.texi (Shell Arguments): Copyedits.
2009-07-18 Glenn Morris <rgm@gnu.org> 2009-07-18 Glenn Morris <rgm@gnu.org>
* loading.texi (Repeated Loading): Fix typo. * loading.texi (Repeated Loading): Fix typo.
......
...@@ -195,33 +195,32 @@ a shell command: ...@@ -195,33 +195,32 @@ a shell command:
@end defun @end defun
@cindex quoting and unquoting shell command line @cindex quoting and unquoting shell command line
The following two functions help creating shell commands from The following two functions are useful for creating shell commands
individual argument strings and taking shell command lines apart into from individual argument strings, and taking shell command lines apart
individual arguments. into individual arguments.
@defun split-string-and-unquote string &optional separators @defun split-string-and-unquote string &optional separators
This function splits @var{string} into substrings at matches for the This function splits @var{string} into substrings at matches for the
regular expression @var{separators}, like @code{split-string} does regular expression @var{separators}, like @code{split-string} does
(@pxref{Creating Strings}), but it additionally removes quoting from (@pxref{Creating Strings}); in addition, it removes quoting from the
the substrings. It then makes a list of the substrings and returns substrings. It then makes a list of the substrings and returns it.
it.
If @var{separators} is omitted or @code{nil}, it defaults to If @var{separators} is omitted or @code{nil}, it defaults to
@code{"\\s-+"}, which is a regular expression that matches one or more @code{"\\s-+"}, which is a regular expression that matches one or more
characters with whitespace syntax (@pxref{Syntax Class Table}). characters with whitespace syntax (@pxref{Syntax Class Table}).
The quoting this function supports is of 2 styles: by enclosing a This function performs two types of quoting: enclosing a whole string
whole string in double quotes @code{"@dots{}"}, or by quoting in double quotes @code{"@dots{}"}, and quoting individual characters
individual characters with a backslash escape @samp{\}. The latter is with a backslash escape @samp{\}. The latter is also used in Lisp
also used in Lisp strings, so this function can handle those as well. strings, so this function can handle those as well.
@end defun @end defun
@defun combine-and-quote-strings list-of-strings &optional separator @defun combine-and-quote-strings list-of-strings &optional separator
This function concatenates @var{list-of-strings} into a single string, This function concatenates @var{list-of-strings} into a single string,
quoting each string in the list that needs quoting as it goes. It quoting each string as necessary. It also sticks the @var{separator}
also sticks the @var{separator} string in between each pair of strings string between each pair of strings; if @var{separator} is omitted or
in the result, and returns that result. If @var{separator} is omitted @code{nil}, it defaults to @code{" "}. The return value is the
or @code{nil}, it defaults to a blank @code{" "}. resulting string.
The strings in @var{list-of-strings} that need quoting are those that The strings in @var{list-of-strings} that need quoting are those that
include @var{separator} as their substring. Quoting a string encloses include @var{separator} as their substring. Quoting a string encloses
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment