From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel,gmane.emacs.pretest.bugs Subject: display-buffer-other-frame - useful? doc string? Date: Sun, 9 Mar 2008 10:00:41 -0800 Message-ID: <002401c8820f$7d6042c0$0600a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1205085771 26539 80.91.229.12 (9 Mar 2008 18:02:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 9 Mar 2008 18:02:51 +0000 (UTC) To: Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Mar 09 19:03:18 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JYPrd-0003bp-EB for ged-emacs-devel@m.gmane.org; Sun, 09 Mar 2008 19:03:13 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JYPr5-0003Pb-Dl for ged-emacs-devel@m.gmane.org; Sun, 09 Mar 2008 14:02:39 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JYPr0-0003P4-VY for emacs-devel@gnu.org; Sun, 09 Mar 2008 14:02:35 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JYPqz-0003OP-FN for emacs-devel@gnu.org; Sun, 09 Mar 2008 14:02:34 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JYPqz-0003OI-3z for emacs-devel@gnu.org; Sun, 09 Mar 2008 14:02:33 -0400 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1JYPqy-0008Sw-VF for emacs-devel@gnu.org; Sun, 09 Mar 2008 14:02:33 -0400 Original-Received: from mail.gnu.org ([199.232.76.166] helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1JYPqy-00026h-Fn for emacs-pretest-bug@gnu.org; Sun, 09 Mar 2008 14:02:32 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1JYPqv-0008S2-In for emacs-pretest-bug@gnu.org; Sun, 09 Mar 2008 14:02:32 -0400 Original-Received: from agminet01.oracle.com ([141.146.126.228]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JYPqv-0008RR-4W for emacs-pretest-bug@gnu.org; Sun, 09 Mar 2008 14:02:29 -0400 Original-Received: from rgmgw1.us.oracle.com (rgmgw1.us.oracle.com [138.1.186.110]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m29I2QB5029970 for ; Sun, 9 Mar 2008 13:02:26 -0500 Original-Received: from acsmt351.oracle.com (acsmt351.oracle.com [141.146.40.151]) by rgmgw1.us.oracle.com (Switch-3.2.4/Switch-3.2.4) with ESMTP id m29HY7St024149 for ; Sun, 9 Mar 2008 12:02:25 -0600 Original-Received: from inet-141-146-46-1.oracle.com by acsmt350.oracle.com with ESMTP id 3605752031205085679; Sun, 09 Mar 2008 11:01:19 -0700 Original-Received: from dradamslap1 (/141.144.112.116) by bhmail.oracle.com (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 09 Mar 2008 11:01:19 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AciCD3zukSBMiOtSRnm4Nmqvvh29cQ== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3198 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:91900 gmane.emacs.pretest.bugs:21468 Archived-At: Is the command `display-buffer-other-frame' useful as it is currently designed? It displays a buffer in another frame, but it also lowers that frame among all window-manager windows. Even if the buffer was already displayed in another frame, that frame is still lowered behind all others. That hardly seems like TRT. If you ask to display a buffer, you don't want it to be buried out of sight behind all other window-manager windows. Aside from the question of its usefulness, I wonder about its doc string. The first line of the doc string is identical to the first line of the doc string of `switch-to-buffer-other-frame': "Switch to buffer BUFFER in another frame." But `display-buffer-other-frame' does *not* switch to the buffer (it does not select it); it simply displays it (in a not-very-visible fashion). Contrast that with the doc string of `display-buffer', whose first line explicitly says that the buffer is not selected: "Make BUFFER appear in some window but don't select it." Command `display-buffer-other-frame' is not documented in any manual - perhaps for good reason. It seems half-baked, to me. In GNU Emacs 22.1.90.1 (i386-mingw-nt5.1.2600) of 2008-01-30 on PRETEST Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --cflags -Ic:/gnuwin32/include'