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 18:21:18 +0300 Message-ID: <83mvxkis5t.fsf@gnu.org> References: <870b6a90-e498-4ed9-9e41-d498edf33aec@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1440170542 8296 80.91.229.3 (21 Aug 2015 15:22:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 21 Aug 2015 15:22:22 +0000 (UTC) Cc: 21305-done@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 17:22:11 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 1ZSo8x-0003Ab-9q for geb-bug-gnu-emacs@m.gmane.org; Fri, 21 Aug 2015 17:22:11 +0200 Original-Received: from localhost ([::1]:42065 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSo8w-0005JS-Co for geb-bug-gnu-emacs@m.gmane.org; Fri, 21 Aug 2015 11:22:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45494) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSo8s-0005HC-Ad for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 11:22:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZSo8p-0000JV-0p for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 11:22:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:42414) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSo8o-0000JN-Td for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 11:22:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1ZSo8o-0002ZN-NX for bug-gnu-emacs@gnu.org; Fri, 21 Aug 2015 11:22:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Fri, 21 Aug 2015 15:22:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 21305 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 21305@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 21305-done@debbugs.gnu.org id=D21305.14401704889831 (code D ref 21305); Fri, 21 Aug 2015 15:22:02 +0000 Original-Received: (at 21305-done) by debbugs.gnu.org; 21 Aug 2015 15:21:28 +0000 Original-Received: from localhost ([127.0.0.1]:34623 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSo8F-0002YU-HY for submit@debbugs.gnu.org; Fri, 21 Aug 2015 11:21:27 -0400 Original-Received: from mtaout21.012.net.il ([80.179.55.169]:43880) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSo8C-0002YL-J8 for 21305-done@debbugs.gnu.org; Fri, 21 Aug 2015 11:21:25 -0400 Original-Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0NTF00L00UBHNE00@a-mtaout21.012.net.il> for 21305-done@debbugs.gnu.org; Fri, 21 Aug 2015 18:21:22 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NTF00LM7UNMLG50@a-mtaout21.012.net.il>; Fri, 21 Aug 2015 18:21:22 +0300 (IDT) In-reply-to: <870b6a90-e498-4ed9-9e41-d498edf33aec@default> 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:105662 Archived-At: > Date: Fri, 21 Aug 2015 08:08:25 -0700 (PDT) > From: Drew Adams > Cc: 21305@debbugs.gnu.org > > > > > The order is unspecified, which means the caller should not > > > > depend on it. I don't think there's anything wrong with that; > > > > do you? > > > > > > Well, it's certainly the prerogative of designers to decide that > > > the order is undefined and that users cannot depend on it. In > > > that case, you can close the bug now. > > > > > > But as one user I'm disappointed. I was hoping for a usable > > > window order. > > > > It's the order of traversing the window tree depth-first (as > > described in the ELisp manual under "Cyclic Window Ordering"). > > If so, then the order is not undefined. I didn't say "undefined", I said "unspecified". > > I don't see how saying that would be of any help to users of this > > function. > > Well, it apparently won't help me in my quest for a chronological > ordering of windows for the same buffer by access time. > > 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.) > > Describing the order would require a non-trivial amount of text, so > > without a good reason, I don't think we should add it. > > How is it more difficult than saying that the order is the same as > that specified in `Cyclic Window Ordering', and xreffing that node? I consider references to the manual in doc strings a bad habit. I'm closing the bug.