From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#31648: 26; (elisp) `Indirect Buffers': `clone-indirect-buffer' Date: Sat, 02 Jun 2018 14:19:07 +0300 Message-ID: <83fu25e8r8.fsf@gnu.org> References: <0c0705a4-6790-4267-ab5e-59519f3d9915@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1527938293 30638 195.159.176.226 (2 Jun 2018 11:18:13 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 2 Jun 2018 11:18:13 +0000 (UTC) Cc: 31648-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jun 02 13:18:09 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1fP4Xw-0007rY-AP for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jun 2018 13:18:08 +0200 Original-Received: from localhost ([::1]:59197 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fP4a3-0001Sb-AG for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jun 2018 07:20:19 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39539) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fP4Zs-0001NV-6q for bug-gnu-emacs@gnu.org; Sat, 02 Jun 2018 07:20:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fP4Zm-0003oi-Q8 for bug-gnu-emacs@gnu.org; Sat, 02 Jun 2018 07:20:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:50535) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fP4Zm-0003oC-Kv for bug-gnu-emacs@gnu.org; Sat, 02 Jun 2018 07:20:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fP4Zm-0008B5-E7 for bug-gnu-emacs@gnu.org; Sat, 02 Jun 2018 07:20:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 02 Jun 2018 11:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 31648 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 31648@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 31648-done@debbugs.gnu.org id=D31648.152793835931372 (code D ref 31648); Sat, 02 Jun 2018 11:20:02 +0000 Original-Received: (at 31648-done) by debbugs.gnu.org; 2 Jun 2018 11:19:19 +0000 Original-Received: from localhost ([127.0.0.1]:58431 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fP4Z2-00089u-QD for submit@debbugs.gnu.org; Sat, 02 Jun 2018 07:19:18 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:48478) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fP4Z1-00089g-2w for 31648-done@debbugs.gnu.org; Sat, 02 Jun 2018 07:19:15 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fP4Yq-0001uo-SW for 31648-done@debbugs.gnu.org; Sat, 02 Jun 2018 07:19:09 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:44459) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fP4Yq-0001uH-PY; Sat, 02 Jun 2018 07:19:04 -0400 Original-Received: from [176.228.60.248] (port=2164 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fP4Yp-0005fw-9g; Sat, 02 Jun 2018 07:19:04 -0400 In-reply-to: <0c0705a4-6790-4267-ab5e-59519f3d9915@default> (message from Drew Adams on Tue, 29 May 2018 15:25:44 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:146856 Archived-At: > Date: Tue, 29 May 2018 15:25:44 -0700 (PDT) > From: Drew Adams > > The doc of `clone-indirect-buffer' is incorrect. It implies that the > new, indirect buffer, is not displayed when the command is invoked > interactively. > > The doc string is correct. Please correct the manual similarly. The > statement of the second sentence here, from the doc string is missing > from the manual: > > DISPLAY-FLAG non-nil means show the new buffer with 'pop-to-buffer'. > This is always done when called interactively. > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ I added a note about DISPLAY-FLAG in interactive calls, but in general you shouldn't expect this to be spelled out in the ELisp manual, because interactive invocation of commands is described in the Emacs manual, and the ELisp manual is biased towards non-interactive uses. > (One might wonder why non-nil, instead of nil, was chosen to show the > buffer, since that's the default interactive behavior - but it's too > late now.) ??? It's the default interactively, but not in non-interactive calls. It should be clear that non-interactive calls don't necessarily want to display the cloned buffer.