From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#7563: 23.2; `split-string-and-unquote' mis-documented / purpose unclear Date: Sat, 11 Dec 2010 22:42:06 +0200 Message-ID: <83r5dot529.fsf@gnu.org> References: <83fwu4vdsk.fsf@gnu.org> <834oakux25.fsf@gnu.org> <524EC395-B36D-4678-AF93-43C24C9E9745@boostpro.com> <83tyikta85.fsf@gnu.org> <781E581B-DE27-4C7E-B97A-DF133D7AD38E@boostpro.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1292100758 29595 80.91.229.12 (11 Dec 2010 20:52:38 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 11 Dec 2010 20:52:38 +0000 (UTC) Cc: 7563@debbugs.gnu.org To: Dave Abrahams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Dec 11 21:52:34 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PRWQi-0005Un-GR for geb-bug-gnu-emacs@m.gmane.org; Sat, 11 Dec 2010 21:52:32 +0100 Original-Received: from localhost ([127.0.0.1]:34754 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PRWQh-0006AK-Uq for geb-bug-gnu-emacs@m.gmane.org; Sat, 11 Dec 2010 15:52:31 -0500 Original-Received: from [140.186.70.92] (port=43307 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PRWQZ-00063D-3T for bug-gnu-emacs@gnu.org; Sat, 11 Dec 2010 15:52:27 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PRWQX-0000Jz-TP for bug-gnu-emacs@gnu.org; Sat, 11 Dec 2010 15:52:22 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:33479) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PRWQX-0000Jv-PI for bug-gnu-emacs@gnu.org; Sat, 11 Dec 2010 15:52:21 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PRWAj-00010U-TS; Sat, 11 Dec 2010 15:36:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 11 Dec 2010 20:36:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7563 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 7563-submit@debbugs.gnu.org id=B7563.12920997513849 (code B ref 7563); Sat, 11 Dec 2010 20:36:01 +0000 Original-Received: (at 7563) by debbugs.gnu.org; 11 Dec 2010 20:35:51 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PRWAY-000102-2Z for submit@debbugs.gnu.org; Sat, 11 Dec 2010 15:35:50 -0500 Original-Received: from mtaout20.012.net.il ([80.179.55.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PRWAV-0000zo-Kz for 7563@debbugs.gnu.org; Sat, 11 Dec 2010 15:35:48 -0500 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0LDA004006KFG200@a-mtaout20.012.net.il> for 7563@debbugs.gnu.org; Sat, 11 Dec 2010 22:41:52 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([84.229.142.197]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LDA004E36TQ9N30@a-mtaout20.012.net.il>; Sat, 11 Dec 2010 22:41:52 +0200 (IST) In-reply-to: <781E581B-DE27-4C7E-B97A-DF133D7AD38E@boostpro.com> X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 11 Dec 2010 15:36:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:42429 Archived-At: > Cc: "7563@debbugs.gnu.org" <7563@debbugs.gnu.org> > From: Dave Abrahams > 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".