GNU bug report logs - #3598
23.0.94; doc string of frame-root-window

Previous Next

Package: emacs;

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

Date: Wed, 17 Jun 2009 16:50:04 UTC

Severity: minor

Merged with 3599

Done: martin rudalics <rudalics <at> gmx.at>

Bug is archived. No further changes may be made.

Full log

View this message in rfc822 format

From: martin rudalics <rudalics <at> gmx.at>
To: Drew Adams <drew.adams <at> oracle.com>, 3598 <at> debbugs.gnu.org
Subject: bug#3598: 23.0.94; doc string of frame-root-window
Date: Thu, 18 Jun 2009 12:07:25 +0200

> Doc string:
> Returns the root-window of frame.
>
> 1. "root-window" should be "root window".
>
> 2. Root window needs to be explained - what is it?
>
> With no explanation, this doc string says nothing at all:
> "`frame-root-window' returns the frame's root window". Gee thanks a
> lot! `thrinblat-oag-plaz' returns the thrinblat's oag plaz.
>
> 3. And the manual's don't help - `frame-root-window' is not mentioned.

IIUC `frame-root-window' was deliberately never described because up to
Emacs 22 it was not always safe to call Lisp functions with an internal
window as argument.  So I think this function was intended for internal
use only.

martin
This bug report was last modified 13 years and 236 days ago.

Previous Next

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