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

Previous Next

Full log

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

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

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