From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#8368: 24.0.50; "temp" means "help" - rename or at least document Date: Mon, 28 Mar 2011 09:24:28 -0700 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1301332419 18809 80.91.229.12 (28 Mar 2011 17:13:39 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 28 Mar 2011 17:13:39 +0000 (UTC) To: 8368@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Mar 28 19:13:35 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Q4G0Q-0001mk-5v for geb-bug-gnu-emacs@m.gmane.org; Mon, 28 Mar 2011 19:13:33 +0200 Original-Received: from localhost ([127.0.0.1]:56823 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q4G0D-0002xg-R5 for geb-bug-gnu-emacs@m.gmane.org; Mon, 28 Mar 2011 13:13:17 -0400 Original-Received: from [140.186.70.92] (port=57915 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q4FuK-00007O-Pl for bug-gnu-emacs@gnu.org; Mon, 28 Mar 2011 13:07:15 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q4FuH-0006Y4-9q for bug-gnu-emacs@gnu.org; Mon, 28 Mar 2011 13:07:10 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:51947) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q4FuH-0006Xl-7G for bug-gnu-emacs@gnu.org; Mon, 28 Mar 2011 13:07:09 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Q4FU3-0001NA-8K; Mon, 28 Mar 2011 12:40:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 28 Mar 2011 16:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 8368 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.13013303705232 (code B ref -1); Mon, 28 Mar 2011 16:40:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 28 Mar 2011 16:39:30 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Q4FTV-0001ML-K8 for submit@debbugs.gnu.org; Mon, 28 Mar 2011 12:39:29 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Q4FTS-0001M8-Hp for submit@debbugs.gnu.org; Mon, 28 Mar 2011 12:39:27 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q4FTM-0006tg-PF for submit@debbugs.gnu.org; Mon, 28 Mar 2011 12:39:21 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:44195) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q4FTI-0006Oq-7e for submit@debbugs.gnu.org; Mon, 28 Mar 2011 12:39:20 -0400 Original-Received: from [140.186.70.92] (port=47733 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q4FFI-0007Jj-Op for bug-gnu-emacs@gnu.org; Mon, 28 Mar 2011 12:24:50 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q4FF5-0004S3-5E for bug-gnu-emacs@gnu.org; Mon, 28 Mar 2011 12:24:36 -0400 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:60017) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q4FF4-0004Rv-Sg for bug-gnu-emacs@gnu.org; Mon, 28 Mar 2011 12:24:35 -0400 Original-Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p2SGOWJS018045 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 28 Mar 2011 16:24:33 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p2SGOUQN025435 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 28 Mar 2011 16:24:31 GMT Original-Received: from abhmt005.oracle.com (abhmt005.oracle.com [141.146.116.14]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p2SGOUJ2013668 for ; Mon, 28 Mar 2011 11:24:30 -0500 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 28 Mar 2011 09:24:29 -0700 X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 Thread-Index: AcvtZJw+loPwqv5lRXS+BhFivp0bJg== X-Source-IP: acsmt357.oracle.com [141.146.40.157] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090208.4D90B63F.00C2,ss=1,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Mon, 28 Mar 2011 12:40:03 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:45432 Archived-At: I think it is a mistake to treat "temporary buffer" macros and functions as if they necessarily dealt with particular buffers such as *Help* and *Completions* or with particular modes such as `help-mode' and `completion-list-mode'. Based on their names and descriptions (doc), things such as `with-output-to-temp-buffer' should simply set up a temporary buffer, with no special treatment for it being a "help" buffer or a "completions" buffer etc. Why, for example, should `with-output-to-temp-buffer' always imply calling `help-mode-*' in that buffer? Based on the name, a "temporary buffer" is not necessarily a help buffer. And based on its doc, `with-output-to-temp-buffer', for example, is not about a help buffer. There is NOTHING in its doc that gives the slightest suggestion that the temporary buffer is a help buffer, is in `help-mode', etc. Nada. Please take a moment to read the doc string. But in help.el we do this, at top level: ;; This makes `with-output-to-temp-buffer' buffers use `help-mode'. (add-hook 'temp-buffer-setup-hook 'help-mode-setup) (add-hook 'temp-buffer-show-hook 'help-mode-finish) Yes, I know that this has been the case for a long time. But I also know that the effect has resulted in confusion for at least some users. You can say that the problem is just the name. In that case, the doc should help to correct the false impression by stating explicitly that a "temp" buffer is really a "help" buffer, in `help-mode' (by default). Better, however, would be to rename *-temp-* to *-help-* whenever "temp" really implies "help". And after renaming functions/macros that way, I think it would be good to have real temporary-buffer facilities - a real `with-output-to-temp-buffer' (but we would need to pick a new name, to avoid confusion), one that does not imply using `help-mode' etc. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-03-21 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.5) --no-opt --cflags -Ic:/imagesupport/include'