From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#11342: 24.1.50; HOOK variable name in `add-hook' etc. confusing Date: Thu, 26 Apr 2012 00:45:26 +0200 Message-ID: <87y5pjjurd.fsf@web.de> Reply-To: michael_heerdegen@web.de NNTP-Posting-Host: plane.gmane.org X-Trace: dough.gmane.org 1335393856 2912 80.91.229.3 (25 Apr 2012 22:44:16 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 25 Apr 2012 22:44:16 +0000 (UTC) To: 11342@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 26 00:44:14 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SNAwY-0006vZ-3B for geb-bug-gnu-emacs@m.gmane.org; Thu, 26 Apr 2012 00:44:14 +0200 Original-Received: from localhost ([::1]:59749 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SNAwX-0001Vg-GQ for geb-bug-gnu-emacs@m.gmane.org; Wed, 25 Apr 2012 18:44:13 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:33493) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SNAwU-0001VV-Mo for bug-gnu-emacs@gnu.org; Wed, 25 Apr 2012 18:44:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SNAwR-00010s-UN for bug-gnu-emacs@gnu.org; Wed, 25 Apr 2012 18:44:10 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:52163) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SNAwR-00010g-IY for bug-gnu-emacs@gnu.org; Wed, 25 Apr 2012 18:44:07 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SNAxK-00050f-3f for bug-gnu-emacs@gnu.org; Wed, 25 Apr 2012 18:45:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Apr 2012 22:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 11342 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.133539388119215 (code B ref -1); Wed, 25 Apr 2012 22:45:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 25 Apr 2012 22:44:41 +0000 Original-Received: from localhost ([127.0.0.1]:53197 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SNAwz-0004zs-Di for submit@debbugs.gnu.org; Wed, 25 Apr 2012 18:44:41 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55207) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SNAwx-0004zf-MD for submit@debbugs.gnu.org; Wed, 25 Apr 2012 18:44:40 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SNAvy-0000z4-3X for submit@debbugs.gnu.org; Wed, 25 Apr 2012 18:43:39 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:41089) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SNAvy-0000z0-0S for submit@debbugs.gnu.org; Wed, 25 Apr 2012 18:43:38 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:33416) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SNAvw-0001Uw-8e for bug-gnu-emacs@gnu.org; Wed, 25 Apr 2012 18:43:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SNAvu-0000yo-3y for bug-gnu-emacs@gnu.org; Wed, 25 Apr 2012 18:43:35 -0400 Original-Received: from fmmailgate02.web.de ([217.72.192.227]:53182) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SNAvt-0000yi-Th for bug-gnu-emacs@gnu.org; Wed, 25 Apr 2012 18:43:34 -0400 Original-Received: from moweb002.kundenserver.de (moweb002.kundenserver.de [172.19.20.108]) by fmmailgate02.web.de (Postfix) with ESMTP id EFA3C1C3F5212 for ; Thu, 26 Apr 2012 00:43:30 +0200 (CEST) Original-Received: from snow.dragon ([89.204.139.254]) by smtp.web.de (mrweb001) with ESMTPA (Nemesis) id 0McWXI-1Sehof3ytM-00HgJu; Thu, 26 Apr 2012 00:43:30 +0200 X-Provags-ID: V02:K0:T9N1ccELchy0980HZEcaye/wzlOdcuf5mTJJcPRcZxt dEwUgSstA7z5RGu8advM0t2bQi5s0tJ7g2ASa1xx9HZXGCit4i x78ENOKOuEGB0qwkEZkq4pXkiOpLmJhV7Npap3GntpYVMxqrx3 yAMuulniWMQzwePItLuxHjuEq+RPQWUSFlYRwrkHEwAYJhlbiL RDQW9BcG0hrWbjWsGSpINMV9yQtcGTm++nBZasa3UA= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4-2.6 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:59491 Archived-At: Hi, this is just a tiny detail, but confusing for newbies: Turn on eldoc mode in any elisp buffer. If you move point into an `add-hook' or `remove-hook' form, you get e.g. the message remove-hook: (HOOK FUNCTION &optional LOCAL) You could misinterpret that and think that the first argument must be a value representing a hook. But actually it must be a _symbol_ holding a hook. So, I want to make the suggestion to replace the variable `hook' in the definition of `remove-hook' by `hook-var', and to do the same for `add-hook' and `run-hooks'. Then, the eldoc message would be remove-hook: (HOOK-VAR FUNCTION &optional LOCAL) which is more clear. Thanks, Michael. In GNU Emacs 24.1.50.1 (i486-pc-linux-gnu, GTK+ Version 3.4.1) of 2012-04-23 on zelenka, modified by Debian (emacs-snapshot package, version 2:20120423-1) Windowing system distributor `The X.Org Foundation', version 11.0.11104000 Configured using: `configure '--build' 'i486-linux-gnu' '--host' 'i486-linux-gnu' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--enable-locallisppath=/etc/emacs-snapshot:/etc/emacs:/usr/local/share/emacs/24.1.50/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/24.1.50/site-lisp:/usr/share/emacs/site-lisp' '--without-compress-info' '--with-crt-dir=/usr/lib/i386-linux-gnu/' '--with-x=yes' '--with-x-toolkit=gtk3' '--with-imagemagick=yes' 'build_alias=i486-linux-gnu' 'host_alias=i486-linux-gnu' 'CFLAGS=-DDEBIAN -DSITELOAD_PURESIZE_EXTRA=5000 -g -O2''