Mercurial > emacs
annotate lispref/locals.texi @ 70550:c53461da6760
(File Local Variables): Document
safe-local-eval-forms and safe-local-eval-function.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Wed, 10 May 2006 01:40:11 +0000 |
parents | 067115a6e738 |
children | 22916db86ba2 c5406394f567 |
rev | line source |
---|---|
7085 | 1 @c -*-texinfo-*- |
2 @c This is part of the GNU Emacs Lisp Reference Manual. | |
64889
e836425ee789
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64875
diff
changeset
|
3 @c Copyright (C) 1990, 1991, 1992, 1993, 1999, 2002, 2003, 2004, |
68648
067115a6e738
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
65369
diff
changeset
|
4 @c 2005, 2006 Free Software Foundation, Inc. |
7085 | 5 @c See the file elisp.texi for copying conditions. |
6 @setfilename ../info/locals | |
7 @node Standard Buffer-Local Variables, Standard Keymaps, Standard Errors, Top | |
8 @appendix Buffer-Local Variables | |
9 @c The title "Standard Buffer-Local Variables" is too long for | |
10 @c smallbook. --rjc 30mar92 | |
11 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
12 The table below lists the general-purpose Emacs variables that |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
13 automatically become buffer-local in each buffer. Most become |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
14 buffer-local only when set; a few of them are always local in every |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
15 buffer. Many Lisp packages define such variables for their internal |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
16 use, but we don't try to list them all here. |
7085 | 17 |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
18 Each minor modes defines a buffer-local variable named |
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
19 @samp{@var{modename}-mode}. @xref{Minor Mode Conventions}. Minor |
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
20 mode variables will not be listed here. |
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
21 |
7085 | 22 @table @code |
23 @item auto-fill-function | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
24 @xref{Auto Filling}. |
7085 | 25 |
56983
1b918ff286e6
(Standard Buffer-Local Variables): Add `buffer-auto-save-file-format'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
55415
diff
changeset
|
26 @item buffer-auto-save-file-format |
1b918ff286e6
(Standard Buffer-Local Variables): Add `buffer-auto-save-file-format'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
55415
diff
changeset
|
27 @xref{Format Conversion}. |
1b918ff286e6
(Standard Buffer-Local Variables): Add `buffer-auto-save-file-format'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
55415
diff
changeset
|
28 |
7085 | 29 @item buffer-auto-save-file-name |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
30 @xref{Auto-Saving}. |
7085 | 31 |
32 @item buffer-backed-up | |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
33 @xref{Making Backups}. |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
34 |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
35 @item buffer-display-count |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
36 @xref{Buffers and Windows}. |
7085 | 37 |
38 @item buffer-display-table | |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
39 @xref{Active Display Table}. |
7085 | 40 |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
41 @item buffer-display-time |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
42 @xref{Buffers and Windows}. |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
43 |
26446 | 44 @item buffer-file-coding-system |
45 @xref{Encoding and I/O}. | |
46 | |
12098 | 47 @item buffer-file-format |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
48 @xref{Format Conversion}. |
12098 | 49 |
7085 | 50 @item buffer-file-name |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
51 @xref{Buffer File Name}. |
7085 | 52 |
53 @item buffer-file-number | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
54 @xref{Buffer File Name}. |
7085 | 55 |
56 @item buffer-file-truename | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
57 @xref{Buffer File Name}. |
7085 | 58 |
59 @item buffer-file-type | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
60 @xref{MS-DOS File Types}. |
7085 | 61 |
12098 | 62 @item buffer-invisibility-spec |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
63 @xref{Invisible Text}. |
12098 | 64 |
7085 | 65 @item buffer-offer-save |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
66 @xref{Killing Buffers}. |
7085 | 67 |
68 @item buffer-read-only | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
69 @xref{Read Only Buffers}. |
7085 | 70 |
71 @item buffer-saved-size | |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
72 @xref{Auto-Saving}. |
7085 | 73 |
74 @item buffer-undo-list | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
75 @xref{Undo}. |
7085 | 76 |
9400
c7f291610c8d
Added entry for cache-long-line-scans
Jim Blandy <jimb@redhat.com>
parents:
7600
diff
changeset
|
77 @item cache-long-line-scans |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
78 @xref{Truncation}. |
9400
c7f291610c8d
Added entry for cache-long-line-scans
Jim Blandy <jimb@redhat.com>
parents:
7600
diff
changeset
|
79 |
7085 | 80 @item case-fold-search |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
81 @xref{Searching and Case}. |
7085 | 82 |
83 @item ctl-arrow | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
84 @xref{Usual Display}. |
7085 | 85 |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
86 @item cursor-type |
64875
4daccd802437
(Standard Buffer-Local Variables): Fix xref.
Richard M. Stallman <rms@gnu.org>
parents:
58885
diff
changeset
|
87 @xref{Cursor Parameters}. |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
88 |
7085 | 89 @item comment-column |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
90 @xref{Comments,,, emacs, The GNU Emacs Manual}. |
7085 | 91 |
92 @item default-directory | |
54062
b03c387f73cf
(Standard Buffer-Local Variables): Fix xref.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
93 @xref{File Name Expansion}. |
7085 | 94 |
95 @item defun-prompt-regexp | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
96 @xref{List Motion}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
97 |
55415 | 98 @item desktop-save-buffer |
99 @xref{Desktop Save Mode}. | |
100 | |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
101 @ignore |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
102 @item direction-reversed |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
103 Does not work yet. |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
104 @end ignore |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
105 |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
106 @item enable-multibyte-characters |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
107 @ref{Text Representations}. |
7085 | 108 |
109 @item fill-column | |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
110 @xref{Margins}. |
7085 | 111 |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
112 @item fringes-outside-margins |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
113 @xref{Fringes}. |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
114 |
7085 | 115 @item goal-column |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
116 @xref{Moving Point,,, emacs, The GNU Emacs Manual}. |
7085 | 117 |
26446 | 118 @item header-line-format |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
119 @xref{Header Lines}. |
26446 | 120 |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
121 @item indicate-buffer-boundaries |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
122 @xref{Usual Display}. |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
123 |
26446 | 124 @item indicate-empty-lines |
125 @xref{Usual Display}. | |
126 | |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
127 @item left-fringe-width |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
128 @xref{Fringe Size/Pos}. |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
129 |
7085 | 130 @item left-margin |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
131 @xref{Margins}. |
7085 | 132 |
26446 | 133 @item left-margin-width |
134 @xref{Display Margins}. | |
135 | |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
136 @item line-spacing |
58885
da652d3d778e
(Standard Buffer-Local Variables): Fix xref for
Kim F. Storm <storm@cua.dk>
parents:
58869
diff
changeset
|
137 @xref{Line Height}. |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
138 |
7085 | 139 @item local-abbrev-table |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
140 @xref{Standard Abbrev Tables}. |
7085 | 141 |
142 @item major-mode | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
143 @xref{Mode Help}. |
7085 | 144 |
145 @item mark-active | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
146 @xref{The Mark}. |
7085 | 147 |
148 @item mark-ring | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
149 @xref{The Mark}. |
7085 | 150 |
151 @item mode-line-buffer-identification | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
152 @xref{Mode Line Variables}. |
7085 | 153 |
154 @item mode-line-format | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
155 @xref{Mode Line Data}. |
7085 | 156 |
157 @item mode-line-modified | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
158 @xref{Mode Line Variables}. |
7085 | 159 |
160 @item mode-line-process | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
161 @xref{Mode Line Variables}. |
7085 | 162 |
163 @item mode-name | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
164 @xref{Mode Line Variables}. |
7085 | 165 |
12098 | 166 @item point-before-scroll |
26696
ef5e7bbe6f19
Current version from /gd/gnu/elisp.
Dave Love <fx@gnu.org>
parents:
26446
diff
changeset
|
167 Used for communication between mouse commands and scroll-bar commands. |
12098 | 168 |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
169 @item right-fringe-width |
65369
822218f80ae4
2005-09-08 Chong Yidong <cyd@stupidchicken.com>
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
170 @xref{Fringe Size/Pos}. |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
171 |
26446 | 172 @item right-margin-width |
173 @xref{Display Margins}. | |
174 | |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
175 @item scroll-bar-width |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
176 @xref{Scroll Bars}. |
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
177 |
26446 | 178 @item scroll-down-aggressively |
179 @xref{Textual Scrolling}. | |
180 | |
181 @item scroll-up-aggressively | |
182 @xref{Textual Scrolling}. | |
183 | |
7085 | 184 @item selective-display |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
185 @xref{Selective Display}. |
7085 | 186 |
187 @item selective-display-ellipses | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
188 @xref{Selective Display}. |
7085 | 189 |
190 @item tab-width | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
191 @xref{Usual Display}. |
7085 | 192 |
193 @item truncate-lines | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
12098
diff
changeset
|
194 @xref{Truncation}. |
7085 | 195 |
58498
5ba4d96600d3
(Standard Buffer-Local Variables): Add many vars.
Richard M. Stallman <rms@gnu.org>
parents:
56983
diff
changeset
|
196 @item vertical-scroll-bar |
58885
da652d3d778e
(Standard Buffer-Local Variables): Fix xref for
Kim F. Storm <storm@cua.dk>
parents:
58869
diff
changeset
|
197 @xref{Scroll Bars}. |
7085 | 198 @end table |
52401 | 199 |
200 @ignore | |
201 arch-tag: 6baae835-b667-4447-91e2-9829ae1cf543 | |
202 @end ignore |