@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990-1993, 1998, 2001-2012 Free Software Foundation, Inc.
+@c Copyright (C) 1990-1993, 1998, 2001-2015 Free Software Foundation,
+@c Inc.
@c See the file elisp.texi for copying conditions.
-@setfilename ../../info/hooks
-@node Standard Hooks, Index, Standard Keymaps, Top
+@node Standard Hooks
@appendix Standard Hooks
@cindex standard hooks
@cindex hook variables, list of
-The following is a list of hook variables that let you provide
+The following is a list of some hook variables that let you provide
functions to be called from within Emacs on suitable occasions.
Most of these variables have names ending with @samp{-hook}. They are
to put a new function on such a hook is to call @code{add-hook}.
@xref{Hooks}, for more information about using hooks.
-Every major mode defines a mode hook named
+The variables whose names end in @samp{-functions} are usually @dfn{abnormal
+hooks} (some old code may also use the deprecated @samp{-hooks} suffix); their
+values are lists of functions, but these functions are called in a special way
+(they are passed arguments, or their return values are used). The variables
+whose names end in @samp{-function} have single functions as their values.
+
+This is not an exhaustive list, it only covers the more general hooks.
+For example, every major mode defines a hook named
@samp{@var{modename}-mode-hook}. The major mode command runs this
normal hook with @code{run-mode-hooks} as the very last thing it does.
-@xref{Mode Hooks}. Most minor modes have mode hooks too. Mode hooks
-are omitted from 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). The variables whose names end in
-@samp{-function} have single functions as their values.
+@xref{Mode Hooks}. Most minor modes have mode hooks too.
A special feature allows you to specify expressions to evaluate if and
when a file is loaded (@pxref{Hooks for Loading}). That feature is
not exactly a hook, but does a similar job.
-@c We need to xref to where each hook is documented or else document
-@c it here.
+@c We need to xref to where each hook is documented or else document it here.
+@c Add vindex for anything not indexed elsewhere.
+@c This list is in alphabetical order, grouped by topic.
+@c TODO It should probably be more thoroughly ordered by topic.
@table @code
-@item abbrev-expand-functions
-@xref{Abbrev Expansion}.
-
@item activate-mark-hook
+@itemx deactivate-mark-hook
@xref{The Mark}.
@item after-change-functions
+@itemx before-change-functions
+@itemx first-change-hook
@xref{Change Hooks}.
@item after-change-major-mode-hook
+@itemx change-major-mode-after-body-hook
@xref{Mode Hooks}.
@item after-init-hook
+@itemx before-init-hook
+@itemx emacs-startup-hook
+@itemx window-setup-hook
@xref{Init File}.
@item after-insert-file-functions
+@itemx write-region-annotate-functions
+@itemx write-region-post-annotation-function
@xref{Format Conversion}.
@item after-make-frame-functions
+@itemx before-make-frame-hook
@xref{Creating Frames}.
+@c Not general enough?
+@ignore
@item after-revert-hook
+@itemx before-revert-hook
+@itemx buffer-stale-function
+@itemx revert-buffer-function
+@itemx revert-buffer-insert-file-contents-function
@xref{Reverting}.
+@end ignore
@item after-save-hook
+@itemx before-save-hook
+@itemx write-contents-functions
+@itemx write-file-functions
@xref{Saving Buffers}.
-@item auto-fill-function
-@xref{Auto Filling}.
+@item after-setting-font-hook
+@vindex after-setting-font-hook
+Hook run after a frame's font changes.
@item auto-save-hook
@xref{Auto-Saving}.
-@item before-change-functions
-@xref{Change Hooks}.
-
@item before-hack-local-variables-hook
+@itemx hack-local-variables-hook
@xref{File Local Variables}.
-@item before-init-hook
-@xref{Init File}.
-
-@item before-make-frame-hook
-@xref{Creating Frames}.
-
-@item before-revert-hook
-@xref{Reverting}.
-
-@item before-save-hook
-@xref{Saving Buffers}.
-
-@item blink-paren-function
-@xref{Blinking}.
-
@item buffer-access-fontify-functions
@xref{Lazy Properties}.
-@item change-major-mode-after-body-hook
-@xref{Mode Hooks}.
+@item buffer-list-update-hook
+@vindex buffer-list-update-hook
+Hook run when the buffer list changes (@pxref{Buffer List}).
+
+@item buffer-quit-function
+@vindex buffer-quit-function
+Function to call to ``quit'' the current buffer.
@item change-major-mode-hook
@xref{Creating Buffer-Local}.
@item command-line-functions
@xref{Command-Line Arguments}.
-@item comment-indent-function
-@xref{Options for Comments,, Options Controlling Comments, emacs, the
-GNU Emacs Manual}.
+@item delayed-warnings-hook
+@vindex delayed-warnings-hook
+The command loop runs this soon after @code{post-command-hook} (q.v.).
-@item compilation-finish-functions
-Functions to call when a compilation process finishes.
-
-@item custom-define-hook
-Hook called after defining each customize option.
-
-@item deactivate-mark-hook
-@xref{The Mark}.
+@item focus-in-hook
+@vindex focus-in-hook
+@itemx focus-out-hook
+@vindex focus-out-hook
+@xref{Input Focus}.
@item delete-frame-functions
-Functions to call when Emacs deletes a frame. @xref{Deleting Frames}.
+@xref{Deleting Frames}.
@item delete-terminal-functions
-Functions to call when Emacs deletes a terminal. @xref{Multiple Terminals}.
+@xref{Multiple Terminals}.
-@item disabled-command-function
-@xref{Disabling Commands}.
+@item pop-up-frame-function
+@itemx split-window-preferred-function
+@xref{Choosing Window Options}.
@item echo-area-clear-hook
@xref{Echo Area Customization}.
-@item emacs-startup-hook
-@xref{Init File}.
-
@item find-file-hook
+@itemx find-file-not-found-functions
@xref{Visiting Functions}.
-@item find-file-not-found-functions
-@xref{Visiting Functions}.
-
-@item first-change-hook
-@xref{Change Hooks}.
+@item font-lock-extend-after-change-region-function
+@xref{Region to Refontify}.
-@item font-lock-beginning-of-syntax-function
-@xref{Syntactic Font Lock}.
+@item font-lock-extend-region-functions
+@xref{Multiline Font Lock}.
@item font-lock-fontify-buffer-function
+@itemx font-lock-fontify-region-function
+@itemx font-lock-mark-block-function
+@itemx font-lock-unfontify-buffer-function
+@itemx font-lock-unfontify-region-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 hack-local-variables-hook
-@xref{File Local Variables}.
-
-@item font-lock-unfontify-region-function
-@xref{Other Font Lock Variables}.
+@item fontification-functions
+@xref{Auto Faces,, Automatic Face Assignment}.
-@item kbd-macro-termination-hook
-@xref{Keyboard Macros}.
+@item frame-auto-hide-function
+@xref{Quitting Windows}.
@item kill-buffer-hook
-@xref{Killing Buffers}.
-
-@item kill-buffer-query-functions
+@itemx kill-buffer-query-functions
@xref{Killing Buffers}.
@item kill-emacs-hook
+@itemx kill-emacs-query-functions
@xref{Killing Emacs}.
-@item kill-emacs-query-functions
-@xref{Killing Emacs}.
-
-@item mail-setup-hook
-@xref{Mail Misc,, Mail Miscellany, emacs, the GNU Emacs Manual}.
-
@item menu-bar-update-hook
@xref{Menu Bar}.
@item minibuffer-setup-hook
+@itemx minibuffer-exit-hook
@xref{Minibuffer Misc}.
-@item minibuffer-exit-hook
-@xref{Minibuffer Misc}.
+@item mouse-leave-buffer-hook
+@vindex mouse-leave-buffer-hook
+Hook run when about to switch windows with a mouse command.
@item mouse-position-function
@xref{Mouse Position}.
@item post-command-hook
+@itemx pre-command-hook
@xref{Command Overview}.
+@item post-gc-hook
+@xref{Garbage Collection}.
+
@item post-self-insert-hook
@xref{Keymaps and Minor Modes}.
-@item pre-command-hook
-@xref{Command Overview}.
-
+@ignore
@item prog-mode-hook
+@itemx special-mode-hook
+@vindex special-mode-hook
@xref{Basic Major Modes}.
-
-@item resume-tty-functions
-@xref{Suspending Emacs}.
+@end ignore
@item suspend-hook
+@itemx suspend-resume-hook
+@itemx suspend-tty-functions
+@itemx resume-tty-functions
@xref{Suspending Emacs}.
-@item suspend-resume-hook
-@xref{Suspending Emacs}.
-
-@item suspend-tty-functions
-@xref{Suspending Emacs}.
+@item syntax-begin-function
+@itemx syntax-propertize-extend-region-functions
+@itemx syntax-propertize-function
+@itemx font-lock-syntactic-face-function
+@xref{Syntactic Font Lock}. @xref{Syntax Properties}.
@item temp-buffer-setup-hook
+@itemx temp-buffer-show-function
+@itemx temp-buffer-show-hook
@xref{Temporary Displays}.
-@item temp-buffer-show-function
-@xref{Temporary Displays}.
-
-@item temp-buffer-show-hook
-@xref{Temporary Displays}.
-
-@item term-setup-hook
+@item tty-setup-hook
@xref{Terminal-Specific}.
@item window-configuration-change-hook
+@itemx window-scroll-functions
+@itemx window-size-change-functions
@xref{Window Hooks}.
-@item window-scroll-functions
-@xref{Window Hooks}.
-
-@item window-setup-hook
-@xref{Window Systems}.
+@item window-text-change-functions
+@vindex window-text-change-functions
+Functions to call in redisplay when text in the window might change.
-@item window-size-change-functions
-@xref{Window Hooks}.
-
-@item write-contents-functions
-@xref{Saving Buffers}.
-
-@item write-file-functions
-@xref{Saving Buffers}.
-
-@item write-region-annotate-functions
-@xref{Format Conversion}.
@end table
+
+@ignore
+Some -hook, -function, -functions from preloaded Lisp or C files that
+I thought did not need to be mentioned here:
+
+Lisp:
+after-load-functions
+auto-coding-functions
+choose-completion-string-functions
+completing-read-function
+completion-annotate-function
+completion-at-point-functions
+completion-list-insert-choice-function
+deactivate-current-input-method-function
+describe-current-input-method-function
+font-lock-function
+menu-bar-select-buffer-function
+read-file-name-function
+replace-re-search-function
+replace-search-function
+yank-undo-function
+
+C hooks:
+kbd-macro-termination-hook
+signal-hook-function
+
+C functions:
+redisplay-end-trigger-functions
+x-lost-selection-functions
+x-sent-selection-functions
+
+C function:
+auto-composition-function
+auto-fill-function
+command-error-function
+compose-chars-after-function
+composition-function-table
+deferred-action-function
+input-method-function
+load-read-function
+load-source-file-function
+read-buffer-function
+ring-bell-function
+select-safe-coding-system-function
+set-auto-coding-function
+show-help-function
+signal-hook-function
+undo-outer-limit-function
+
+@end ignore