GNU bug report logs - #8056
24.0.50; doc for `open-dribble-file'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 8056 in the body.
You can then email your comments to 8056 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.0.50; doc for `open-dribble-file'
Date: Wed, 16 Feb 2011 07:08:58 -0800

1. In the doc string, mention how/when the file is closed: when the
Emacs process ends.  This is stated in the Emacs manual but should also
be stated in the doc string, as someone will wonder how to close it.
 
2. (emacs) Checklist is where we document this command, but we don't
even say that it is a command.  We give users the impression that tney
need to use (open-dribble-file "~/dribble"), whereas they can also use
`M-x open-dribble-file' and are prompted for the file to use.
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-02-14 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4) --no-opt --cflags
-Ic:/imagesupport/include'
 

Message #12 received at 8056 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 8056 <at> debbugs.gnu.org
Subject: Re: 24.0.50; doc for `open-dribble-file'
Date: Thu, 14 Jul 2011 20:38:28 +0200

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

> 1. In the doc string, mention how/when the file is closed: when the
> Emacs process ends.  This is stated in the Emacs manual but should also
> be stated in the doc string, as someone will wonder how to close it.
>
> 2. (emacs) Checklist is where we document this command, but we don't
> even say that it is a command.  We give users the impression that tney
> need to use (open-dribble-file "~/dribble"), whereas they can also use
> `M-x open-dribble-file' and are prompted for the file to use.

I've now fixed both these.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

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