From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#18478: [Patch] Mention the return value of `clone-indirect-buffer' Date: Wed, 17 Sep 2014 18:47:01 -0700 (PDT) Message-ID: <4919c10d-ac35-475d-9b66-12deaa8d7fbe@default> References: <9cf30244-8e2e-4c74-8cf8-1476ec97c61f@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1411004921 27101 80.91.229.3 (18 Sep 2014 01:48:41 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 18 Sep 2014 01:48:41 +0000 (UTC) Cc: 18478@debbugs.gnu.org To: Tom Willemse Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Sep 18 03:48:28 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XUQpg-0000kV-Hd for geb-bug-gnu-emacs@m.gmane.org; Thu, 18 Sep 2014 03:48:28 +0200 Original-Received: from localhost ([::1]:48050 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XUQpg-0006oY-7e for geb-bug-gnu-emacs@m.gmane.org; Wed, 17 Sep 2014 21:48:28 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36380) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XUQpU-0006nI-Tf for bug-gnu-emacs@gnu.org; Wed, 17 Sep 2014 21:48:25 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XUQpM-00028g-7c for bug-gnu-emacs@gnu.org; Wed, 17 Sep 2014 21:48:16 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:52201) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XUQpM-00028I-4o for bug-gnu-emacs@gnu.org; Wed, 17 Sep 2014 21:48:08 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XUQpG-000725-NW for bug-gnu-emacs@gnu.org; Wed, 17 Sep 2014 21:48:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 18 Sep 2014 01:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 18478 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 18478-submit@debbugs.gnu.org id=B18478.141100482926969 (code B ref 18478); Thu, 18 Sep 2014 01:48:02 +0000 Original-Received: (at 18478) by debbugs.gnu.org; 18 Sep 2014 01:47:09 +0000 Original-Received: from localhost ([127.0.0.1]:43765 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XUQoO-00070v-OA for submit@debbugs.gnu.org; Wed, 17 Sep 2014 21:47:09 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:28252) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XUQoM-00070n-UX for 18478@debbugs.gnu.org; Wed, 17 Sep 2014 21:47:07 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s8I1l4E7030226 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 18 Sep 2014 01:47:05 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id s8I1l3wW028452 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Thu, 18 Sep 2014 01:47:03 GMT Original-Received: from abhmp0011.oracle.com (abhmp0011.oracle.com [141.146.116.17]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s8I1l2XV006235; Thu, 18 Sep 2014 01:47:02 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:93446 Archived-At: > >> I've attached a suggestion for mentioning the return value for > >> `clone-indirect-buffer'. Please let me know what you think. > > > > Looks OK to me. You can also simplify it to just "Returns...". >=20 > Certainly, if that has your preference. I have no preference. And my preference doesn't count for anything. I just reported the bug. > I just thought that because it is a new paragraph and the ones > before it talk about the meanings of the arguments it would be > clearer to explicitly state it's about the function. Yes, but I don't see any chance for confusion there. It is only the function return value that matters. And arguments do not "return". They are evaluated, of course, and their values are returned by that evaluation. But we just speak of their "values". > I actually would have liked to start the docstring off with "Create > and return ..." as the docstring for `clone-buffer' does, but checkdoc > then started complaining about the line being more than 80 characters > long. FWIW, I don't put a lot of stock in checkdoc, personally. ;-)