From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: don@donarmstrong.com (Emacs bug Tracking System) Newsgroups: gmane.emacs.bugs Subject: bug#761: marked as done (23.0.60; doc for temp-buffer-show-hook) Date: Fri, 22 Aug 2008 20:10:04 -0700 Message-ID: References: <874p5csa52.fsf@cyd.mit.edu> <003701c90496$34b4f610$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----------=_1219461004-12430-0" X-Trace: ger.gmane.org 1219462075 5276 80.91.229.12 (23 Aug 2008 03:27:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 23 Aug 2008 03:27:55 +0000 (UTC) To: Chong Yidong Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 23 05:28:48 2008 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.50) id 1KWjny-0000nL-LA for geb-bug-gnu-emacs@m.gmane.org; Sat, 23 Aug 2008 05:28:47 +0200 Original-Received: from localhost ([127.0.0.1]:37635 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KWjn0-0007zs-Tx for geb-bug-gnu-emacs@m.gmane.org; Fri, 22 Aug 2008 23:27:46 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KWjmm-0007i9-BC for bug-gnu-emacs@gnu.org; Fri, 22 Aug 2008 23:27:32 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KWjmk-0007el-K9 for bug-gnu-emacs@gnu.org; Fri, 22 Aug 2008 23:27:31 -0400 Original-Received: from [199.232.76.173] (port=56571 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KWjmk-0007eT-El for bug-gnu-emacs@gnu.org; Fri, 22 Aug 2008 23:27:30 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:32930) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KWjmk-000163-7P for bug-gnu-emacs@gnu.org; Fri, 22 Aug 2008 23:27:30 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m7N3RRjx018443; Fri, 22 Aug 2008 20:27:28 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id m7N3A4ps012547; Fri, 22 Aug 2008 20:10:04 -0700 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: don@donarmstrong.com X-Emacs-PR-Message: closed 761 X-Emacs-PR-Package: emacs X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list 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:19651 Archived-At: This is a multi-part message in MIME format... ------------=_1219461004-12430-0 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 Your message dated Fri, 22 Aug 2008 23:06:17 -0400 with message-id <874p5csa52.fsf@cyd.mit.edu> and subject line Re: 23.0.60; doc for temp-buffer-show-hook has caused the Emacs bug report #761, regarding 23.0.60; doc for temp-buffer-show-hook to be marked as done. This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact don@donarmstrong.com immediately.) --=20 761: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3D761 Emacs Bug Tracking System Contact don@donarmstrong.com with problems ------------=_1219461004-12430-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-6.2 required=4.0 tests=AWL,BAYES_00, RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at submit) by emacsbugs.donarmstrong.com; 22 Aug 2008 20:34:09 +0000 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m7MKY5mN014793 for ; Fri, 22 Aug 2008 13:34:07 -0700 Received: from mail.gnu.org ([199.232.76.166]:50617 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1KWdJK-0002H9-BD for emacs-pretest-bug@gnu.org; Fri, 22 Aug 2008 16:32:42 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1KWdKZ-0002jY-VP for emacs-pretest-bug@gnu.org; Fri, 22 Aug 2008 16:34:04 -0400 Received: from agminet01.oracle.com ([141.146.126.228]:10267) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KWdKZ-0002jM-De for emacs-pretest-bug@gnu.org; Fri, 22 Aug 2008 16:33:59 -0400 Received: from agmgw1.us.oracle.com (agmgw1.us.oracle.com [152.68.180.212]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m7MKXuij018420 for ; Fri, 22 Aug 2008 15:33:56 -0500 Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by agmgw1.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m7MKXtEG020169 for ; Fri, 22 Aug 2008 14:33:55 -0600 Received: from inet-141-146-46-1.oracle.com by acsmt357.oracle.com with ESMTP id 11654511641219437149; Fri, 22 Aug 2008 15:32:29 -0500 Received: from dradamslap1 (/141.144.89.89) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 22 Aug 2008 13:32:29 -0700 From: "Drew Adams" To: Subject: 23.0.60; doc for temp-buffer-show-hook Date: Fri, 22 Aug 2008 13:32:32 -0700 Message-ID: <003701c90496$34b4f610$0200a8c0@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AckEljREn2O3EB7HRcKcP+PnKXAGdg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 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' ------------=_1219461004-12430-0 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-3.6 required=4.0 tests=AWL,BAYES_00 autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at 761-done) by emacsbugs.donarmstrong.com; 23 Aug 2008 03:04:55 +0000 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m7N34q6F010076 for <761-done@emacsbugs.donarmstrong.com>; Fri, 22 Aug 2008 20:04:53 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id 7920857E311; Fri, 22 Aug 2008 23:06:17 -0400 (EDT) To: "Drew Adams" Cc: 761-done@emacsbugs.donarmstrong.com Subject: Re: 23.0.60; doc for temp-buffer-show-hook From: Chong Yidong Date: Fri, 22 Aug 2008 23:06:17 -0400 Message-ID: <874p5csa52.fsf@cyd.mit.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii 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. ------------=_1219461004-12430-0--