From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#30349: 27.0.50; Cuonfusing documentation about pipe processes Date: Tue, 06 Feb 2018 20:55:28 +0200 Message-ID: <83lgg66j8f.fsf@gnu.org> References: <87zi4ndjlz.fsf@users.sourceforge.net> <83tvuu7oxo.fsf@gnu.org> <87shaee2t8.fsf@users.sourceforge.net> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1517943278 4185 195.159.176.226 (6 Feb 2018 18:54:38 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 6 Feb 2018 18:54:38 +0000 (UTC) Cc: p.stephani2@gmail.com, 30349@debbugs.gnu.org To: Noam Postavsky Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Feb 06 19:54:34 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ej8Ni-000856-HZ for geb-bug-gnu-emacs@m.gmane.org; Tue, 06 Feb 2018 19:54:14 +0100 Original-Received: from localhost ([::1]:50951 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ej8Pj-0007Ck-Tv for geb-bug-gnu-emacs@m.gmane.org; Tue, 06 Feb 2018 13:56:19 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38224) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ej8PV-0007AX-8F for bug-gnu-emacs@gnu.org; Tue, 06 Feb 2018 13:56:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ej8PS-0002zH-2t for bug-gnu-emacs@gnu.org; Tue, 06 Feb 2018 13:56:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52656) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ej8PR-0002zA-UE for bug-gnu-emacs@gnu.org; Tue, 06 Feb 2018 13:56:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ej8PR-00019X-NT for bug-gnu-emacs@gnu.org; Tue, 06 Feb 2018 13:56:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 06 Feb 2018 18:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 30349 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 30349-submit@debbugs.gnu.org id=B30349.15179433444407 (code B ref 30349); Tue, 06 Feb 2018 18:56:01 +0000 Original-Received: (at 30349) by debbugs.gnu.org; 6 Feb 2018 18:55:44 +0000 Original-Received: from localhost ([127.0.0.1]:60553 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ej8PA-000191-BN for submit@debbugs.gnu.org; Tue, 06 Feb 2018 13:55:44 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:47154) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ej8P8-00018l-4C for 30349@debbugs.gnu.org; Tue, 06 Feb 2018 13:55:42 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ej8Oz-0002rT-Nm for 30349@debbugs.gnu.org; Tue, 06 Feb 2018 13:55:36 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:48796) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ej8Oz-0002rP-In; Tue, 06 Feb 2018 13:55:33 -0500 Original-Received: from [176.228.60.248] (port=1363 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1ej8Oy-0003Cj-No; Tue, 06 Feb 2018 13:55:33 -0500 In-reply-to: <87shaee2t8.fsf@users.sourceforge.net> (message from Noam Postavsky on Tue, 06 Feb 2018 07:10:43 -0500) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:142978 Archived-At: > From: Noam Postavsky > Cc: p.stephani2@gmail.com, 30349@debbugs.gnu.org > Date: Tue, 06 Feb 2018 07:10:43 -0500 > > >> I don't think there is such a thing. That phrase seems to have been > >> copied across all the make-*-process functions. > > > > And is wrong in all of them? > > I think so. > > > Could it be that the phrase originally meant shell-style redirection? > > Perhaps, but none of those functions support that, as far as I know. Did you look at Git history of how that text was introduced? Maybe that will tell us something. Or maybe the discussions/bug report around the time this text was written/modified will give a hint. (Sorry I'm not doing this research myself, but I'm terribly busy these days, and won't have time for it for another couple of days.) > > This goes too far in deleting stuff that is useful: the part of the > > second sentence that follows "unless", which talks about specifying a > > filter function, should be left alone. Without it, "The default > > filter function ..." surprises the reader, since it talks about the > > default of something that wasn't mentioned before. > > Not entirely sure I follow, did you actually mean the part that > *precedes* "unless" should be left alone? As in: > > :buffer BUFFER -- BUFFER is the buffer (or buffer-name) to associate > with the process. Process output goes at end of that buffer, unless > you specify a filter function to handle the output. [...] Yes. And then the sentence about the default filter function. Thanks.