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 12:32:16 +0100 Message-ID: <87lg6facvz.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> <87y3afivju.fsf@portable.galex-713.eu> <831s87lmg0.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 1540899896 20102 195.159.176.226 (30 Oct 2018 11:44:56 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 30 Oct 2018 11:44:56 +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: contovob@tcd.ie, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Oct 30 12:44:51 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 1gHSS3-00057a-5t for ged-emacs-devel@m.gmane.org; Tue, 30 Oct 2018 12:44:51 +0100 Original-Received: from localhost ([::1]:52413 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gHSU9-00074R-IN for ged-emacs-devel@m.gmane.org; Tue, 30 Oct 2018 07:47:01 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:32814) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gHSGE-0001FP-Js for emacs-devel@gnu.org; Tue, 30 Oct 2018 07:32:39 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gHSGC-0000oI-0S for emacs-devel@gnu.org; Tue, 30 Oct 2018 07:32:38 -0400 Original-Received: from portable.galex-713.eu ([2a00:5884:8305::1]:60266) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gHSG4-0000OX-MS; Tue, 30 Oct 2018 07:32:30 -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 1gHSFs-00021S-Mq; Tue, 30 Oct 2018 12:32:19 +0100 PGP-FINGERPRINT: E109 9988 4197 D7CB B0BC 5C23 8DEB 24BA 867D 3F7F Accept-Language: fr, en, eo, it, br In-Reply-To: <831s87lmg0.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 30 Oct 2018 13:10:23 +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:230816 Archived-At: On 2018/10/30 at 13:10, Eli Zaretskii wrote: >> From: "Garreau\, Alexandre" >> Cc: "Basil L. Contovounesios" , emacs-devel@gnu.org >> Date: Tue, 30 Oct 2018 11:21:57 +0100 >>=20 >> > Will the following minor change make that abundantly clear? >> > >> > Insert output in buffer DESTINATION before point; t means current buf= fer; >>=20 >> Yes it does. > > Fixed. >> > (What else can "insert in ... before point" mean, in Emacs?) >>=20 >> In this docstring, it may be interpreted as a filename referred by a >> string, or something referred by another value (the two-streams list). > > "Point" only ever refers to Emacs buffers, never to anything else. Oh you=E2=80=99re right! Then with some context-sensitive deduction, you w= ould guess DESTINATION as a buffer. However having to rely on deduction and context to understand a piece of doc looks silly, and if it does stuff with buffers it looks better to me to clearly have the word =E2=80=9Cbuffer=E2=80=9D within near. So I believ= e it is better with a such fix: thank you!