From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? Date: Fri, 21 Aug 2015 21:28:56 +0300 Message-ID: <83lhd4ijh3.fsf@gnu.org> References: <870b6a90-e498-4ed9-9e41-d498edf33aec@default> <83mvxkis5t.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1440181829 417 80.91.229.3 (21 Aug 2015 18:30:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 21 Aug 2015 18:30:29 +0000 (UTC) Cc: 21305@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Aug 21 20:30:18 2015 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 1ZSr4w-0000h7-Qy for geb-bug-gnu-emacs@m.gmane.org; Fri, 21 Aug 2015 20:30:14 +0200 Original-Received: from localhost ([::1]:43151 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSr4w-0004Jj-6C for geb-bug-gnu-emacs@m.gmane.org; Fri, 21 Aug 2015 14:30:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60357) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSr4s-0004Hf-0e for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 14:30:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZSr4n-0004Y6-2g for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 14:30:09 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:42545) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSr4n-0004Wy-0J for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 14:30:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1ZSr4m-0006vB-B8 for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 14:30:04 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 21 Aug 2015 18:30:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21305 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 21305-submit@debbugs.gnu.org id=B21305.144018174426517 (code B ref 21305); Fri, 21 Aug 2015 18:30:03 +0000 Original-Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 18:29:04 +0000 Original-Received: from localhost ([127.0.0.1]:34755 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSr3n-0006td-I1 for submit@debbugs.gnu.org; Fri, 21 Aug 2015 14:29:03 -0400 Original-Received: from mtaout27.012.net.il ([80.179.55.183]:37184) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSr3k-0006tC-QF for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 14:29:02 -0400 Original-Received: from conversion-daemon.mtaout27.012.net.il by mtaout27.012.net.il (HyperSendmail v2007.08) id <0NTG00C002QPFJ00@mtaout27.012.net.il> for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 21:26:01 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout27.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NTG007OL37CIW50@mtaout27.012.net.il>; Fri, 21 Aug 2015 21:26:01 +0300 (IDT) In-reply-to: X-012-Sender: halo1@inter.net.il 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: 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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:105679 Archived-At: > Date: Fri, 21 Aug 2015 08:28:18 -0700 (PDT) > From: Drew Adams > Cc: 21305-done@debbugs.gnu.org > > > > But I think it would be helpful to tell users that the order is > > > the same as that described in `Cyclic Window Ordering'. > > > > What can the users do with that information? (It is already in the > > ELisp manual; I'm talking about the doc string here.) > > In the manual? Where? I don't see it, so far (in the build I have > from 7/31. I do see that the manual says this, but this speaks only > to the meaning of these two arguments - it says nothing about the > order of the windows in the returned value. > > The arguments MINIBUF and ALL-FRAMES have the same meanings as in > ^^^^^^^^^^^^^^^^^^^^^^ > the function 'next-window' (*note Cyclic Window Ordering::). Note > that the ALL-FRAMES argument does _not_ behave exactly like in > 'get-buffer-window'. In the cross-referenced node. > I meant in the manual. There is an xref to that node, but it is > given only for info about arguments MINIBUF and ALL-FRAMES. No, it's not. It actually tells you that this function traverses the window as next-window does. Once again, I think this order is random for all practical purposes, as far as the caller is concerned. I was actually surprised to see it documented in the manual.