From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Matt Swift Newsgroups: gmane.emacs.bugs Subject: documentation of `buffer-list' misleading Date: Sat, 20 Jul 2002 02:04:43 -0400 Sender: bug-gnu-emacs-admin@gnu.org Message-ID: NNTP-Posting-Host: localhost.gmane.org X-Trace: main.gmane.org 1027145117 5429 127.0.0.1 (20 Jul 2002 06:05:17 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 20 Jul 2002 06:05:17 +0000 (UTC) Return-path: Original-Received: from fencepost.gnu.org ([199.232.76.164]) by main.gmane.org with esmtp (Exim 3.33 #1 (Debian)) id 17VnMi-0001PS-00 for ; Sat, 20 Jul 2002 08:05:16 +0200 Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org) by fencepost.gnu.org with esmtp (Exim 3.35 #1 (Debian)) id 17VnMq-0001hm-00; Sat, 20 Jul 2002 02:05:24 -0400 Original-Received: from smtprelay9.dc2.adelphia.net ([64.8.50.53]) by fencepost.gnu.org with esmtp (Exim 3.35 #1 (Debian)) id 17VnMB-0001ff-00 for ; Sat, 20 Jul 2002 02:04:43 -0400 Original-Received: from ZAYIN ([24.49.152.85]) by smtprelay9.dc2.adelphia.net (Netscape Messaging Server 4.15) with ESMTP id GZJA7U00.Z39; Sat, 20 Jul 2002 02:04:42 -0400 Original-To: bug-gnu-emacs@gnu.org Errors-To: bug-gnu-emacs-admin@gnu.org X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.0.11 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Bug reports for GNU Emacs, the Swiss army knife of text editors List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.bugs:2793 X-Report-Spam: http://spam.gmane.org/gmane.emacs.bugs:2793 This bug report will be sent to the Free Software Foundation, not to your local site managers! Please write in English, because the Emacs maintainers do not have translators to read other languages for them. Your bug report will be posted to the bug-gnu-emacs@gnu.org mailing list, and to the gnu.emacs.bug news group. In GNU Emacs 21.2.1 (i386-msvc-nt5.0.2195) of 2002-03-19 on buffy configured using `configure --with-msvc (12.00)' Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: ENU locale-coding-system: iso-latin-1 default-enable-multibyte-characters: t Please describe exactly what actions triggered the bug and the precise symptoms of the bug: The documentation of `buffer-list' in the docstring and the elisp manual v2.7 suggests that the following form in an interactive Lisp session should always evaluate to t, but in fact it is usually not t: (equal (frame-parameter nil 'buffer-list) (buffer-list (selected-frame))) => nil To make the apparent paradox clearer, one could write the equivalent form: (equal (frame-parameter (selected-frame) 'buffer-list) (buffer-list (selected-frame))) => nil Looking at the source in buffer.c, I see that `(buffer-list my-frame)' is returning a list of *all* buffers (that is, the same ones as `(buffer-list nil)' returns) in the order that `other-buffer' is going to examine them when my-frame is the selected frame. Having the name of the function `buffer-list' seem associated with `other-buffer' and not with the related but different frame parameter would be ideal, in my opinion, but I realize that changing the names now would probably cause more problems than it resolves. Clearer documentation would suffice. Recent input: C-n C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-h i M-< t M-s b u f f e r - l i s t C-a C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-p M-x r e p o r t - e m a c s - b u g Recent messages: Searching subfile elisp-19... Searching subfile elisp-20... Searching subfile elisp-21... Searching subfile elisp-22... Searching subfile elisp-23... Searching subfile elisp-24... Searching subfile elisp-25... Searching subfile elisp-26... Loading emacsbug...done