From mboxrd@z Thu Jan 1 00:00:00 1970 Path: quimby.gnus.org!not-for-mail From: "Kim F. Storm" Newsgroups: gmane.emacs.devel Subject: Weak documentation on buffer-local hooks. Date: Tue, 19 Feb 2002 09:12:59 +0000 (GMT) Message-ID: <20020219091259.EAD017C035@mail.filanet.dk> Reply-To: storm@cua.dk NNTP-Posting-Host: quimby2.netfonds.no X-Trace: quimby2.netfonds.no 1014112949 9093 195.204.10.66 (19 Feb 2002 10:02:29 GMT) X-Complaints-To: usenet@quimby2.netfonds.no NNTP-Posting-Date: 19 Feb 2002 10:02:29 GMT Original-Received: from fencepost.gnu.org ([199.232.76.164]) by quimby2.netfonds.no with esmtp (Exim 3.12 #1 (Debian)) id 16d76S-0002MZ-00 for ; Tue, 19 Feb 2002 11:02:28 +0100 Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org) by fencepost.gnu.org with esmtp (Exim 3.33 #1 (Debian)) id 16d6ND-0003Gd-00; Tue, 19 Feb 2002 04:15:43 -0500 Original-Received: from mail.filanet.dk ([195.215.206.179]) by fencepost.gnu.org with smtp (Exim 3.33 #1 (Debian)) id 16d6Kc-00039j-00 for ; Tue, 19 Feb 2002 04:13:03 -0500 Original-Received: from kfs2.cua.dk.cua.dk (kfs2.local.filanet.dk [192.168.1.182]) by mail.filanet.dk (Postfix) with SMTP id EAD017C035 for ; Tue, 19 Feb 2002 09:12:58 +0000 (GMT) Original-To: emacs-devel@gnu.org Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.5 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: quimby.gnus.org gmane.emacs.devel:1311 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:1311 Now that make-local-hook is obsoleted by the LOCAL arg to add-hook, that function is no longer documented in the Emacs lisp manual. Consequently, the documentation about buffer-local hooks is pretty much non-existing in the manual now. Specifically, the following information should be included in the descriptive part of the Hooks section (edited from the doc string of make-local-hook): Buffer-local hooks: When a hook is added as a buffer-local hook, its local and global values work in concert: running the hook actually runs all the hook functions listed in *either* the local value *or* the global value of the hook variable. This should probably be added to add-hook's documentation: This works by making t a member of the buffer-local value, which acts as a flag to run the hook functions in the default value as well. I'm not sure whether the following is still valid: This works for all normal hooks, but does not work for most non-normal hooks yet. We will be changing the callers of non-normal hooks so that they can handle localness; this has to be done one by one. -- Kim F. Storm http://www.cua.dk _______________________________________________ Emacs-devel mailing list Emacs-devel@gnu.org http://mail.gnu.org/mailman/listinfo/emacs-devel