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#16115: 24.3.50; doc string of `display-buffer-in-side-window' - there is no SIDE arg Date: Sat, 14 Dec 2013 08:20:15 -0800 (PST) Message-ID: References: <97eeb516-4c10-4ed9-8934-932366fc3ce5@default> <52A8A708.9070801@gmx.at> <52A98C71.4090109@gmx.at> <52A9FBDA.6050207@gmx.at> <87fvpw25yx.fsf@mail.jurta.org> <52AC3FAA.2070601@gmx.at> 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 1387038079 5773 80.91.229.3 (14 Dec 2013 16:21:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 14 Dec 2013 16:21:19 +0000 (UTC) Cc: 16115@debbugs.gnu.org To: martin rudalics , Juri Linkov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Dec 14 17:21:23 2013 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 1Vrrxz-00037c-BC for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Dec 2013 17:21:23 +0100 Original-Received: from localhost ([::1]:47787 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vrrxy-0001B5-Kk for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Dec 2013 11:21:22 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40712) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vrrxn-0001At-1a for bug-gnu-emacs@gnu.org; Sat, 14 Dec 2013 11:21:19 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vrrxe-0001l5-8d for bug-gnu-emacs@gnu.org; Sat, 14 Dec 2013 11:21:10 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36199) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vrrxe-0001l1-54 for bug-gnu-emacs@gnu.org; Sat, 14 Dec 2013 11:21:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Vrrxd-0008NQ-QF for bug-gnu-emacs@gnu.org; Sat, 14 Dec 2013 11:21:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 Dec 2013 16:21:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16115 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 16115-submit@debbugs.gnu.org id=B16115.138703802132135 (code B ref 16115); Sat, 14 Dec 2013 16:21:01 +0000 Original-Received: (at 16115) by debbugs.gnu.org; 14 Dec 2013 16:20:21 +0000 Original-Received: from localhost ([127.0.0.1]:50218 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Vrrwy-0008ME-GK for submit@debbugs.gnu.org; Sat, 14 Dec 2013 11:20:20 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:35916) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Vrrww-0008M6-AH for 16115@debbugs.gnu.org; Sat, 14 Dec 2013 11:20:18 -0500 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id rBEGKGXp021629 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 14 Dec 2013 16:20:17 GMT Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id rBEGKGrL027708 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat, 14 Dec 2013 16:20:16 GMT Original-Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id rBEGKFZF027703; Sat, 14 Dec 2013 16:20:15 GMT In-Reply-To: <52AC3FAA.2070601@gmx.at> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: acsinet22.oracle.com [141.146.126.238] 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:81964 Archived-At: > > Shouldn't `display-buffer-below-selected' display the buffer below, > > and not on the right? I.e. like you recently added the let-binding > > `(split-width-threshold)' to `display-buffer-at-bottom', > > it would also make sense to do the same by moving the let-binding > > `(split-height-threshold 0)' to `display-buffer-below-selected'. >=20 > Just that now we apparently have a request for displaying the buffer at > the right ... No, we do not. To be clear - On StackOverflow someone asked how to do that; that's all. The request was to get pretty much the effect of `C-x 3 C-x o C-x b some-buffer', essentially popping to a buffer in a window on the right. I don't do that kind of thing often, so I looked in the doc for a possible answer. I thought I recalled seeing info about how to do things like this in the various long threads about the new fine-tuning possibilities of `display-buffer', so I figured there was likely a simple way to do this, or at least some way. I came across `display-buffer-in-side-window', and both its name and its doc seemed to correspond to the request. I quickly wrote a command that used that function, and that command seemed (still seems) to DTRT. I sent a minor bug report, mentioning only that there is no SIDE parameter (which parameter is incorrectly mentioned in the doc string). Nothing more. There was no request for a function to pop to a buffer at the right. What you might consider, if you like, is to make clear in the doc, if it is not already so (and I couldn't find it), what is available to do what the OP requested, IOW, what is the right way, if there is a way, to pop to a buffer at the right. And you might want to make clear in the `display-buffer-in-side-window' doc that it is not for this - and why not: what it is really for, since its name and current doc misled at least me in this regard. If you do not want to do that, fine. THIS bug report is only about asking that SIDE be removed from the doc string, which I think Martin has already done. As far as I am concerned, if that is done then this bug is fixed.