# HG changeset patch # User Eli Zaretskii # Date 1292060505 -7200 # Node ID bb8b0f23abc5266ce0c25a97bb2f1dae65c16e48 # Parent b53e0a0b4ec1a883d325c8c29c839071ba0ffa6d Fix bug #7563 with docs of split-string-and-unquote. processes.texi (Shell Arguments): Fix documentation of `split-string-and-unquote'. Add indexing. diff -r b53e0a0b4ec1 -r bb8b0f23abc5 doc/lispref/ChangeLog --- a/doc/lispref/ChangeLog Sat Dec 11 11:11:32 2010 +0200 +++ b/doc/lispref/ChangeLog Sat Dec 11 11:41:45 2010 +0200 @@ -1,3 +1,8 @@ +2010-12-11 Eli Zaretskii + + * processes.texi (Shell Arguments): Fix documentation of + `split-string-and-unquote'. Add indexing. (Bug#7563) + 2010-12-07 Stefan Monnier * modes.texi (Auto-Indentation): New section to document SMIE. diff -r b53e0a0b4ec1 -r bb8b0f23abc5 doc/lispref/processes.texi --- a/doc/lispref/processes.texi Sat Dec 11 11:11:32 2010 +0200 +++ b/doc/lispref/processes.texi Sat Dec 11 11:41:45 2010 +0200 @@ -195,10 +195,17 @@ @end example @end defun -@cindex quoting and unquoting shell command line +@cindex quoting and unquoting command-line arguments +@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. +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 +@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. @defun split-string-and-unquote string &optional separators This function splits @var{string} into substrings at matches for the @@ -210,7 +217,7 @@ @code{"\\s-+"}, which is a regular expression that matches one or more characters with whitespace syntax (@pxref{Syntax Class Table}). -This function performs two types of quoting: enclosing a whole string +This function supports 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.