Subject: bug#7563: 23.2; `split-string-and-unquote' mis-documented / purpose unclear

From: Eli Zaretskii <[email-masked]>
Date: Sat, 11 Dec 2010 22:42:06 +0200

> Cc: "[email-masked]" <[email-masked]>
> From: Dave Abrahams <[email-masked]>
> Date: Sat, 11 Dec 2010 14:41:52 -0500
> 
> Thanks. I'm away from the docs ATM but IIRC this stuff is documented in a section on interacting with the shell but it seems from the way you describe the behavior that this function is all about Emacs string processing and should be elsewhere or it will mislead people

We cannot have a separate section for every possible sub-class of
features.  The description of these functions is in the section named
"Shell Arguments", indeed, but this section is part of a chapter named
"Processes", and it deals with a specialized kind of quoting, so I
don't see how this will mislead, given the explicit references to
call-process and start-process.

If naming sections is important, we could rename the section to
something like "Command Arguments".