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

[Dave Abrahams]

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".