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

[Dave Abrahams <dave@boostpro.com>]

IMO they would be much more appropriately documented right next to split-string and concat

BoostPro Computing * http://boostpro.com
[Sent from coveted but awkward mobile device]
--

On Dec 11, 2010, at 3:42 PM, Eli Zaretskii <eliz@gnu.org> wrote:

>> Cc: "7563@debbugs.gnu.org" <7563@debbugs.gnu.org>
>> From: Dave Abrahams <dave@boostpro.com>
>> 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".