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: Sat, 22 Aug 2015 20:30:57 +0300 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> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1440264741 29348 80.91.229.3 (22 Aug 2015 17:32:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 22 Aug 2015 17:32:21 +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 Sat Aug 22 19:32: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 1ZTCeH-0006yW-Pg for geb-bug-gnu-emacs@m.gmane.org; Sat, 22 Aug 2015 19:32:09 +0200 Original-Received: from localhost ([::1]:47360 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZTCeH-0002yp-97 for geb-bug-gnu-emacs@m.gmane.org; Sat, 22 Aug 2015 13:32:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49221) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZTCeE-0002yP-Cu for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2015 13:32:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZTCeA-00069z-AS for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2015 13:32:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:43155) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZTCeA-00069v-8E for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2015 13:32:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1ZTCeA-00028T-2Z for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2015 13:32:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 22 Aug 2015 17:32:02 +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.14402646638107 (code B ref 21305); Sat, 22 Aug 2015 17:32:02 +0000 Original-Received: (at 21305) by debbugs.gnu.org; 22 Aug 2015 17:31:03 +0000 Original-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 Original-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 Original-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) Original-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) 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:105706 Archived-At: > 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.