annotate lispref/hooks.texi @ 15960:12c61b25b7b6

(syms_of_alloc): Set up Lisp variables ...-consed, such as Vcons-cells-consed.
author Richard M. Stallman <rms@gnu.org>
date Thu, 29 Aug 1996 00:44:05 +0000
parents a6eb5f12b0f3
children bfe1d6597f08
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1 @c -*-texinfo-*-
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
2 @c This is part of the GNU Emacs Lisp Reference Manual.
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
3 @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
4 @c See the file elisp.texi for copying conditions.
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
5 @setfilename ../info/hooks
12098
a6eb5f12b0f3 *** empty log message ***
Karl Heuer <kwzh@gnu.org>
parents: 7600
diff changeset
6 @node Standard Hooks, Index, Standard Keymaps, Top
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
7 @appendix Standard Hooks
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
8
7600
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
9 The following is a list of hook variables that let you provide
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
10 functions to be called from within Emacs on suitable occasions.
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
11
7600
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
12 Most of these variables have names ending with @samp{-hook}. They are
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
13 @dfn{normal hooks}, run by means of @code{run-hooks}. The value of such
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
14 a hook is a list of functions. The recommended way to put a new
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
15 function on such a hook is to call @code{add-hook}. @xref{Hooks}, for
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
16 more information about using hooks.
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
17
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
18 The variables whose names end in @samp{-function} have single functions
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
19 as their values. Usually there is a specific reason why the variable is
7600
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
20 not a normal hook, such as the need to pass arguments to the function.
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
21 (In older Emacs versions, some of these variables had names ending in
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
22 @samp{-hook} even though they were not normal hooks.)
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
23
7600
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
24 The variables whose names end in @samp{-hooks} or @samp{-functions} have
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
25 lists of functions as their values, but these functions are called in a
8bf07ff6a929 entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 6782
diff changeset
26 special way (they are passed arguments, or else their values are used).
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
27
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
28 @c !!! need xref to where each hook is documented or else document it
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
29 @c by specifying what is expected, and when it is called relative to
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
30 @c mode initialization.)
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
31
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
32 @table @code
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
33 @item activate-mark-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
34 @item after-change-function
6782
5b07647ec8f7 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 6440
diff changeset
35 @item after-change-functions
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
36 @item after-init-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
37 @item after-insert-file-functions
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
38 @item after-make-frame-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
39 @item auto-fill-function
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
40 @item auto-save-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
41 @item before-change-function
6782
5b07647ec8f7 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 6440
diff changeset
42 @item before-change-functions
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
43 @item before-init-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
44 @item before-make-frame-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
45 @item blink-paren-function
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
46 @item c-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
47 @item calendar-load-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
48 @item command-history-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
49 @item comment-indent-function
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
50 @item deactivate-mark-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
51 @item diary-display-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
52 @item diary-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
53 @item dired-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
54 @item disabled-command-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
55 @item edit-picture-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
56 @item electric-buffer-menu-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
57 @item electric-command-history-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
58 @item electric-help-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
59 @item emacs-lisp-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
60 @item find-file-hooks
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
61 @item find-file-not-found-hooks
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
62 @item first-change-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
63 @item fortran-comment-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
64 @item fortran-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
65 @item ftp-setup-write-file-hooks
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
66 @item ftp-write-file-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
67 @item indent-mim-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
68 @item initial-calendar-window-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
69 @item kill-buffer-query-functions
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
70 @item kill-emacs-query-functions
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
71 @item LaTeX-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
72 @item ledit-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
73 @item lisp-indent-function
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
74 @item lisp-interaction-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
75 @item lisp-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
76 @item list-diary-entries-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
77 @item m2-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
78 @item mail-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
79 @item mail-setup-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
80 @item mark-diary-entries-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
81 @item medit-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
82 @item mh-compose-letter-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
83 @item mh-folder-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
84 @item mh-letter-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
85 @item mim-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
86 @item minibuffer-setup-hook
6782
5b07647ec8f7 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 6440
diff changeset
87 @item minibuffer-exit-hook
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
88 @item news-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
89 @item news-reply-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
90 @item news-setup-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
91 @item nongregorian-diary-listing-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
92 @item nongregorian-diary-marking-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
93 @item nroff-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
94 @item outline-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
95 @item plain-TeX-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
96 @item post-command-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
97 @item pre-abbrev-expand-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
98 @item pre-command-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
99 @item print-diary-entries-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
100 @item prolog-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
101 @item protect-innocence-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
102 @item rmail-edit-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
103 @item rmail-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
104 @item rmail-summary-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
105 @item scheme-indent-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
106 @item scheme-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
107 @item scribe-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
108 @item shell-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
109 @item shell-set-directory-error-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
110 @item suspend-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
111 @item suspend-resume-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
112 @item temp-buffer-show-function
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
113 @item term-setup-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
114 @item terminal-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
115 @item terminal-mode-break-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
116 @item TeX-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
117 @item text-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
118 @item today-visible-calendar-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
119 @item today-invisible-calendar-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
120 @item vi-mode-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
121 @item view-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
122 @item window-setup-hook
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
123 @item write-contents-hooks
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
124 @item write-file-hooks
12098
a6eb5f12b0f3 *** empty log message ***
Karl Heuer <kwzh@gnu.org>
parents: 7600
diff changeset
125 @item write-region-annotate-functions
6440
fe511f97c2de Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
126 @end table