From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: Small docstring improvements Date: Fri, 19 Aug 2016 12:34:40 -0700 Message-ID: References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1471635332 2282 195.159.176.226 (19 Aug 2016 19:35:32 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 19 Aug 2016 19:35:32 +0000 (UTC) User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/25.1 (darwin) Cc: Emacs developers To: Philipp Stephani Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Aug 19 21:35:27 2016 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 1bapZe-0000Ht-Un for ged-emacs-devel@m.gmane.org; Fri, 19 Aug 2016 21:35:27 +0200 Original-Received: from localhost ([::1]:58747 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bapZf-0004Q3-4b for ged-emacs-devel@m.gmane.org; Fri, 19 Aug 2016 15:35:27 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51392) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bapZ3-0004Pn-BX for emacs-devel@gnu.org; Fri, 19 Aug 2016 15:34:50 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bapYz-0006wm-52 for emacs-devel@gnu.org; Fri, 19 Aug 2016 15:34:48 -0400 Original-Received: from mail-pa0-x22f.google.com ([2607:f8b0:400e:c03::22f]:35862) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bapYy-0006wi-U7 for emacs-devel@gnu.org; Fri, 19 Aug 2016 15:34:45 -0400 Original-Received: by mail-pa0-x22f.google.com with SMTP id pp5so18716782pac.3 for ; Fri, 19 Aug 2016 12:34:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:references:mail-followup-to:date:in-reply-to :message-id:user-agent:mime-version; bh=HfqIakdEKwNK7CWH+lhXgXC5UwyHK4QpGpSshEwAFe0=; b=s7baqC1Fp60Ro0Rc+23ff9VXz5PdI02nyCNU0bHmT+GqD3TenLYJ24TVN96mZmuNpb 4sPU6KMoSaewbO/rf3CB0yMoKRuFKWcGsKIDBLM/dEi0uAgBet/CSfEhh5PsMtObczf2 M4LvKCVnzCFglxr6YBLvS8w3O3+x82KI9JO9jeK654CUwhVPDNTdMMi5bGl3GdCg7MAr ksSeCc62TDFKLSuMqSEENSdx8WjU+vPffTdDkcbtO+9RInlRJhfYypBozvuLZfD3wzeM o8lzJx1wwepO/F8u60AP18ZTtCXqh1hZ9XgKCIFWfvpU6jhb9hK1kBpk70G4zHMC0tT8 v2qw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:references:mail-followup-to :date:in-reply-to:message-id:user-agent:mime-version; bh=HfqIakdEKwNK7CWH+lhXgXC5UwyHK4QpGpSshEwAFe0=; b=fV7RqbOQTWS0TxrX+Z1uNTWQIzoOQ0G8+0arvrryTxcnD/CIv6jc5t8qZj3/KFb+DI WPaYx3k9c2PIYr19iaMy7xhi1DE6/0T2V4U6P+JklPyOgXy63x59NBAGpK/4iLlbTmVb SSwg9YuPiMCIFTTrppwOmL2VuD/1Vk/5WgWEe4MoGR2oO+0/9miZ3Bp626f38semtWdI nPqTsYn4b5SakBkMHjUL37QFkyoyXugf0KvfozOCQ57fONQvSeCkuNpq/H8yNgYigofc 3jrRXknoQm3DTcB0z0QoDDkRF7jqwmeIQNot5dWJvxfeZwiCPn29CYfPH7lcxt9MJfhi XtFQ== X-Gm-Message-State: AEkoous8X0klSWaNaQE16s2ozyj4ZTQm33udgeorvmSHviZJ0YPedAoXw0Ney+aQnqHgKA== X-Received: by 10.66.135.13 with SMTP id po13mr16755526pab.113.1471635284012; Fri, 19 Aug 2016 12:34:44 -0700 (PDT) Original-Received: from Vulcan.local (76-234-69-149.lightspeed.frokca.sbcglobal.net. [76.234.69.149]) by smtp.gmail.com with ESMTPSA id g21sm8398651pfj.88.2016.08.19.12.34.42 (version=TLS1 cipher=AES128-SHA bits=128/128); Fri, 19 Aug 2016 12:34:42 -0700 (PDT) X-Google-Original-From: "John Wiegley" Original-Received: by Vulcan.local (Postfix, from userid 501) id 0C13D205657B; Fri, 19 Aug 2016 12:34:40 -0700 (PDT) Mail-Followup-To: Philipp Stephani , Emacs developers In-Reply-To: (Philipp Stephani's message of "Fri, 19 Aug 2016 19:26:14 +0000") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c03::22f 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:206684 Archived-At: >>>>> "PS" == Philipp Stephani writes: PS> +START and END are normally buffer positions specifying the part of the PS> +buffer to send to the process. PS> +If START is nil, that means to use the entire buffer contents; END is PS> +ignored. I would phrase a little differently: +If START and END are both buffer positions, they specify the region +to send to the process. +If START is nil, it means to use the entire buffer contents; END is +ignored. PS> +If START is a string, then send that string to the process +instead of PS> any buffer contents; END is ignored. This is a horrible abuse. There should be another function `call-process-with-string'. I don't like the way that "START" has three separate meanings, only one of which has anything to do with beginning a START of something. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2