GNU bug report logs - #8368
24.0.50; "temp" means "help" - rename or at least document

Previous Next

Full log

View this message in rfc822 format

From: martin rudalics <rudalics <at> gmx.at>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 'Lars Magne Ingebrigtsen' <larsi <at> gnus.org>, 8368 <at> debbugs.gnu.org, 'Stefan Monnier' <monnier <at> iro.umontreal.ca>, rms <at> gnu.org
Subject: bug#8368: 24.0.50; "temp" means "help" - rename or at least document
Date: Sun, 29 Apr 2012 12:40:56 +0200

> What is important to me is that we distinguish the two (or more) so that
> programmers at least have a simple, clean way to display something in a
> temporary buffer with no supposition that that buffer should also be a help
> buffer.  I.e., without removing and re-adding the help-mode hooks.

You don't have to remove and re-add any hooks.  It's sufficient to turn
off help mode in the body of `with-output-to-temp-buffer'.  Similarly,
if you don't want to run `completion-list-mode-finish', turn off
`completion-list-mode' in the buffer.

> Probably we will need to leave the original name for the current behavior, but
> if it could be aliased to something with "help" in the name, and then the
> original name deprecated, that would be better.  (I think that's part of what
> you suggest.)  And create a new name for the temp-without-the-help-stuff case.

Basically, `with-output-to-temp-buffer' is a misnomer.  The buffer is not
necessarily temporary, hence `with-output-temporarily-bound-to-buffer'
would be a better name for this.  In addition, it displays the buffer in
some window and this is not reflected in the name.

martin

Previous Next

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