Fallout from bug #7563.
processes.texi (Shell Arguments): strings.texi (Creating Strings): Don't mention "shell commands"; make it explicit that `split-string-and-unquote' and `combine-and-quote-strings' are mainly for working with arguments to call-process and start-process.
This commit is contained in:
parent
76feb8641e
commit
4bb49a92aa
3 changed files with 17 additions and 11 deletions
|
@ -1,5 +1,11 @@
|
|||
2010-12-11 Eli Zaretskii <eliz@gnu.org>
|
||||
|
||||
* processes.texi (Shell Arguments):
|
||||
* strings.texi (Creating Strings): Don't mention "shell commands";
|
||||
make it explicit that `split-string-and-unquote' and
|
||||
`combine-and-quote-strings' are mainly for working with arguments
|
||||
to call-process and start-process.
|
||||
|
||||
* processes.texi (Shell Arguments): Fix documentation of
|
||||
`split-string-and-unquote'. Add indexing. (Bug#7563)
|
||||
|
||||
|
|
|
@ -199,11 +199,12 @@ a shell command:
|
|||
@cindex minibuffer input, and command-line arguments
|
||||
@cindex @code{call-process}, command-line arguments from minibuffer
|
||||
@cindex @code{start-process}, command-line arguments from minibuffer
|
||||
The following two functions are useful for creating shell commands
|
||||
from individual argument strings, and taking shell command lines apart
|
||||
into individual arguments. These functions are mainly intended to be
|
||||
used for converting user input in the minibuffer, a Lisp string, into
|
||||
a list of string arguments to be passed to @code{call-process} or
|
||||
The following two functions are useful for combining a list of
|
||||
individual command-line argument strings into a single string, and
|
||||
taking a string apart into a list of individual command-line
|
||||
arguments. These functions are mainly intended to be used for
|
||||
converting user input in the minibuffer, a Lisp string, into a list of
|
||||
string arguments to be passed to @code{call-process} or
|
||||
@code{start-process}, or for the converting such lists of arguments in
|
||||
a single Lisp string to be presented in the minibuffer or echo area.
|
||||
|
||||
|
@ -233,9 +234,8 @@ 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
|
||||
it in double quotes @code{"@dots{}"}. In the simplest case, if you
|
||||
are consing a shell command from the individual command-line
|
||||
arguments, every argument that includes embedded blanks will be
|
||||
quoted.
|
||||
are consing a command from the individual command-line arguments,
|
||||
every argument that includes embedded blanks will be quoted.
|
||||
@end defun
|
||||
|
||||
@node Synchronous Processes
|
||||
|
|
|
@ -348,9 +348,9 @@ practice:
|
|||
@result{} ("o" "o" "o")
|
||||
@end example
|
||||
|
||||
If you need to split a string that is a shell command, where
|
||||
individual arguments could be quoted, see @ref{Shell Arguments,
|
||||
split-string-and-unquote}.
|
||||
If you need to split a string into a list of individual command-line
|
||||
arguments suitable for @code{call-process} or @code{start-process},
|
||||
see @ref{Shell Arguments, split-string-and-unquote}.
|
||||
@end defun
|
||||
|
||||
@defvar split-string-default-separators
|
||||
|
|
Loading…
Add table
Reference in a new issue