@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 2002, 2003, 2004,
-@c 2005 Free Software Foundation, Inc.
+@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 2001, 2002, 2003, 2004,
+@c 2005, 2006, 2007 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.
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}.
-
-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.)
+or their values are used). The variables whose names end in
+@samp{-function} have single functions as their values.
@c We need to xref to where each hook is documented or else document
@c it here.
@xref{Lazy Properties}.
@item calendar-load-hook
+@iftex
@inforef{Calendar Customizing,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Calendar Customizing,,, emacs}.
+@end ifnottex
+
@item change-major-mode-hook
@xref{Creating Buffer-Local}.
@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.
Emacs Sessions,, Saving Emacs Sessions, emacs, the GNU Emacs Manual}.
@item diary-display-hook
+@iftex
@inforef{Fancy Diary Display,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Fancy Diary Display,,, emacs}.
+@end ifnottex
@item diary-hook
List of functions called after the display of the diary. Can be used
@xref{Disabling Commands}.
@item echo-area-clear-hook
-@xref{The Echo Area}.
+@xref{Echo Area Customization}.
@item emacs-startup-hook
@xref{Init File}.
@xref{Other Font Lock Variables}.
@item initial-calendar-window-hook
+@iftex
@inforef{Calendar Customizing,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Calendar Customizing,,, emacs}.
+@end ifnottex
@item kbd-macro-termination-hook
@xref{Keyboard Macros}.
@item lisp-indent-function
@item list-diary-entries-hook
+@iftex
@inforef{Fancy Diary Display,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Fancy Diary Display,,, emacs}.
+@end ifnottex
@item mail-setup-hook
@xref{Mail Mode Misc,, Mail Mode Miscellany, emacs, the GNU Emacs
Manual}.
@item mark-diary-entries-hook
+@iftex
@inforef{Fancy Diary Display,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Fancy Diary Display,,, emacs}.
+@end ifnottex
@item menu-bar-update-hook
@xref{Menu Bar}.
@xref{Mouse Position}.
@item nongregorian-diary-listing-hook
+@iftex
@inforef{Hebrew/Islamic Entries,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Hebrew/Islamic Entries,,, emacs}.
+@end ifnottex
@item nongregorian-diary-marking-hook
+@iftex
@inforef{Hebrew/Islamic Entries,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Hebrew/Islamic Entries,,, emacs}.
+@end ifnottex
@item occur-hook
@xref{Command Overview}.
@item print-diary-entries-hook
+@iftex
@inforef{Diary Customizing,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Diary Customizing,,, emacs}.
+@end ifnottex
@item redisplay-end-trigger-functions
@xref{Window Hooks}.
@xref{Terminal-Specific}.
@item today-visible-calendar-hook
+@iftex
@inforef{Calendar Customizing,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Calendar Customizing,,, emacs}.
+@end ifnottex
@item today-invisible-calendar-hook
+@iftex
@inforef{Calendar Customizing,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Calendar Customizing,,, emacs}.
+@end ifnottex
@item window-configuration-change-hook
@xref{Window Hooks}.