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

Message #35 received at 3598 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Eli Zaretskii'" <eliz <at> gnu.org>, <3598 <at> debbugs.gnu.org>
Cc: <rudalics <at> gmx.at>
Subject: RE: bug#3598: 23.0.94; doc string of frame-root-window
Date: Thu, 18 Jun 2009 08:17:44 -0700

> > If it is an internal function, then please either do not 
> > give it a doc string or, preferably, give it one that calls
> > that out explicitly, and please add a
> > comment explaining why it is internal.
> 
> I see no reason not to have doc strings for internal functions.
> Emacs hackers need doc strings from time to time.  Adding "internal
> use only" to the doc string is the preferred solution.

FWIW, I agree 100%.
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.