Update copyright for years from Emacs 21 to present (mainly adding
[bpt/emacs.git] / lispref / hooks.texi
index 11b2233..019777f 100644 (file)
@@ -1,11 +1,13 @@
 @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.
@@ -26,14 +28,8 @@ 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}.
-
-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.
@@ -91,7 +87,13 @@ however, we have renamed all of those.)
 @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}.
@@ -103,6 +105,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.
 
@@ -125,7 +130,12 @@ is useful for truncating history lists, for example.  @xref{Saving
 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
@@ -135,7 +145,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}.
@@ -171,7 +181,12 @@ for appointment notification.
 @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}.
@@ -191,14 +206,24 @@ for appointment notification.
 @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}.
@@ -213,10 +238,20 @@ Manual}.
 @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
 
@@ -230,7 +265,12 @@ Manual}.
 @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}.
@@ -256,10 +296,20 @@ Manual}.
 @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}.