From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.devel Subject: Re: `call-process', to a string [Was: Re: Automatically set eww-download-directory according xdg dir] Date: Wed, 31 Oct 2018 12:44:50 +0000 Message-ID: <87muqup9od.fsf@tcd.ie> 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 1540989778 27830 195.159.176.226 (31 Oct 2018 12:42:58 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 31 Oct 2018 12:42:58 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: galex-713@galex-713.eu, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 31 13:42:54 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 1gHppl-00077W-Tn for ged-emacs-devel@m.gmane.org; Wed, 31 Oct 2018 13:42:54 +0100 Original-Received: from localhost ([::1]:59265 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gHprs-00043w-9Y for ged-emacs-devel@m.gmane.org; Wed, 31 Oct 2018 08:45:04 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56203) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gHprm-00043l-65 for emacs-devel@gnu.org; Wed, 31 Oct 2018 08:44:58 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gHpri-0007By-5G for emacs-devel@gnu.org; Wed, 31 Oct 2018 08:44:58 -0400 Original-Received: from mail-ed1-x536.google.com ([2a00:1450:4864:20::536]:39944) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gHprh-0007Aw-Sm for emacs-devel@gnu.org; Wed, 31 Oct 2018 08:44:54 -0400 Original-Received: by mail-ed1-x536.google.com with SMTP id z12-v6so7706716edp.7 for ; Wed, 31 Oct 2018 05:44:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=2OUv5GPeK2BrOtbUtl27+Xc+xN399MyQG4MtD1TOxuU=; b=YSOQX7n7Tx84WqE99JOvBiUSBE8WCsDQA1nzsC85IJ3c8GV6xEEOixyJsG5sOhLsLa 1I0CwOHdemaakr2BtXE1cU01bzq/zppaxKI75g9ebdTCUQNrIxeEz4sep+XycDzFAZ3y QuzPTRq374uanmlGBizPojw1FDJtAeyR2ZUhXngiVY9oGIm+xmVcKGc4NLODm4UqaBjV iesv7qbBCmP3xIGLCILnuLcjdYgITKxCVC8PSoyOsLFj7SXWmk5epAgCyHPhMzTmR1ul K2uljI3TjKJuK7W3CEgMU8R614FrXOuNp6nRaVPe8kDJH8iNxt459rGORiJOz6CYV1v+ hhCQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=2OUv5GPeK2BrOtbUtl27+Xc+xN399MyQG4MtD1TOxuU=; b=YmYjOgxpbrxFMrzf9FP0MUVqlJ3KZu/TRnqPfaFGdhhpWWojYpvoW3y5S2fd7Tc6ri LHh7S931Qp/Y7ZzLwn7/4TqO1DWyEb4/cW3l2huOrT6+/lRW26PWqE4lsmwx55+s8y+/ MZTXlRQYF9RjA47drt5a2P0+HupyKbBS7B26Yd796DQD7VJEcfuN/YI5B03tcjdzEvxS B/iV9tPJ7WGG9aMERlobvHwPC2a/OzRGsYXtLfh0aarpnQNM/BboLaEH/fwyzXvjUcDN Pv1N0/5s+uvNqHwDt5cCRdJwJAmak1PY7yZfd4aVpQ4Q1ribWu2xe/mDX5PbXasT9zhw Ovgg== X-Gm-Message-State: AGRZ1gI8oJXJaAoy65vbwyrTy1Czum/AjtxFXvrvMRWZ8IVTVr/KjxW5 qRWadJkbwCEl9cjewuAJ5kdjDg== X-Google-Smtp-Source: AJdET5cKFLwCyp8LqIzdWx6buWb7/JF0oJxlDJ6a4mVU6Zafwi72GJ3TTPfIcuiUmG7Xlb2PuIPGmw== X-Received: by 2002:a50:98a6:: with SMTP id j35-v6mr1956366edb.273.1540989892515; Wed, 31 Oct 2018 05:44:52 -0700 (PDT) Original-Received: from localhost (51-171-243-2-dynamic.agg2.clk.blp-srl.eircom.net. [51.171.243.2]) by smtp.gmail.com with ESMTPSA id x21-v6sm440625ejf.2.2018.10.31.05.44.51 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 31 Oct 2018 05:44:51 -0700 (PDT) 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:1450:4864:20::536 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:230871 Archived-At: Eli Zaretskii writes: >> 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; Mea culpa. That's what I get for writing emails past 02:00. > Will the following minor change make that abundantly clear? > > Insert output in buffer DESTINATION before point; t means current buffer; > > (What else can "insert in ... before point" mean, in Emacs?) You're right, it's unambiguous. Either way, thank you for clarifying the docstring on the emacs-26 branch; it's a welcome improvement. --=20 Basil