GNU bug report logs - #3199
23.0.92; doc string of frame-list

Previous Next

Package: emacs;

Reported by: "Drew Adams" <drew.adams <at> oracle.com>

Date: Sun, 3 May 2009 17:00:03 UTC

Severity: normal

Done: Stefan Monnier <monnier <at> IRO.UMontreal.CA>

Bug is archived. No further changes may be made.

Full log

View this message in rfc822 format

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <emacs-pretest-bug <at> gnu.org>
Subject: bug#3199: 23.0.92; doc string of frame-list
Date: Sun, 3 May 2009 09:53:45 -0700

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)'
This bug report was last modified 16 years and 79 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.