From unknown Sun Jun 22 03:56:55 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#21305 <21305@debbugs.gnu.org> To: bug#21305 <21305@debbugs.gnu.org> Subject: Status: 25.0.50; `get-buffer-window-list' doc - what order? Reply-To: bug#21305 <21305@debbugs.gnu.org> Date: Sun, 22 Jun 2025 10:56:55 +0000 retitle 21305 25.0.50; `get-buffer-window-list' doc - what order? reassign 21305 emacs submitter 21305 Drew Adams severity 21305 wishlist thanks From debbugs-submit-bounces@debbugs.gnu.org Thu Aug 20 19:28:49 2015 Received: (at submit) by debbugs.gnu.org; 20 Aug 2015 23:28:49 +0000 Received: from localhost ([127.0.0.1]:33922 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSZGK-0002n3-NQ for submit@debbugs.gnu.org; Thu, 20 Aug 2015 19:28:49 -0400 Received: from eggs.gnu.org ([208.118.235.92]:38186) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSZGI-0002mv-AK for submit@debbugs.gnu.org; Thu, 20 Aug 2015 19:28:46 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZSZGE-000527-NN for submit@debbugs.gnu.org; Thu, 20 Aug 2015 19:28:45 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:44928) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSZGE-000523-LQ for submit@debbugs.gnu.org; Thu, 20 Aug 2015 19:28:42 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:60738) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSTy1-0003u8-Fv for bug-gnu-emacs@gnu.org; Thu, 20 Aug 2015 13:49:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZSTxy-0000as-7o for bug-gnu-emacs@gnu.org; Thu, 20 Aug 2015 13:49:33 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:51598) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZSTxy-0000al-1k for bug-gnu-emacs@gnu.org; Thu, 20 Aug 2015 13:49:30 -0400 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7KHnSSD013509 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Thu, 20 Aug 2015 17:49:29 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t7KHnSXp008009 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Thu, 20 Aug 2015 17:49:28 GMT Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t7KHnSYg028232 for ; Thu, 20 Aug 2015 17:49:28 GMT MIME-Version: 1.0 Message-ID: <089f48ed-6ce9-4753-abcf-3f86d43a278e@default> Date: Thu, 20 Aug 2015 10:49:26 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 25.0.50; `get-buffer-window-list' doc - what order? X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 208.118.235.17 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) The doc string says: "Windows are scanned starting with the selected window." What does that mean? Scanned? How so? In what order are they scanned (besides starting with selected)? And how is the scanning used? What I would really like to know should have little or nothing to do with "scanning". It is what order the list is in. Details of how the function computes the list are not so important, but if you have to tell us that in order to specify the resulting order, so be it. Please update both the doc string and (elisp) `Buffers and Windows' to tell us what order the list is in. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2015-07-31 on LEG570 Bzr revision: 8d332aeccab2208e6c6bd434738565e6abf12043 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --host=3Di686-pc-mingw32 --enable-checking=3Dyes,glyphs' From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 08:56:53 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 12:56:53 +0000 Received: from localhost ([127.0.0.1]:34237 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSlsK-0007dA-LG for submit@debbugs.gnu.org; Fri, 21 Aug 2015 08:56:53 -0400 Received: from mtaout21.012.net.il ([80.179.55.169]:40210) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSlsG-0007cx-1l for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 08:56:49 -0400 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0NTF00L00NXT5M00@a-mtaout21.012.net.il> for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 15:56:46 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NTF00LKONYL4R20@a-mtaout21.012.net.il>; Fri, 21 Aug 2015 15:56:46 +0300 (IDT) Date: Fri, 21 Aug 2015 15:56:42 +0300 From: Eli Zaretskii Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? In-reply-to: <089f48ed-6ce9-4753-abcf-3f86d43a278e@default> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83vbc8iyut.fsf@gnu.org> References: <089f48ed-6ce9-4753-abcf-3f86d43a278e@default> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > Date: Thu, 20 Aug 2015 10:49:26 -0700 (PDT) > From: Drew Adams > > The doc string says: "Windows are scanned starting with the selected > window." What does that mean? Scanned? How so? In what order are > they scanned (besides starting with selected)? And how is the scanning > used? I replaced that sentence with this one: If the selected window displays BUFFER-OR-NAME, it will be the first in the resulting list. Do you see any issues left after that change? (I don't.) > Please update both the doc string and (elisp) `Buffers and Windows' > to tell us what order the list is in. 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? From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 09:21:24 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 13:21:24 +0000 Received: from localhost ([127.0.0.1]:34253 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSmG4-0008DJ-02 for submit@debbugs.gnu.org; Fri, 21 Aug 2015 09:21:24 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:28388) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSmG1-0008DA-7h for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 09:21:22 -0400 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LDLKQv010220 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 13:21:20 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t7LDLJtT032401 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 13:21:19 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t7LDLJIJ007424; Fri, 21 Aug 2015 13:21:19 GMT MIME-Version: 1.0 Message-ID: <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> Date: Fri, 21 Aug 2015 06:21:18 -0700 (PDT) From: Drew Adams To: Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> In-Reply-To: <<83vbc8iyut.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) > > The doc string says: "Windows are scanned starting with the > > selected window." What does that mean? Scanned? How so? > > In what order are they scanned (besides starting with selected)? > > And how is the scanning used? >=20 > I replaced that sentence with this one: >=20 > If the selected window displays BUFFER-OR-NAME, it will be the > first in the resulting list. >=20 > Do you see any issues left after that change? (I don't.) >=20 > > Please update both the doc string and (elisp) `Buffers and > > Windows' to tell us what order the list is in. >=20 > 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. In fact, I was hoping for something similar to `buffer-list' - hoping that users would get a list of the windows (displaying a particular buffer) in order of their last use. I know no way to obtain such a list, but if there is one, please be so kind as to let me know. `walk-windows' etc. go through windows in their "structural" order, but how can I tell, given a list of windows showing a given buffer, which were last used after which others? Yes, my question is outside the scope of this bug (if the list `get-buffer-window-list' has no order we can depend on or even if its order is unrelated to the chronological order of access). Thanks for fixing the doc string. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 09:51:49 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 13:51:49 +0000 Received: from localhost ([127.0.0.1]:34313 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSmjV-0000UJ-43 for submit@debbugs.gnu.org; Fri, 21 Aug 2015 09:51:49 -0400 Received: from mtaout21.012.net.il ([80.179.55.169]:41662) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSmjS-0000UA-Je for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 09:51:47 -0400 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0NTF00L00Q7GGT00@a-mtaout21.012.net.il> for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 16:51:45 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NTF00L6LQI2FO20@a-mtaout21.012.net.il>; Fri, 21 Aug 2015 16:51:38 +0300 (IDT) Date: Fri, 21 Aug 2015 16:51:35 +0300 From: Eli Zaretskii Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? In-reply-to: <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83oai0iwbc.fsf@gnu.org> References: <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > Date: Fri, 21 Aug 2015 06:21:18 -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"). I don't see how saying that would be of any help to users of this function. Describing the order would require a non-trivial amount of text, so without a good reason, I don't think we should add it. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 11:08:30 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 15:08:30 +0000 Received: from localhost ([127.0.0.1]:34607 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSnvi-0002Fa-AH for submit@debbugs.gnu.org; Fri, 21 Aug 2015 11:08:30 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:27697) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSnvg-0002FS-PL for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 11:08:29 -0400 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LF8RrQ019705 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 15:08:27 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t7LF8QlG002822 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 15:08:27 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t7LF8QqE019049; Fri, 21 Aug 2015 15:08:26 GMT MIME-Version: 1.0 Message-ID: <870b6a90-e498-4ed9-9e41-d498edf33aec@default> Date: Fri, 21 Aug 2015 08:08:25 -0700 (PDT) From: Drew Adams To: Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default>> <<83oai0iwbc.fsf@gnu.org>> In-Reply-To: <<83oai0iwbc.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) > > > 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. >=20 > 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. (It's a design decision whether Emacs wants to commit to supporting this order or just tell users that the order is undefined, keeping its options open.) > 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'. > 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? Perhaps I'm missing something. And I will leave it up to you to decide what, if anything, should be said about the order. Thanks for thinking about it. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 11:21:27 2015 Received: (at 21305-done) by debbugs.gnu.org; 21 Aug 2015 15:21:28 +0000 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 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 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) 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) Date: Fri, 21 Aug 2015 18:21:18 +0300 From: Eli Zaretskii Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? In-reply-to: <870b6a90-e498-4ed9-9e41-d498edf33aec@default> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83mvxkis5t.fsf@gnu.org> References: <870b6a90-e498-4ed9-9e41-d498edf33aec@default> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 21305-done Cc: 21305-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > 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. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 11:28:21 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 15:28:21 +0000 Received: from localhost ([127.0.0.1]:34630 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSoEu-0002iF-EN for submit@debbugs.gnu.org; Fri, 21 Aug 2015 11:28:20 -0400 Received: from mout.gmx.net ([212.227.17.20]:55458) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSoEs-0002i7-9L for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 11:28:18 -0400 Received: from [178.190.166.34] ([178.190.166.34]) by mail.gmx.com (mrgmx102) with ESMTPSA (Nemesis) id 0MdEsh-1ZAJW70rQZ-00IRYz; Fri, 21 Aug 2015 17:28:16 +0200 Message-ID: <55D74386.6010708@gmx.at> Date: Fri, 21 Aug 2015 17:28:06 +0200 From: martin rudalics MIME-Version: 1.0 To: Drew Adams , Eli Zaretskii Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> In-Reply-To: <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Provags-ID: V03:K0:n4Joa6+U7vMEFU2TeTQwh8DF5xy1sPYBintkQNWfdCzUvyd70RV mcgNHc4AGbyC0L/FqDypAAXzZLa/PrN/hRSbOOu9CdFIRWwHGgfa/Y05VT6jp9e7l1MWh8X 0ICOCe/OQbT6BXV/TF3H/fSjmyF+YowDJqoStZnTmfagqsWw32CSuSEf9ZLG1LXJKU0BK2s LrOnTGx1wXW7CgohdNemw== X-UI-Out-Filterresults: notjunk:1;V01:K0:fc1jeTKufvw=:GQPJDHX5/DFEN6W6yVQ48o Bcsk6Rlg4ywLTWqW9enEiXtbHmN92dLAHON0vjh8LHzuBN5Ycf/OVlj2XiKbxkJHwx6BUvNjB hRkRZaqEPNGoWr8LOqzq6WZz8yD1am4x45s/WBLVtQ3mjKkKtC0wCRXdUocDQf7ZuDhw1KYgS 9PDl0ResSc6c0eTVFBDTV1Tr+/PzCojlSHLTFr8JMSMHk/ZesQLWJtzOWJZNE6SSmeCcdSq0a R2djUIcL/RU2W7bqsyuWNfOVw4MAJYQjKcnvlHux/uBWIQmga7kYGzwcbHgzhzacv9wL2yyJf LKPfQQLWHYnDg6A2O7Vurf5fuAofpSJ0T9uy2pt3SSzT49evMHGQaX3BHk6PlUd5OJkdTEXv5 2W/V/6LrTo+qO0zZMhSlHgAdKGc+zxRBakpgBchUHTliP1+pzgRFGwV/M4EX7sSFKHDKf6y25 IMpMW3SwklrmrjzaI9EiAOaBY4HzVRuwkzZ8h+G5T9wPjE5UmYYkGrBhWuBpWgMrzXH4xB+nO KaBZZacvKfSnmBa/7QlLN8/1gc0p7casAd05jjPlySUg2/Pct4tNqn0rlNwr24pGp0/R1P1fe KSDhFs0JSUQ1XDzQCtGqEgYWB2jeyY+MjJqAwYoKuWkQJ3/vUwSHw/T1sHJ1wQRq1hDgTJUCf q3UzCWCxoQFHvhTmP8rFd2oiw04MeF0vQZ8oohEzFj2TMqQcAjB5PNX43eHwgA5ZBAp+BJoxr GlLs+7YT7iah/wicUOoAy12BxzY+Yc9uiTkl+A== X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) > But as one user I'm disappointed. I was hoping for a usable > window order. In fact, I was hoping for something similar to > `buffer-list' - hoping that users would get a list of the windows > (displaying a particular buffer) in order of their last use. > > I know no way to obtain such a list, but if there is one, please > be so kind as to let me know. `walk-windows' etc. go through > windows in their "structural" order, but how can I tell, given > a list of windows showing a given buffer, which were last used > after which others? > > Yes, my question is outside the scope of this bug (if the list > `get-buffer-window-list' has no order we can depend on or even > if its order is unrelated to the chronological order of access). I suppose you mean that we should document `window-use-time' too. Correct? martin From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 11:28:23 2015 Received: (at 21305-done) by debbugs.gnu.org; 21 Aug 2015 15:28:23 +0000 Received: from localhost ([127.0.0.1]:34633 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSoEx-0002iW-4l for submit@debbugs.gnu.org; Fri, 21 Aug 2015 11:28:23 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:40832) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSoEw-0002iN-06 for 21305-done@debbugs.gnu.org; Fri, 21 Aug 2015 11:28:22 -0400 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LFSKqs014381 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 15:28:21 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t7LFSKVE001150 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 15:28:20 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t7LFSJum019671; Fri, 21 Aug 2015 15:28:19 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 21 Aug 2015 08:28:18 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<870b6a90-e498-4ed9-9e41-d498edf33aec@default>> <<83mvxkis5t.fsf@gnu.org>> In-Reply-To: <<83mvxkis5t.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305-done Cc: 21305-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) > > But I think it would be helpful to tell users that the order is > > the same as that described in `Cyclic Window Ordering'. >=20 > 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'.=20 > > > 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? >=20 > I consider references to the manual in doc strings a bad habit. 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. It would be helpful, I think, to explicitly say that the order of the windows in the return value (a) starts with the selected window (which you have added) and (b) follows the order cyclic window ordering. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 11:30:58 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 15:30:58 +0000 Received: from localhost ([127.0.0.1]:34641 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSoHS-0002nU-Ad for submit@debbugs.gnu.org; Fri, 21 Aug 2015 11:30:58 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:43134) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSoHP-0002nL-Oc for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 11:30:56 -0400 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LFUseO018541 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 15:30:54 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t7LFUsB7010073 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 15:30:54 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t7LFUsmM011811; Fri, 21 Aug 2015 15:30:54 GMT MIME-Version: 1.0 Message-ID: <7036da11-d296-45a9-b6ee-d7b68830927e@default> Date: Fri, 21 Aug 2015 08:30:52 -0700 (PDT) From: Drew Adams To: martin rudalics , Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> In-Reply-To: <55D74386.6010708@gmx.at> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) > > But as one user I'm disappointed. I was hoping for a usable > > window order. In fact, I was hoping for something similar to > > `buffer-list' - hoping that users would get a list of the windows > > (displaying a particular buffer) in order of their last use. > > > > I know no way to obtain such a list, but if there is one, please > > be so kind as to let me know. `walk-windows' etc. go through > > windows in their "structural" order, but how can I tell, given > > a list of windows showing a given buffer, which were last used > > after which others? > > > > Yes, my question is outside the scope of this bug (if the list > > `get-buffer-window-list' has no order we can depend on or even > > if its order is unrelated to the chronological order of access). >=20 > I suppose you mean that we should document `window-use-time' too. > Correct? Oh, yes; please do. I was unaware of it. I can map that over=20 `get-buffer-window-list' or otherwise filter that list wrt use time. Very good. Thx. Somehow, I wasn't able to find this, which was for me a missing piece. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 11:58:43 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 15:58:44 +0000 Received: from localhost ([127.0.0.1]:34659 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSoiJ-0003RI-NM for submit@debbugs.gnu.org; Fri, 21 Aug 2015 11:58:43 -0400 Received: from mout.gmx.net ([212.227.17.22]:55423) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSoiH-0003R9-JV for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 11:58:42 -0400 Received: from [178.190.166.34] ([178.190.166.34]) by mail.gmx.com (mrgmx101) with ESMTPSA (Nemesis) id 0Lbi2Z-1Z3xH528VP-00lBsd; Fri, 21 Aug 2015 17:58:36 +0200 Message-ID: <55D74AA3.1070202@gmx.at> Date: Fri, 21 Aug 2015 17:58:27 +0200 From: martin rudalics MIME-Version: 1.0 To: Drew Adams , Eli Zaretskii Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> In-Reply-To: <7036da11-d296-45a9-b6ee-d7b68830927e@default> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Provags-ID: V03:K0:kZRYp2FzEThDj6d8eg8jTnyL0rJ2XQ8gaEBKDXLG6/5dEmVqaV5 Xh8zFhSJNqv5moZgtrX4CQXaQc2JuvaY8RmbrFor00n6G30SRlDPgtTqGiTYMttBEqD1eGu O9mXQxKCKEAwaD4WEPgEAMmdtB8ql3CpPw+D5ThWb8F5j8Jo6hc2xsU1xiDU1BVKRM3T8Uh 1QGrJxuiwhVLDEicoKTqQ== X-UI-Out-Filterresults: notjunk:1;V01:K0:hf6DyPvB37g=:8JP4BtHo31u0a7Iay0AqKe dmurEO+Li85V8VlEb2B9fZV1O4CLmeVs83/SRNCiNe65RveRmkk9K4+Q/VZU1Tg3lZuAkGLxv x7kQnkBJq2qO7Vw1EbyKIqfnZRrUDrb9jDETyxaT1oq4E2gOoakeiIqaxHPCILSlfbpbjbvut tOawL27/bIOe9E0E6BByq8UEISA27Yx94mTkaj+NE0F3c/C8iWr392bQo86IiT6X/fZqVIFCU IyU3qqiA3gbIKjSvoqBUH9+Fq0AdSiZeP2zZu+T1gYj+HFsrSxyw1FGORra6YC1jExCuXJ5pI qt9g3A0adS23O6I3eKhOGc9cRT8kglwHzJjR0yMEQJkBqiM3mgblpAWpB03fX61jORDCuG8rv Kvf/mRhEg2sFyhBBCCbVmPMG1VKq/4dgqssxu8eoZt/eA44sWkgW/VywfcuZqbTbK7JBu+EPz Kdym52RV0PcNAIiJaNyhM68xo8lE9+npMW2SO4SWiTwkZEb6BxMfsuG9EWdGaiT+spLFOjU0t Ir0IajqFeG9/jDWhtMzgLptWFsJQkJws6NiRO9I4N560gCdGXcnONfG+c8vSj8DhnN5PIUFMz pyWFGkJJJ4+IETaLN56URgFNhHxeeBAyUGkr7SrnPF76mkGEBPA1JW6ncQ74FZ1YYghN5r414 9PXXgOZ6EiIR5EpJ5hPKpvAmFTgX/GHkEKOSzsoQcCFHElejcuxwBCggrEYFAijf2SEB9b9eE GJ1cmNwMS11Faruw5kQEhcjt+JZcV2Z0np7h6g== X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) >> I suppose you mean that we should document `window-use-time' too. >> Correct? > > Oh, yes; please do. Done. martin From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 12:01:00 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 16:01:00 +0000 Received: from localhost ([127.0.0.1]:34673 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSokV-0003Wj-VR for submit@debbugs.gnu.org; Fri, 21 Aug 2015 12:01:00 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:27564) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSokU-0003Wa-C1 for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 12:00:59 -0400 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LG0uHi008477 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 16:00:57 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t7LG0uCY028163 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 16:00:56 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t7LG0t5p015504; Fri, 21 Aug 2015 16:00:55 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 21 Aug 2015 09:00:54 -0700 (PDT) From: Drew Adams To: martin rudalics , Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> In-Reply-To: <55D74AA3.1070202@gmx.at> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) > >> I suppose you mean that we should document `window-use-time' too. > >> Correct? > > > > Oh, yes; please do. >=20 > Done. Great. Thx. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 12:12:15 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 16:12:15 +0000 Received: from localhost ([127.0.0.1]:34693 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSovP-0003mM-AZ for submit@debbugs.gnu.org; Fri, 21 Aug 2015 12:12:15 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:33833) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSovO-0003mF-Ad for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 12:12:14 -0400 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LGCAXk022341 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 16:12:10 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t7LGCAb4020485 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 16:12:10 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t7LGC9Fw001414; Fri, 21 Aug 2015 16:12:10 GMT MIME-Version: 1.0 Message-ID: <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> Date: Fri, 21 Aug 2015 09:12:08 -0700 (PDT) From: Drew Adams To: martin rudalics , Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) BTW, it would be nice to know whether `get-buffer-window-list' returns a new list or returns a list that is pointed to (used) by something else. In particular, it would be good to know whether one can use `sort' on it (e.g., `sort' according to `window-use-time') without bothering something else somewhere. I'm supposing so. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 12:32:21 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 16:32:21 +0000 Received: from localhost ([127.0.0.1]:34708 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSpEr-0004G4-7b for submit@debbugs.gnu.org; Fri, 21 Aug 2015 12:32:21 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:45875) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSpEp-0004Fw-M8 for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 12:32:20 -0400 Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LGWIbi016421 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 16:32:18 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t7LGWI6N026392 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 16:32:18 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t7LGWHe0021113; Fri, 21 Aug 2015 16:32:17 GMT MIME-Version: 1.0 Message-ID: <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> Date: Fri, 21 Aug 2015 09:32:16 -0700 (PDT) From: Drew Adams To: martin rudalics , Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> In-Reply-To: <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) Sorry for drifting from the bug, but is something like this useful generally? I will use it, but I'm thinking others might also. (defun mru-window-for-buffer (buffer &optional minibuf all-frames) "Return the most recently used window for BUFFER. Optional args MINIBUF and ALL-FRAMES are as for `get-buffer-window-list'." (let* ((wins (get-buffer-window-list buffer minibuf all-frames)) (mru-win (car wins))) (dolist (win (cdr wins)) (unless (time-less-p win mru-win) (setq mru-win win))) mru-win)) Similary, `lru-window-for-buffer'. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 13:42:23 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 17:42:23 +0000 Received: from localhost ([127.0.0.1]:34746 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSqKc-0005qm-S9 for submit@debbugs.gnu.org; Fri, 21 Aug 2015 13:42:23 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:48130) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSqKb-0005qf-Pl for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 13:42:22 -0400 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LHgKtH023417 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 17:42:20 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t7LHgK30006525 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 17:42:20 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t7LHgJO4022246; Fri, 21 Aug 2015 17:42:20 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 21 Aug 2015 10:42:18 -0700 (PDT) From: Drew Adams To: martin rudalics , Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> In-Reply-To: <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) > (defun mru-window-for-buffer (buffer &optional minibuf all-frames) > "Return the most recently used window for BUFFER. > Optional args MINIBUF and ALL-FRAMES are as for `get-buffer-window- > list'." > (let* ((wins (get-buffer-window-list buffer minibuf all-frames)) > (mru-win (car wins))) > (dolist (win (cdr wins)) > (unless (time-less-p win mru-win) (setq mru-win win))) > mru-win)) >=20 > Similarly, `lru-window-for-buffer'. Sorry, I meant something like this: (defun mru-window-for-buffer (buffer &optional minibuf all-frames) "Return the most recently used window for BUFFER. Optional args MINIBUF and ALL-FRAMES are as for `get-buffer-window-list'." (let* ((wins (get-buffer-window-list buffer minibuf all-frames)) (mru-win (car wins)) (mru-time (window-use-time mru-win)) wtime) (dolist (win (cdr wins)) (when (time-less-p (setq wtime (window-use-time win)) mru-time) (setq mru-time wtime mru-win win))) mru-win)) From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 14:29:04 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 18:29:04 +0000 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 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 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) 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) Date: Fri, 21 Aug 2015 21:28:56 +0300 From: Eli Zaretskii Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? In-reply-to: X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83lhd4ijh3.fsf@gnu.org> References: <870b6a90-e498-4ed9-9e41-d498edf33aec@default> <83mvxkis5t.fsf@gnu.org> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > 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. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 21 15:18:44 2015 Received: (at 21305) by debbugs.gnu.org; 21 Aug 2015 19:18:44 +0000 Received: from localhost ([127.0.0.1]:34767 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSrpr-00080X-IC for submit@debbugs.gnu.org; Fri, 21 Aug 2015 15:18:43 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:27566) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZSrpp-00080P-Tz for 21305@debbugs.gnu.org; Fri, 21 Aug 2015 15:18:42 -0400 Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7LJIdLd023483 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 21 Aug 2015 19:18:40 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t7LJIdNI019232 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 21 Aug 2015 19:18:39 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t7LJIcqW013266; Fri, 21 Aug 2015 19:18:39 GMT MIME-Version: 1.0 Message-ID: <616a08e1-5256-45ba-9249-e220a6c97a89@default> Date: Fri, 21 Aug 2015 12:18:37 -0700 (PDT) From: Drew Adams To: Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<870b6a90-e498-4ed9-9e41-d498edf33aec@default>> <<83mvxkis5t.fsf@gnu.org>> <> <<83lhd4ijh3.fsf@gnu.org>> In-Reply-To: <<83lhd4ijh3.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-Spam-Score: -3.1 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.1 (---) > > 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::). >=20 > In the cross-referenced node. It sends you to that node for an entirely different purpose - not for information about the order of the returned value. The xref is even part of the _same sentence_ as the statement about the args. It is not a separate sentence telling to go see that node for more info about the function as a whole. And it certainly is not hinting that you will discover there something about the order of the function's return value. If I tell you that you can get a great bagel at Schlomo's Deli, would you expect that you might also get a great car wash there? > > 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. >=20 > No, it's not. It actually tells you that this function traverses > the window as next-window does. The xref'd node does. But the xref is explicitly "given only for info about arguments MINIBUF and ALL-FRAMES." A minor change would make it clear that that node also tells you something about the order of the return value. (It would still be better to document the return value completely in the source node, and send readers to the xref for _additional_ info. > 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. Again, either Emacs decides that it wants to specify nothing about the order, and says it is unspecified, or it decides it wants to tell users what the order is (and so commits, to some extent, to that order, e.g., including for the future). It's your choice. What is the design? Do you want to expose this as by design, and tell users about it so they can take advantage of it, or do you want to tell users not to depend on the currently implemented order? From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 22 02:40:42 2015 Received: (at 21305) by debbugs.gnu.org; 22 Aug 2015 06:40:42 +0000 Received: from localhost ([127.0.0.1]:34953 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZT2Tp-0002Ln-JP for submit@debbugs.gnu.org; Sat, 22 Aug 2015 02:40:41 -0400 Received: from mout.gmx.net ([212.227.15.18]:53426) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZT2Tm-0002Lf-V4 for 21305@debbugs.gnu.org; Sat, 22 Aug 2015 02:40:39 -0400 Received: from [194.118.139.166] ([194.118.139.166]) by mail.gmx.com (mrgmx003) with ESMTPSA (Nemesis) id 0LhOvA-1YyOcW2BdY-00mZGd; Sat, 22 Aug 2015 08:40:36 +0200 Message-ID: <55D8195A.4040804@gmx.at> Date: Sat, 22 Aug 2015 08:40:26 +0200 From: martin rudalics MIME-Version: 1.0 To: Drew Adams , Eli Zaretskii Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Provags-ID: V03:K0:JWC53MUsblDutfgRlg+VbFFz764vej2TNd5v+7e51Qr2/uv5bc+ x5xRPhrT4ZpL3d6n6+IH/pilAs+MsarQsFxKq9cHszSZ/KcclsC1HpN1PrycLlCZEzTCYrC Jxqu1W4kjOAPL98FtTT0SGddYXZ83MBW9im3bxd4owwfzZgibb27tEztdMYVATcDvocxu3O UilBQV4tPAbrPajxdowxw== X-UI-Out-Filterresults: notjunk:1;V01:K0:QxzPLWF7/Rg=:LqMFOL9Hrjgx0B13Qmq0qI RC2S/JT6epZthBdMz6Fb4kvAgCYVugWD+nVRAl8BWYO09/H2Jf4yyfg5iBDB3dCxKqKJmc5gA EOROP2dAyxohGEjpxvT+8N0ZtohCjXNE3gHO2ZuDR8HvKZqy3R/LFX576LAh3oCEVyCw6EC8e 4VgFI0EZHtNhHySbOrU7kI5t4GavuEjp2AxKgNeyDean1jhQMWleFNo55RvQ7ktQmJ3FIui15 5JyBucooXjjiQdrOINtLwaBhfz4iTUj01f75OocJYeIMd9rdBU4LKJRFyCS6OYMzXsTgZ5JRj ikmB/k3yqoc+i5CkZeJGxBZnoNA6A1B6iHOQ0Zd3yiyt1w6wfMfsAj9oyycAPjS4yr/SG4fJt IA8eY01GxbB9bH3k10HLNg0wVPVX0l26jTqeUO+JVbNVUugsHoKi8zOHA9D92bltE9shFcxgO yUt/Ex2yaFs11i6IKG/ADZ7/KDdmakpULRGkGgSRgccXVeuxksxAvt238dbPI9e8qXU1uWP9T z0i1hmnZ+BaFR2HF8T9zeN1t+pH29/yUxwbEa8BCcAL8dHYcpgZhYr61ObXNwHRi8BSntbLOh yX56UYrCzVKG0FC8o4wBHtOL8usjZWoqgsvTUbP7W67xYO1Y3LOtv8F6gFBBm18bhoUF1zOm2 QAa122aPxYsLQBlIfFpWTULVWRaU9APZ4Bze+kmukHn2zMKituVV7jj+Cq/EKx8f3j2bqwutb 28RyccsCQXDyljCALa+J5N/08ns0Bx9wX245UQ== X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) > Sorry, I meant something like this: > > (defun mru-window-for-buffer (buffer &optional minibuf all-frames) `get-buffer-window-list' is in window.el. Couldn't you try giving it a fourth argument, say SORT, which, if `lru-first' or `mru-first', would cause it to return the windows in the corresponding order? martin From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 22 10:31:45 2015 Received: (at 21305) by debbugs.gnu.org; 22 Aug 2015 14:31:45 +0000 Received: from localhost ([127.0.0.1]:35285 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZT9pg-0006JT-Ti for submit@debbugs.gnu.org; Sat, 22 Aug 2015 10:31:45 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:50825) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZT9pf-0006JL-2n for 21305@debbugs.gnu.org; Sat, 22 Aug 2015 10:31:43 -0400 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7MEVeVq017998 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 22 Aug 2015 14:31:40 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t7MEVeE6004718 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 22 Aug 2015 14:31:40 GMT Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t7MEVdrJ014346; Sat, 22 Aug 2015 14:31:39 GMT MIME-Version: 1.0 Message-ID: <9aa1dcd7-1781-41aa-bf47-7b280b26da1e@default> Date: Sat, 22 Aug 2015 07:31:38 -0700 (PDT) From: Drew Adams To: martin rudalics , Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <<83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> <55D8195A.4040804@gmx.at> In-Reply-To: <55D8195A.4040804@gmx.at> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: multipart/mixed; boundary="__1440253898967284647abhmp0008.oracle.com" X-Source-IP: userv0022.oracle.com [156.151.31.74] X-Spam-Score: -3.2 (---) X-Debbugs-Envelope-To: 21305 Cc: 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.2 (---) --__1440253898967284647abhmp0008.oracle.com Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable > `get-buffer-window-list' is in window.el. Couldn't you try giving > it a fourth argument, say SORT, which, if `lru-first' or `mru-first', > would cause it to return the windows in the corresponding order? Patch attached. --__1440253898967284647abhmp0008.oracle.com Content-Type: application/octet-stream; name="window-2015-08-22.patch" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="window-2015-08-22.patch" ZGlmZiAtdXcgd2luZG93LmVsIHdpbmRvdy1wYXRjaGVkLTIwMTUtMDgtMjIuZWwKLS0tIHdpbmRv dy5lbAkyMDE1LTA4LTIyIDA3OjE3OjAzLjg4NzY2NTUwMCAtMDcwMAorKysgd2luZG93LXBhdGNo ZWQtMjAxNS0wOC0yMi5lbAkyMDE1LTA4LTIyIDA3OjI2OjM3Ljk4NDA2OTQwMCAtMDcwMApAQCAt MjI5NiwxMSArMjI5NiwxMCBAQAogCSAgKHNldHEgYmVzdC13aW5kb3cgd2luZG93KSkpKQogICAg IGJlc3Qtd2luZG93KSkKIAotKGRlZnVuIGdldC1idWZmZXItd2luZG93LWxpc3QgKCZvcHRpb25h bCBidWZmZXItb3ItbmFtZSBtaW5pYnVmIGFsbC1mcmFtZXMpCisoZGVmdW4gZ2V0LWJ1ZmZlci13 aW5kb3ctbGlzdCAoJm9wdGlvbmFsIGJ1ZmZlci1vci1uYW1lIG1pbmlidWYgYWxsLWZyYW1lcyBz b3J0KQogICAiUmV0dXJuIGxpc3Qgb2YgYWxsIHdpbmRvd3MgZGlzcGxheWluZyBCVUZGRVItT1It TkFNRSwgb3IgbmlsIGlmIG5vbmUuCiBCVUZGRVItT1ItTkFNRSBtYXkgYmUgYSBidWZmZXIgb3Ig dGhlIG5hbWUgb2YgYW4gZXhpc3RpbmcgYnVmZmVyCi1hbmQgZGVmYXVsdHMgdG8gdGhlIGN1cnJl bnQgYnVmZmVyLiAgSWYgdGhlIHNlbGVjdGVkIHdpbmRvdyBkaXNwbGF5cwotQlVGRkVSLU9SLU5B TUUsIGl0IHdpbGwgYmUgdGhlIGZpcnN0IGluIHRoZSByZXN1bHRpbmcgbGlzdC4KK2FuZCBkZWZh dWx0cyB0byB0aGUgY3VycmVudCBidWZmZXIuCiAKIE1JTklCVUYgdCBtZWFucyBpbmNsdWRlIHRo ZSBtaW5pYnVmZmVyIHdpbmRvdyBldmVuIGlmIHRoZQogbWluaWJ1ZmZlciBpcyBub3QgYWN0aXZl LiAgTUlOSUJVRiBuaWwgb3Igb21pdHRlZCBtZWFucyBpbmNsdWRlCkBAIC0yMzI0LDE0ICsyMzIz LDI4IEBACiAKIC0gQSBmcmFtZSBtZWFucyBjb25zaWRlciBhbGwgd2luZG93cyBvbiB0aGF0IGZy YW1lIG9ubHkuCiAKLUFueXRoaW5nIGVsc2UgbWVhbnMgY29uc2lkZXIgYWxsIHdpbmRvd3Mgb24g dGhlIHNlbGVjdGVkIGZyYW1lCi1hbmQgbm8gb3RoZXJzLiIKK0FueXRoaW5nIGVsc2UgZm9yIEFM TC1GUkFNRVMgbWVhbnMgY29uc2lkZXIgYWxsIHdpbmRvd3Mgb24gdGhlCitzZWxlY3RlZCBmcmFt ZSBhbmQgbm8gb3RoZXJzLgorCitCeSBkZWZhdWx0IChTT1JUIGlzIG5pbCksIHRoZSBvcmRlciBv ZiB0aGUgd2luZG93cyBpbiB0aGUgcmVzdWx0IGlzCit1bnNwZWNpZmllZCwgZXhjZXB0IHRoYXQg aWYgdGhlIHNlbGVjdGVkIHdpbmRvdyBzaG93cyBCVUZGRVItT1ItTkFNRQordGhlbiBpdCBpcyBm aXJzdC4KKworTm9uLW5pbCBTT1JUIG1lYW5zIHJldHVybiB0aGUgd2luZG93cyBzb3J0ZWQgYnkg bGFzdCB1c2UgdGltZToKKy0gYG1ydScgbWVhbnMgbW9zdCAgcmVjZW50bHkgdXNlZCBjb21lcyBm aXJzdAorLSBgbHJ1JyBtZWFucyBsZWFzdCByZWNlbnRseSB1c2VkIGNvbWVzIGZpcnN0IgogICAo bGV0ICgoYnVmZmVyICh3aW5kb3ctbm9ybWFsaXplLWJ1ZmZlciBidWZmZXItb3ItbmFtZSkpCiAJ d2luZG93cykKICAgICAoZG9saXN0ICh3aW5kb3cgKHdpbmRvdy1saXN0LTEgKHNlbGVjdGVkLXdp bmRvdykgbWluaWJ1ZiBhbGwtZnJhbWVzKSkKLSAgICAgICh3aGVuIChlcSAod2luZG93LWJ1ZmZl ciB3aW5kb3cpIGJ1ZmZlcikKLQkoc2V0cSB3aW5kb3dzIChjb25zIHdpbmRvdyB3aW5kb3dzKSkp KQotICAgIChucmV2ZXJzZSB3aW5kb3dzKSkpCisgICAgICAod2hlbiAoZXEgKHdpbmRvdy1idWZm ZXIgd2luZG93KSBidWZmZXIpCShzZXRxIHdpbmRvd3MgIChjb25zIHdpbmRvdyB3aW5kb3dzKSkp KQorICAgIChzZXRxIHdpbmRvd3MgIChucmV2ZXJzZSB3aW5kb3dzKSkKKyAgICAod2hlbiBzb3J0 CisgICAgICAobGV0ICgocHJlZCAgKGNhc2Ugc29ydAorICAgICAgICAgICAgICAgICAgICAgKGxy dSAobGFtYmRhICh3MSB3MikgKHRpbWUtbGVzcy1wICh3aW5kb3ctdXNlLXRpbWUgdzEpICh3aW5k b3ctdXNlLXRpbWUgdzIpKSkpCisgICAgICAgICAgICAgICAgICAgICAobXJ1IChsYW1iZGEgKHcx IHcyKSAodGltZS1sZXNzLXAgKHdpbmRvdy11c2UtdGltZSB3MikgKHdpbmRvdy11c2UtdGltZSB3 MSkpKSkpKSkKKyAgICAgICAgKHNldHEgd2luZG93cyAgKHNvcnQgd2luZG93cyBwcmVkKSkpKQor ICAgIHdpbmRvd3MpKQorCiAKIChkZWZ1biBtaW5pYnVmZmVyLXdpbmRvdy1hY3RpdmUtcCAod2lu ZG93KQogICAiUmV0dXJuIHQgaWYgV0lORE9XIGlzIHRoZSBjdXJyZW50bHkgYWN0aXZlIG1pbmli dWZmZXIgd2luZG93LiIK --__1440253898967284647abhmp0008.oracle.com-- From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 22 12:01:42 2015 Received: (at 21305) by debbugs.gnu.org; 22 Aug 2015 16:01:42 +0000 Received: from localhost ([127.0.0.1]:35309 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTBEj-0008Lj-Tk for submit@debbugs.gnu.org; Sat, 22 Aug 2015 12:01:42 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.181]:3932) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTBEh-0008Lb-JM for 21305@debbugs.gnu.org; Sat, 22 Aug 2015 12:01:40 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0AvEwA731xV/5P+d0tcgxCEAoVVuzcJhH6CTQQCAoE8ORQBAQEBAQEBgQpBBYNdAQEEViMQCzQSFBgNJIg/zyMBAQEBAQUBAQEBHos6hQUHhC0BBJltkTaIHIFFI4Fmgi4igngBAQE X-IPAS-Result: A0AvEwA731xV/5P+d0tcgxCEAoVVuzcJhH6CTQQCAoE8ORQBAQEBAQEBgQpBBYNdAQEEViMQCzQSFBgNJIg/zyMBAQEBAQUBAQEBHos6hQUHhC0BBJltkTaIHIFFI4Fmgi4igngBAQE X-IronPort-AV: E=Sophos;i="5.13,465,1427774400"; d="scan'208";a="161041857" Received: from 75-119-254-147.dsl.teksavvy.com (HELO pastel.home) ([75.119.254.147]) by ironport2-out.teksavvy.com with ESMTP; 22 Aug 2015 12:01:38 -0400 Received: by pastel.home (Postfix, from userid 20848) id BC871622E0; Sat, 22 Aug 2015 12:01:38 -0400 (EDT) From: Stefan Monnier To: Drew Adams Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? Message-ID: References: <089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> <55D8195A.4040804@gmx.at> <9aa1dcd7-1781-41aa-bf47-7b280b26da1e@default> Date: Sat, 22 Aug 2015 12:01:38 -0400 In-Reply-To: <9aa1dcd7-1781-41aa-bf47-7b280b26da1e@default> (Drew Adams's message of "Sat, 22 Aug 2015 07:31:38 -0700 (PDT)") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.3 (/) X-Debbugs-Envelope-To: 21305 Cc: martin rudalics , Eli Zaretskii , 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) >> `get-buffer-window-list' is in window.el. Couldn't you try giving >> it a fourth argument, say SORT, which, if `lru-first' or `mru-first', >> would cause it to return the windows in the corresponding order? > Patch attached. FWIW, I think adding an argument for that is a bad idea. If the caller needs the windows sorted in a particular way, then *he* should sort them. It would make sense to provide sorting directly in the function if the sorting can't be done, or not as efficiently, after the fact. But that is not the case here. Stefan From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 22 13:23:26 2015 Received: (at 21305) by debbugs.gnu.org; 22 Aug 2015 17:23:26 +0000 Received: from localhost ([127.0.0.1]:35339 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTCVp-0001q2-OP for submit@debbugs.gnu.org; Sat, 22 Aug 2015 13:23:26 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:36564) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTCVn-0001pu-P8 for 21305@debbugs.gnu.org; Sat, 22 Aug 2015 13:23:24 -0400 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7MHNMju015154 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 22 Aug 2015 17:23:22 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t7MHNM6M003379 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 22 Aug 2015 17:23:22 GMT Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t7MHNL4C004205; Sat, 22 Aug 2015 17:23:21 GMT MIME-Version: 1.0 Message-ID: Date: Sat, 22 Aug 2015 10:23:22 -0700 (PDT) From: Drew Adams To: Stefan Monnier Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> <55D8195A.4040804@gmx.at> <9aa1dcd7-1781-41aa-bf47-7b280b26da1e@default> In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -3.2 (---) X-Debbugs-Envelope-To: 21305 Cc: martin rudalics , Eli Zaretskii , 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.2 (---) > >> `get-buffer-window-list' is in window.el. Couldn't you try > >> giving it a fourth argument, say SORT, which, if `lru-first' > >> or `mru-first', would cause it to return the windows in the=20 > >> corresponding order? > > > > Patch attached. >=20 > FWIW, I think adding an argument for that is a bad idea. If the > caller needs the windows sorted in a particular way, then *he* > should sort them. (S?he should know whether the return value of `get-buffer-window-list' is a new list (it is), so that `sort' can be applied to it without causing problems elsewhere. For that, s?he will want to consult the code of `get-buffer-window-list'.) > It would make sense to provide sorting directly in the function if > the sorting can't be done, or not as efficiently, after the fact. > But that is not the case here. I don't disagree. What was not obvious was how you might sort windows wrt last-use time. But IIUC, Martin has now updated the manual to mention `window-use-time', of which I was unaware. What I suggested was not to add a SORT arg to `get-buffer-window-list' but to add functions such as `(mru|lru)-window-for-buffer'. (It was for the latter that I was interested in `get-buffer-window-list'.) From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 22 13:31:03 2015 Received: (at 21305) by debbugs.gnu.org; 22 Aug 2015 17:31:03 +0000 Received: from localhost ([127.0.0.1]:35365 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTCdC-00026h-Gm for submit@debbugs.gnu.org; Sat, 22 Aug 2015 13:31:02 -0400 Received: from mtaout21.012.net.il ([80.179.55.169]:61088) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTCd9-00026E-Ln for 21305@debbugs.gnu.org; Sat, 22 Aug 2015 13:31:00 -0400 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0NTH00200V7F1M00@a-mtaout21.012.net.il> for 21305@debbugs.gnu.org; Sat, 22 Aug 2015 20:30:58 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NTH001THVBLZ560@a-mtaout21.012.net.il>; Sat, 22 Aug 2015 20:30:58 +0300 (IDT) Date: Sat, 22 Aug 2015 20:30:57 +0300 From: Eli Zaretskii Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? In-reply-to: X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83a8tji626.fsf@gnu.org> References: <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> <55D8195A.4040804@gmx.at> <9aa1dcd7-1781-41aa-bf47-7b280b26da1e@default> X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 21305 Cc: rudalics@gmx.at, 21305@debbugs.gnu.org, monnier@iro.umontreal.ca X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) > Date: Sat, 22 Aug 2015 10:23:22 -0700 (PDT) > From: Drew Adams > Cc: martin rudalics , Eli Zaretskii , > 21305@debbugs.gnu.org > > > FWIW, I think adding an argument for that is a bad idea. If the > > caller needs the windows sorted in a particular way, then *he* > > should sort them. > > (S?he should know whether the return value of `get-buffer-window-list' > is a new list (it is), so that `sort' can be applied to it without > causing problems elsewhere. For that, s?he will want to consult the > code of `get-buffer-window-list'.) I see no reason for consulting the source code, just to know whether it's safe to sort that list. It would be silly, to say the least, for Emacs to give Lisp programs direct access to a list that is used internally by Emacs and whose order is important. IOW, it is safe to assume that the returned list can be freely manipulated. From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 22 15:02:06 2015 Received: (at 21305) by debbugs.gnu.org; 22 Aug 2015 19:02:06 +0000 Received: from localhost ([127.0.0.1]:35458 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTE3J-0005mq-Cp for submit@debbugs.gnu.org; Sat, 22 Aug 2015 15:02:05 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:50940) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTE3G-0005mX-J0 for 21305@debbugs.gnu.org; Sat, 22 Aug 2015 15:02:03 -0400 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t7MJ1xBt002420 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 22 Aug 2015 19:02:00 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t7MJ1wUS016836 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 22 Aug 2015 19:01:59 GMT Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t7MJ1wpx027265; Sat, 22 Aug 2015 19:01:58 GMT MIME-Version: 1.0 Message-ID: Date: Sat, 22 Aug 2015 12:01:59 -0700 (PDT) From: Drew Adams To: Eli Zaretskii Subject: RE: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <<5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default>> <<55D74386.6010708@gmx.at>> <<7036da11-d296-45a9-b6ee-d7b68830927e@default>> <<55D74AA3.1070202@gmx.at>> <<1b17a036-c525-4dbc-84fa-cc8adc2b6488@default>> <<50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default>> <> <<55D8195A.4040804@gmx.at>> <<9aa1dcd7-1781-41aa-bf47-7b280b26da1e@default>> <> <> <<83a8tji626.fsf@gnu.org>> In-Reply-To: <<83a8tji626.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-Spam-Score: -3.2 (---) X-Debbugs-Envelope-To: 21305 Cc: rudalics@gmx.at, 21305@debbugs.gnu.org, monnier@iro.umontreal.ca X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.2 (---) > > (S?he should know whether the return value of `get-buffer-window- > > list' is a new list (it is), so that `sort' can be applied to it > > without causing problems elsewhere. For that, s?he will want to > > consult the code of `get-buffer-window-list'.) >=20 > I see no reason for consulting the source code, just to know whether > it's safe to sort that list. It would be silly, to say the least, > for Emacs to give Lisp programs direct access to a list that is used > internally by Emacs and whose order is important. IOW, it is safe > to assume that the returned list can be freely manipulated. Good to know. So any lists returned by functions in the source code are either new (conses) or there is no source code that points to them. That makes sense, but I wasn't sure it was sure to be the case. From debbugs-submit-bounces@debbugs.gnu.org Sun Aug 23 09:34:13 2015 Received: (at 21305) by debbugs.gnu.org; 23 Aug 2015 13:34:13 +0000 Received: from localhost ([127.0.0.1]:35687 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTVPY-0000Pl-VI for submit@debbugs.gnu.org; Sun, 23 Aug 2015 09:34:13 -0400 Received: from mout.gmx.net ([212.227.15.18]:53289) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTVPS-0000PX-DE for 21305@debbugs.gnu.org; Sun, 23 Aug 2015 09:34:06 -0400 Received: from [188.22.42.120] ([188.22.42.120]) by mail.gmx.com (mrgmx002) with ESMTPSA (Nemesis) id 0M9ra4-1Za8Br2kxs-00B88q; Sun, 23 Aug 2015 15:33:59 +0200 Message-ID: <55D9CBBA.2040107@gmx.at> Date: Sun, 23 Aug 2015 15:33:46 +0200 From: martin rudalics MIME-Version: 1.0 To: Stefan Monnier , Drew Adams Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? References: <089f48ed-6ce9-4753-abcf-3f86d43a278e@default>> <83vbc8iyut.fsf@gnu.org>> <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default> <55D74386.6010708@gmx.at> <7036da11-d296-45a9-b6ee-d7b68830927e@default> <55D74AA3.1070202@gmx.at> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default> <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default> <55D8195A.4040804@gmx.at> <9aa1dcd7-1781-41aa-bf47-7b280b26da1e@default> In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K0:K5eSBkECL4kfw00zLv1wNzTADa2tGpWfw5UxgBzWeNF812gPF2w WBXmElga3MozL8layVQUKssCfkOG9OOItY2nJ11So/dzxe/oEn/viYkMF0P5XpECFO9IXef WnTxqLHynxv/uN0YPYaJtn9LJ6t51wVahskp8S2CHTI4bL3Vvfds/7tGX8E+dFvp/XTp61v RnpkrZ3woLI2Hosj6H8zQ== X-UI-Out-Filterresults: notjunk:1;V01:K0:2or/p4ch6oc=:x+HcBRsCvcHAa2kDwZS2VH TL0Ua1jj5TdEOfqWXgbTn/wsgOiT8nO9BBwIfGZ4gdyaIcNySis1rPFMjOhnWIM29xXXAhsq0 akAI1qFe6/7+lyImFal1fZTyZJ3A0kiA1Sg79/yaZPXoijQW0fXaUnxmBKZMWE5Mbst4qIilo tTvP7g/11JsSxmpAfyLIc1aj0athmuABApJIm6s9nkU+ctKUmtJWcdCYb6uK0MVZktFEAuOb4 D6UORdaDY1HXV3F8LcdDG3n5U8HnyNiOw/yleRKME5eHQaLmFZdH3H42OCaxFe2lIU5Bmtgzl jV5ihKhQhycWnEy8Cwsdbv+DiNa5NwUSoXDOByzdbhsN2M++qlX7ELIp2/atWqihotKattA28 RoV76qxKf7beEozoY4Gxo2CMTSR4JYZ2LfWOk3ND02SAMD7K0YwedNXbT7l4QoqXcaDJLmkRC zj+mpetRbgnFmQXFf3xE+02TXAE5s3Xf/5o/ojpSRcVxE98boCzhFkk+o0gg0yFucq+7a3gxD qEYWohFoi9SfNc8M/Nt35WzYezuEMJlSacRhHaw91dLHIyVmKGxaM9rp5ETwHi8YptGKzkGbs sPe/rfOVLYIvio+/HJ+mdc3QzMrt14GkDNZcx4bZItB8n+kt6uffVZNZuCQuVSuNfNZsJeqcV yW3DietfSm7wm804RvFIF+hlVOnRvXykaeMC3kEbTj3MoUvFl0uwa4WjQ4fkMcKek2ulL9B+X gUGYyKGva5uBwcZDjtFEU8l3udrhlY3Ia9Brjg== X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 21305 Cc: Eli Zaretskii , 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) > FWIW, I think adding an argument for that is a bad idea. If the calle= r > needs the windows sorted in a particular way, then *he* should > sort them. > > It would make sense to provide sorting directly in the function if the= > sorting can't be done, or not as efficiently, after the fact. > But that is not the case here. If I want to write or provide functions like =E2=80=98mru-window-for-buff= er=E2=80=99 or =E2=80=98lru-window-for-buffer=E2=80=99, then such a function could easil= y use the car of `get-buffer-window-list' called with the appropriate argument. So I don't see why adding an argument would be a "bad idea". martin From debbugs-submit-bounces@debbugs.gnu.org Sun Aug 23 18:34:48 2015 Received: (at 21305) by debbugs.gnu.org; 23 Aug 2015 22:34:48 +0000 Received: from localhost ([127.0.0.1]:36274 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTdqi-0006Y7-GV for submit@debbugs.gnu.org; Sun, 23 Aug 2015 18:34:48 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.181]:18129) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZTdqg-0006Xy-GY for 21305@debbugs.gnu.org; Sun, 23 Aug 2015 18:34:47 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0AvEwA731xV/5P+d0tcgxCEAoVVuzcJhH6CTQQCAoE8ORQBAQEBAQEBgQpBBYNdAQEDAVYjBQsLNBIUGA0kiDcIzyMBAQEBBgEBAQEeizqFBQeELQEEmW2RNogcgUUjgWaCLiKCeAEBAQ X-IPAS-Result: A0AvEwA731xV/5P+d0tcgxCEAoVVuzcJhH6CTQQCAoE8ORQBAQEBAQEBgQpBBYNdAQEDAVYjBQsLNBIUGA0kiDcIzyMBAQEBBgEBAQEeizqFBQeELQEEmW2RNogcgUUjgWaCLiKCeAEBAQ X-IronPort-AV: E=Sophos;i="5.13,465,1427774400"; d="scan'208";a="161135821" Received: from 75-119-254-147.dsl.teksavvy.com (HELO fmsmemgm.homelinux.net) ([75.119.254.147]) by ironport2-out.teksavvy.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 23 Aug 2015 18:34:45 -0400 Received: by fmsmemgm.homelinux.net (Postfix, from userid 20848) id DA00FAE068; Sun, 23 Aug 2015 18:34:44 -0400 (EDT) From: Stefan Monnier To: Drew Adams Subject: Re: bug#21305: 25.0.50; `get-buffer-window-list' doc - what order? Message-ID: References: <5430f5a7-2939-4f96-8c6c-3e820ffcfd6b@default>> <55D74386.6010708@gmx.at>> <7036da11-d296-45a9-b6ee-d7b68830927e@default>> <55D74AA3.1070202@gmx.at>> <1b17a036-c525-4dbc-84fa-cc8adc2b6488@default>> <50fbb71c-8a6d-45b4-a467-a31bcc73ac09@default>> > <55D8195A.4040804@gmx.at>> <9aa1dcd7-1781-41aa-bf47-7b280b26da1e@default>> > > <83a8tji626.fsf@gnu.org>> Date: Sun, 23 Aug 2015 18:34:44 -0400 In-Reply-To: (Drew Adams's message of "Sat, 22 Aug 2015 12:01:59 -0700 (PDT)") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.3 (/) X-Debbugs-Envelope-To: 21305 Cc: rudalics@gmx.at, Eli Zaretskii , 21305@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) > points to them. That makes sense, but I wasn't sure it was sure > to be the case. I wouldn't say it's sure to be the case, but if/when it's not the case, then either I'd consider it a bug, or the docstring should make it clear. Stefan From unknown Sun Jun 22 03:56:55 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Mon, 21 Sep 2015 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator