GNU bug report logs - #761
23.0.60; doc for temp-buffer-show-hook

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (Emacs bug Tracking System)
To: "Drew Adams" <drew.adams <at> oracle.com>
Subject: bug#761 closed by Chong Yidong <cyd <at> stupidchicken.com> (Re: 
 23.0.60; doc for temp-buffer-show-hook)

[Message part 1 (text/plain, inline)]

This is an automatic notification regarding your bug report
which was filed against the emacs package:

#761: 23.0.60; doc for temp-buffer-show-hook

It has been closed by Chong Yidong <cyd <at> stupidchicken.com>.

Their explanation is attached below along with your original report.
If this explanation is unsatisfactory and you have not received a
better one in a separate message then please contact Chong Yidong <cyd <at> stupidchicken.com> by
replying to this email.


-- 
761: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=761
Emacs Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Chong Yidong <cyd <at> stupidchicken.com>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 761-done <at> debbugs.gnu.org
Subject: Re: 23.0.60; doc for temp-buffer-show-hook
Date: Fri, 22 Aug 2008 23:06:17 -0400

Okay, I've removed the offending sentence from the docstring and the
lispref file.
 
> Also, the manual just duplicates the doc string verbatim. Is there
> nothing else to say?

Not as far as I can tell.

[Message part 3 (message/rfc822, inline)]

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <emacs-pretest-bug <at> gnu.org>
Subject: 23.0.60; doc for temp-buffer-show-hook
Date: Fri, 22 Aug 2008 13:32:32 -0700

emacs -Q
 
The doc string and Elisp manual both say exactly the same thing for
`temp-buffer-show-hook'. This part of that text should be removed:
 
"This hook is normally set up with a function to make
the buffer read only, and find function names and variable names
in it, provided the major mode is Help mode."
 
It's just not true. Looking at the Emacs source code that sets
`temp-buffer-show-hook', not to mention third-party code that sets it,
this part of the text is not appropriate. "Normally" does not apply
here, and neither does "typically" or anything else.
 
All that should be said is said in the first part of the text: "Normal
hook run by `with-output-to-temp-buffer' after displaying the buffer.
When the hook runs, the temporary buffer is current, and the window it
was displayed in is selected." You can use it for anything you want
to.
 
Also, the manual just duplicates the doc string verbatim. Is there
nothing else to say?
 
 
 
In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600)
 of 2008-08-01 on LENNART-69DE564
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include
-fno-crossjumping'
 

Previous Next

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