From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: "Garreau\, Alexandre" Newsgroups: gmane.emacs.devel Subject: Re: `call-process', to a string Date: Tue, 30 Oct 2018 11:21:57 +0100 Message-ID: <87y3afivju.fsf@portable.galex-713.eu> References: <87woq0sf4a.fsf@portable.galex-713.eu> <87pnvssegv.fsf@portable.galex-713.eu> <87ftwotbkv.fsf@tcd.ie> <83efc7lx4w.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1540894805 6616 195.159.176.226 (30 Oct 2018 10:20:05 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 30 Oct 2018 10:20:05 +0000 (UTC) User-Agent: Gnus (5.13), GNU Emacs 25.1.1 (i686-pc-linux-gnu, GTK+ Version 3.22.11) of 2017-09-15, modified by Debian Cc: "Basil L. Contovounesios" , emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Oct 30 11:20:01 2018 Return-path: Envelope-to: ged-emacs-devel@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 1gHR7x-0001ar-14 for ged-emacs-devel@m.gmane.org; Tue, 30 Oct 2018 11:20:01 +0100 Original-Received: from localhost ([::1]:51980 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gHRA3-0007rD-6P for ged-emacs-devel@m.gmane.org; Tue, 30 Oct 2018 06:22:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36685) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gHR9t-0007r4-6E for emacs-devel@gnu.org; Tue, 30 Oct 2018 06:22:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gHR9s-0002KC-Bc for emacs-devel@gnu.org; Tue, 30 Oct 2018 06:22:01 -0400 Original-Received: from portable.galex-713.eu ([2a00:5884:8305::1]:60086) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gHR9s-0002Ii-2a; Tue, 30 Oct 2018 06:22:00 -0400 Original-Received: from localhost ([::1] helo=portable.galex-713.eu) by portable.galex-713.eu with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1gHR9p-0001c8-Bc; Tue, 30 Oct 2018 11:21:57 +0100 PGP-FINGERPRINT: E109 9988 4197 D7CB B0BC 5C23 8DEB 24BA 867D 3F7F Accept-Language: fr, en, eo, it, br In-Reply-To: <83efc7lx4w.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 30 Oct 2018 09:19:27 +0200") X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:5884:8305::1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:230809 Archived-At: Le 30/10/2018 =C3=A0 09h19, Eli Zaretskii a =C3=A9crit=C2=A0: >> From: "Basil L. Contovounesios" >> Date: Tue, 30 Oct 2018 02:25:36 +0000 >> Cc: emacs-devel >>=20 >> >> Insert output in DESTINATION before point; t means current buffer; ni= l for DESTINATION >> >> means discard it; 0 means discard and don=E2=80=99t wait; and =E2=80= =98(:file FILE)=E2=80=99, where >> >> FILE is a file name string, means that it should be written to that = file >> >> (if the file already exists it is overwritten). >> >> DESTINATION can also have the form (REAL-BUFFER STDERR-FILE); in that= case, >> >> REAL-BUFFER says what to do with standard output, as above, >> >> while STDERR-FILE says what to do with standard error in the child. >> >> STDERR-FILE may be nil (discard standard error output), >> >> t (mix it with ordinary output), or a file name string. >> > >> > I also notice it is not documented that DESTINATION may be a buffer, in >> > which case the output is inserted in the said buffer (I checked). >>=20 >> Indeed this does not seem to be documented in the docstring of >> call-process > > ??? You have just quoted the part where it does document that: > > Insert output in DESTINATION before point; t means current buffer; > > Will the following minor change make that abundantly clear? > > Insert output in buffer DESTINATION before point; t means current buffer; Yes it does. > (What else can "insert in ... before point" mean, in Emacs?) In this docstring, it may be interpreted as a filename referred by a string, or something referred by another value (the two-streams list). I find it more clear if precising anyway, at this function may not output to buffer.