From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#30349: 27.0.50; Cuonfusing documentation about pipe processes Date: Tue, 06 Feb 2018 07:10:43 -0500 Message-ID: <87shaee2t8.fsf@users.sourceforge.net> References: <87zi4ndjlz.fsf@users.sourceforge.net> <83tvuu7oxo.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1517918993 26768 195.159.176.226 (6 Feb 2018 12:09:53 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 6 Feb 2018 12:09:53 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.90 (gnu/linux) Cc: p.stephani2@gmail.com, 30349@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Feb 06 13:09:48 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 1ej23s-0004vD-Jn for geb-bug-gnu-emacs@m.gmane.org; Tue, 06 Feb 2018 13:09:20 +0100 Original-Received: from localhost ([::1]:34787 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ej25s-0003Lu-2k for geb-bug-gnu-emacs@m.gmane.org; Tue, 06 Feb 2018 07:11:24 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43596) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ej25g-0003KB-LT for bug-gnu-emacs@gnu.org; Tue, 06 Feb 2018 07:11:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ej25W-0000X2-P7 for bug-gnu-emacs@gnu.org; Tue, 06 Feb 2018 07:11:12 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51707) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ej25W-0000Ww-KQ for bug-gnu-emacs@gnu.org; Tue, 06 Feb 2018 07:11:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ej25W-00023i-63 for bug-gnu-emacs@gnu.org; Tue, 06 Feb 2018 07:11:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 06 Feb 2018 12:11:02 +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.15179190537900 (code B ref 30349); Tue, 06 Feb 2018 12:11:02 +0000 Original-Received: (at 30349) by debbugs.gnu.org; 6 Feb 2018 12:10:53 +0000 Original-Received: from localhost ([127.0.0.1]:59604 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ej25N-00023M-A5 for submit@debbugs.gnu.org; Tue, 06 Feb 2018 07:10:53 -0500 Original-Received: from mail-io0-f173.google.com ([209.85.223.173]:43375) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ej25L-000239-W9 for 30349@debbugs.gnu.org; Tue, 06 Feb 2018 07:10:52 -0500 Original-Received: by mail-io0-f173.google.com with SMTP id 72so2251817iom.10 for <30349@debbugs.gnu.org>; Tue, 06 Feb 2018 04:10:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=536Tm2o8Wt/6Oj4IjSRgdLXTdeHJ9Y2FX4KmQZ51+UI=; b=Ft9Wb2Tk56DKT2JhVb1D8Cl+VoJz9lRMvHHMdyXPVmEmnuXsp/rC5gf8eAB8hNP16j LzxIBHXf6ynnT3RO7a48iGhvaU/p/kQDGWO+r8kEnOvUHJjbTLyNQFhSwlHL4fGZbGoY CaCxinZzry60S07KJ6IpmDXZ3ro2rbJP4meQQkb1MioLMvWirwCHtVlY9RfhEMI51ARa VcLSU0cudsAjOwKA2cjl/22GocCU/fQmB0Rc0y5qHvYwc31fHWrSqIkEM0JGgnNwHv5q yxDvb+C1XnulEYaWCwXLQvR1gFLjqH0pIyWM+I63P1Hebej+rrvbC2H4f0u6UYRUprCu mDbA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=536Tm2o8Wt/6Oj4IjSRgdLXTdeHJ9Y2FX4KmQZ51+UI=; b=AyRh2Hi++mimaR3aQiP67PZSImp7y6hacNN0GvXvONWijk4lqjlt9EjLp09aXtefb4 Z69wxAWEmWEmIE7xVrUtUuLFJNDixC0/yPUvmnTdEj2ZOIwj6qE2TKdJzWdh22N2Lpjp 9OVG0N9HKqdVzc4cMn1L0aE6P3gb0F/1Np2MaNC9giExkUFCSD/PLOwXA+kAjjmUftLF mzhprSVTImKkJdoMYRiZZ0CNQrk6KJTf59dWS/ZpOnOExRGz1WkKA2/olcs7JZOfgBgV t22GFkTXk8RZmbsNTjloSm/cCm9kJI+4ERfXN8upI+Q7qnv5s9nP1d125fzjPH9uJP51 T2Pw== X-Gm-Message-State: APf1xPDacPtiv0o/mKMEw8xOXQRW7EQdUc7mOfdiKr2m3NBlDZLAtJag Bh6StZ+8hyBa0x0y1cIJ5vb5bQ== X-Google-Smtp-Source: AH8x226tp1Zt0ZZA7B8vMvzFp4u02bYObrih50UUK+nnCGBSH1azcy5qUsGwnd6EBv2VzU0fnzqwTQ== X-Received: by 10.107.138.20 with SMTP id m20mr2701426iod.192.1517919046056; Tue, 06 Feb 2018 04:10:46 -0800 (PST) Original-Received: from zebian (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id c15sm4831517itd.4.2018.02.06.04.10.44 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 06 Feb 2018 04:10:44 -0800 (PST) In-Reply-To: <83tvuu7oxo.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 06 Feb 2018 05:54:43 +0200") 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:142973 Archived-At: Eli Zaretskii writes: >> From: Noam Postavsky >> Date: Mon, 05 Feb 2018 19:53:12 -0500 >> Cc: 30349@debbugs.gnu.org >> >> > ":buffer BUFFER -- BUFFER is the buffer (or buffer-name) to associate >> > with the process. Process output goes at the end of that buffer, >> > unless you specify an output stream or filter function to handle the >> > output." >> > >> > => How do you specify an output stream? >> >> 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. >> @item :stop @var{stopped} >> +If @var{stopped} is non-@code{nil}, start the process in the stopped >> +state. In the stopped state, a pipe process does not accept incoming >> +data, but you can send outgoing data. The stopped state is cleared by >> +@code{continue-process} and set by @code{stop-process}. > > In the last sentence, I'd swap the order of references to clearing and > setting the stopped state. I'd also add a @pxref to where those two > functions are described. Ok. > 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. [...] Otherwise, mentioning both "the default filter function" and "unless you specify a filter function" feels redundant to me: :buffer BUFFER -- BUFFER is the buffer (or buffer-name) to associate with the process. The default filter function writes process output at the end of that buffer, unless you specify a filter function to handle the output. [...]