(Locating Files): Suggest additional values for the

[gnu-emacs] / lispref / hooks.texi

diff --git a/lispref/hooks.texi b/lispref/hooks.texi
index d4a559adf37e27845ef51b29e8185eaef1371e9d..2ba06a2b19afc591eb290eee1c6e8d41561242fb 100644 (file)
--- a/lispref/hooks.texi
+++ b/lispref/hooks.texi
@@ -1,10 +1,13 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 2004, 2005 Free Software Foundation, Inc.
+@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 2002, 2003, 2004,
+@c   2005, 2006 Free Software Foundation, Inc.
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/hooks
 @node Standard Hooks, Index, Standard Keymaps, Top
 @appendix Standard Hooks
+@cindex standard hooks
+@cindex hook variables, list of
 
 The following is a list of hook variables that let you provide
 functions to be called from within Emacs on suitable occasions.
@@ -25,14 +28,13 @@ are omitted in the list below.
 The variables whose names end in @samp{-hooks} or @samp{-functions} are
 usually @dfn{abnormal hooks}; their values are lists of functions, but
 these functions are called in a special way (they are passed arguments,
-or their values are used).  A few of these variables are actually normal
-hooks which were named before we established the convention that normal
-hooks' names should end in @samp{-hook}.
+or their values are used). The variables whose names end in
+@samp{-function} have single functions as their values.
 
-The variables whose names end in @samp{-function} have single functions
-as their values.  (In older Emacs versions, some of these variables had
-names ending in @samp{-hook} even though they were not normal hooks;
-however, we have renamed all of those.)
+(In older Emacs versions, some normal hooks had names ending in
+@samp{-hooks} or @samp{-functions}, and some abnormal hooks had names
+ending in @samp{-hook}.  We have renamed all of these to conform to
+the above conventions.)
 
 @c We need to xref to where each hook is documented or else document
 @c it here.
@@ -102,6 +104,9 @@ however, we have renamed all of those.)
 @xref{Options for Comments,, Options Controlling Comments, emacs, the
 GNU Emacs Manual}.
 
+@item compilation-finish-functions
+Functions to call when a compilation process finishes.
+
 @item custom-define-hook
 Hook called after defining each customize option.
 
@@ -134,7 +139,7 @@ for appointment notification.
 @xref{Disabling Commands}.
 
 @item echo-area-clear-hook
-@xref{The Echo Area}.
+@xref{Echo Area Customization}.
 
 @item emacs-startup-hook
 @xref{Init File}.
@@ -148,6 +153,27 @@ for appointment notification.
 @item first-change-hook
 @xref{Change Hooks}.
 
+@item font-lock-beginning-of-syntax-function
+@xref{Syntactic Font Lock}.
+
+@item font-lock-fontify-buffer-function
+@xref{Other Font Lock Variables}.
+
+@item font-lock-fontify-region-function
+@xref{Other Font Lock Variables}.
+
+@item font-lock-mark-block-function
+@xref{Other Font Lock Variables}.
+
+@item font-lock-syntactic-face-function
+@xref{Syntactic Font Lock}.
+
+@item font-lock-unfontify-buffer-function
+@xref{Other Font Lock Variables}.
+
+@item font-lock-unfontify-region-function
+@xref{Other Font Lock Variables}.
+
 @item initial-calendar-window-hook
 @inforef{Calendar Customizing,, emacs-xtra}.
 
@@ -196,6 +222,8 @@ Manual}.
 @item nongregorian-diary-marking-hook
 @inforef{Hebrew/Islamic Entries,, emacs-xtra}.
 
+@item occur-hook
+
 @item post-command-hook
 @xref{Command Overview}.