bug#3199: 23.0.92; doc string of frame-list

bug#3199: 23.0.92; doc string of frame-list

[Drew Adams]

Doc string: "Return a list of all frames."
 
That's incorrect/incomplete. The Elisp manual says this, which is
apparently correct:
 
     The function `frame-list' returns a list of all the frames that
     have not been deleted.  It is analogous to `buffer-list' for
     buffers, and includes frames on all terminals.  The list that you
     get is newly created, so modifying the list doesn't have any
     effect on the internals of Emacs.
 
The doc string too should say that it is all live frames.
 
And the manual should use the term "live" frame, since that is the
term used by Emacs (e.g. frame-live-p): "returns a list of all live
frames, that is, the frames that have not been deleted."
 
Question: How to get a list of all frames, including dead frames?
 
 
 
In GNU Emacs 23.0.92.1 (i386-mingw-nt5.1.2600)
 of 2009-03-30 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 

bug#3199: 23.0.92; doc string of frame-list

[Stefan Monnier]

> Question: How to get a list of all frames, including dead frames?
 
There's no way provided to do that, just like there's no way to get the
list of all cons cells.  You can use an after-make-frame-function to
register all the frames ever created into a list.


        Stefan

bug#3199: marked as done (23.0.92; doc string of frame-list)

[Emacs bug Tracking System]

[-- Attachment #1: Type: text/plain, Size: 883 bytes --]


Your message dated Mon, 04 May 2009 15:44:16 -0400
with message-id <jwveiv4wt5b.fsf-monnier+emacsbugreports@gnu.org>
and subject line Re: bug#3199: 23.0.92; doc string of frame-list
has caused the Emacs bug report #3199,
regarding 23.0.92; doc string of frame-list
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com
immediately.)


-- 
3199: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3199
Emacs Bug Tracking System
Contact owner@emacsbugs.donarmstrong.com with problems

[-- Attachment #2: Type: message/rfc822, Size: 3618 bytes --]

From: "Drew Adams" <drew.adams@oracle.com>
To: <emacs-pretest-bug@gnu.org>
Subject: 23.0.92; doc string of frame-list
Date: Sun, 3 May 2009 09:53:45 -0700
Message-ID: <001201c9cc0f$b91fbb10$0200a8c0@us.oracle.com>

Doc string: "Return a list of all frames."
 
That's incorrect/incomplete. The Elisp manual says this, which is
apparently correct:
 
     The function `frame-list' returns a list of all the frames that
     have not been deleted.  It is analogous to `buffer-list' for
     buffers, and includes frames on all terminals.  The list that you
     get is newly created, so modifying the list doesn't have any
     effect on the internals of Emacs.
 
The doc string too should say that it is all live frames.
 
And the manual should use the term "live" frame, since that is the
term used by Emacs (e.g. frame-live-p): "returns a list of all live
frames, that is, the frames that have not been deleted."
 
Question: How to get a list of all frames, including dead frames?
 
 
 
In GNU Emacs 23.0.92.1 (i386-mingw-nt5.1.2600)
 of 2009-03-30 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 




[-- Attachment #3: Type: message/rfc822, Size: 1780 bytes --]

From: Stefan Monnier <monnier@IRO.UMontreal.CA>
To: Drew Adams <drew.adams@oracle.com>
Cc: 3199-done@emacsbugs.donarmstrong.com
Subject: Re: bug#3199: 23.0.92; doc string of frame-list
Date: Mon, 04 May 2009 15:44:16 -0400
Message-ID: <jwveiv4wt5b.fsf-monnier+emacsbugreports@gnu.org>

> The doc string too should say that it is all live frames.
> And the manual should use the term "live" frame, since that is the

Done, thank you,


        Stefan