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

Previous Next

Full log

Message #34 received at 7563 <at> debbugs.gnu.org (full text, mbox):

From: Dave Abrahams <dave <at> boostpro.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: "7563 <at> debbugs.gnu.org" <7563 <at> debbugs.gnu.org>
Subject: Re: bug#7563: 23.2;
	`split-string-and-unquote' mis-documented / purpose unclear
Date: Sat, 11 Dec 2010 17:27:16 -0500

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 <at> gnu.org> wrote:

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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.