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#7865: 24.0.50; doc of display-buffer-reuse-frames Date: Wed, 19 Jan 2011 08:47:45 -0800 Message-ID: <7505A1C76F6C42E4A27159D548366974@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: dough.gmane.org 1295456095 24637 80.91.229.12 (19 Jan 2011 16:54:55 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 19 Jan 2011 16:54:55 +0000 (UTC) To: 7865@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jan 19 17:54:50 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PfbJ3-0004jC-BB for geb-bug-gnu-emacs@m.gmane.org; Wed, 19 Jan 2011 17:54:49 +0100 Original-Received: from localhost ([127.0.0.1]:45129 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PfbJ2-0003FT-PP for geb-bug-gnu-emacs@m.gmane.org; Wed, 19 Jan 2011 11:54:48 -0500 Original-Received: from [140.186.70.92] (port=43835 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PfbIv-0003Ap-In for bug-gnu-emacs@gnu.org; Wed, 19 Jan 2011 11:54:44 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PfbIu-000735-Ei for bug-gnu-emacs@gnu.org; Wed, 19 Jan 2011 11:54:41 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:34408) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PfbIu-00072p-Cw for bug-gnu-emacs@gnu.org; Wed, 19 Jan 2011 11:54:40 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Pfb6g-0005bJ-Mj; Wed, 19 Jan 2011 11:42:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 19 Jan 2011 16:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7865 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.129545529221488 (code B ref -1); Wed, 19 Jan 2011 16:42:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 19 Jan 2011 16:41:32 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Pfb6B-0005aX-9T for submit@debbugs.gnu.org; Wed, 19 Jan 2011 11:41:31 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Pfb69-0005aL-GO for submit@debbugs.gnu.org; Wed, 19 Jan 2011 11:41:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PfbDh-0005eb-Lx for submit@debbugs.gnu.org; Wed, 19 Jan 2011 11:49:18 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:56440) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PfbDh-0005eW-Jk for submit@debbugs.gnu.org; Wed, 19 Jan 2011 11:49:17 -0500 Original-Received: from [140.186.70.92] (port=36155 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PfbDe-0000gU-Uy for bug-gnu-emacs@gnu.org; Wed, 19 Jan 2011 11:49:17 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PfbDd-0005dZ-PX for bug-gnu-emacs@gnu.org; Wed, 19 Jan 2011 11:49:14 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:57583) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PfbDd-0005dT-HN for bug-gnu-emacs@gnu.org; Wed, 19 Jan 2011 11:49:13 -0500 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p0JGnABm024236 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 19 Jan 2011 16:49:12 GMT Original-Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p0JGmZcO021257 for ; Wed, 19 Jan 2011 16:48:35 GMT Original-Received: from abhmt021.oracle.com by acsmt354.oracle.com with ESMTP id 973810421295455667; Wed, 19 Jan 2011 08:47:47 -0800 Original-Received: from dradamslap1 (/130.35.179.10) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 19 Jan 2011 08:47:46 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Acu3+JjUQOa2+31JS8OcxwvGvNxR6Q== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 19 Jan 2011 11:42:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:43448 Archived-At: This option is used in only `display-buffer', in a test that is essentially (or pop-up-frames display-buffer-reuse-frames ...) That means that this option has no effect if `pop-up-frames' is non-nil. This should be made clear wherever `display-buffer-reuse-frames' is documented. (Alternatively, make it clear in one place and cross-reference that place from the others.) These are the places it is documented: 1. Elisp manual, node `Displaying Buffers' 2. Elisp manual, node `Choosing Window' 3. Emacs manual, node `Select Buffer 4. Doc string Only in #1 is this made clear: "If either of the variables `display-buffer-reuse-frames' or `pop-up-frames' is non-`nil'...". (Although "option" would be better than "variable" here - and throughout.) Each of the other spots describes the option without mentioning this. Either add this info to #2 and #3 or reduce/remove their descriptions of the option and just cross-reference to the full description in #1 that does mention this. In any case, the doc string should mention it. Finally, the description of this option in #3 just ends with this: "If there is no such window or `display-buffer-reuse-frames' is `nil', the behavior of `display-buffer' is determined by the variables described next." There follow descriptions of 15 other user options! Does that sentence mean all 15 or just the first two, which are followed by the description of a function? `pop-up-frames' is one of the 15, but it appears after the function description, as the 6th option after `display-buffer-reuse-frames'. And of course `pop-up-frame' determines the behavior even if `display-buffer-reuse-frames' is non-nil - its description should come first. Just remove that last sentence, please - it is confusing and doesn't say anything. If you want, replace it with a sentence saying only that when it is nil it has no effect on the buffer display (other things come into play to govern the behavior). In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-01-17 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/imagesupport/include'