aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorChong Yidong2011-07-12 13:33:18 -0400
committerChong Yidong2011-07-12 13:33:18 -0400
commitc830e5aeea7e711b275a36f5ecf15d890742e2f3 (patch)
tree1016fb7f917a4300bc552ea9769a97f3c5b3ac19 /doc
parent077e3dda9478f958acb9c9d5b98e0f739726dea7 (diff)
downloademacs-c830e5aeea7e711b275a36f5ecf15d890742e2f3.tar.gz
emacs-c830e5aeea7e711b275a36f5ecf15d890742e2f3.zip
Remove frame-local vars from Lisp manual; obsolete since Emacs 22.3.
* display.texi (Window Systems): `window-system' is terminal-local. * doc/lispref/frames.texi (Frame Parameters, Parameter Access): Don't mention frame-local variables. * doc/lispref/variables.texi (Buffer-Local Variables): Don't mention obsolete frame-local variables. (Frame-Local Variables): Node deleted. * doc/lispref/elisp.texi (Top): Update node listing.
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/ChangeLog14
-rw-r--r--doc/lispref/display.texi4
-rw-r--r--doc/lispref/elisp.texi1
-rw-r--r--doc/lispref/frames.texi6
-rw-r--r--doc/lispref/variables.texi45
5 files changed, 22 insertions, 48 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 4517faac80e..5b0711d2546 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,17 @@
12011-07-12 Chong Yidong <cyd@stupidchicken.com>
2
3 * display.texi (Window Systems): `window-system' is
4 terminal-local.
5
6 * frames.texi (Frame Parameters, Parameter Access): Don't mention
7 frame-local variables.
8
9 * variables.texi (Buffer-Local Variables): Don't mention obsolete
10 frame-local variables.
11 (Frame-Local Variables): Node deleted.
12
13 * elisp.texi (Top): Update node listing.
14
12011-07-12 Lars Magne Ingebrigtsen <larsi@gnus.org> 152011-07-12 Lars Magne Ingebrigtsen <larsi@gnus.org>
2 16
3 * elisp.texi: Change "inferiors" to "subnodes" in three places 17 * elisp.texi: Change "inferiors" to "subnodes" in three places
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index bc81c59f05f..7e966278383 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -5910,8 +5910,8 @@ differently. An Emacs frame is a single window as far as X is
5910concerned; the individual Emacs windows are not known to X at all. 5910concerned; the individual Emacs windows are not known to X at all.
5911 5911
5912@defvar window-system 5912@defvar window-system
5913This frame-local variable tells Lisp programs what window system Emacs is using 5913This terminal-local variable tells Lisp programs what window system
5914for displaying the frame. The possible values are 5914Emacs is using for displaying the frame. The possible values are
5915 5915
5916@table @code 5916@table @code
5917@item x 5917@item x
diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi
index 4f8dce561a5..bb05f1b4a0b 100644
--- a/doc/lispref/elisp.texi
+++ b/doc/lispref/elisp.texi
@@ -430,7 +430,6 @@ Variables
430* File Local Variables:: Handling local variable lists in files. 430* File Local Variables:: Handling local variable lists in files.
431* Directory Local Variables:: Local variables common to all files in a 431* Directory Local Variables:: Local variables common to all files in a
432 directory. 432 directory.
433* Frame-Local Variables:: Frame-local bindings for variables.
434* Variable Aliases:: Variables that are aliases for other variables. 433* Variable Aliases:: Variables that are aliases for other variables.
435* Variables with Restricted Values:: Non-constant variables whose value can 434* Variables with Restricted Values:: Non-constant variables whose value can
436 @emph{not} be an arbitrary Lisp object. 435 @emph{not} be an arbitrary Lisp object.
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 9a30ba5fdb4..b6012a4dd53 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -337,9 +337,6 @@ parameters @code{foreground-color}, @code{background-color},
337If the terminal supports frame transparency, the parameter 337If the terminal supports frame transparency, the parameter
338@code{alpha} is also meaningful. 338@code{alpha} is also meaningful.
339 339
340 You can use frame parameters to define frame-local bindings for
341variables. @xref{Frame-Local Variables}.
342
343@menu 340@menu
344* Parameter Access:: How to change a frame's parameters. 341* Parameter Access:: How to change a frame's parameters.
345* Initial Parameters:: Specifying frame parameters when you make a frame. 342* Initial Parameters:: Specifying frame parameters when you make a frame.
@@ -374,9 +371,6 @@ elements of @var{alist}. Each element of @var{alist} has the form
374parameter. If you don't mention a parameter in @var{alist}, its value 371parameter. If you don't mention a parameter in @var{alist}, its value
375doesn't change. If @var{frame} is @code{nil}, it defaults to the selected 372doesn't change. If @var{frame} is @code{nil}, it defaults to the selected
376frame. 373frame.
377
378You can use this function to define frame-local bindings for
379variables, see @ref{Frame-Local Variables}.
380@end defun 374@end defun
381 375
382@defun set-frame-parameter frame parm value 376@defun set-frame-parameter frame parm value
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index 4ec1779b732..3da09369882 100644
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -39,7 +39,6 @@ representing the variable.
39* Buffer-Local Variables:: Variable values in effect only in one buffer. 39* Buffer-Local Variables:: Variable values in effect only in one buffer.
40* File Local Variables:: Handling local variable lists in files. 40* File Local Variables:: Handling local variable lists in files.
41* Directory Local Variables:: Local variables common to all files in a directory. 41* Directory Local Variables:: Local variables common to all files in a directory.
42* Frame-Local Variables:: Frame-local bindings for variables.
43* Variable Aliases:: Variables that are aliases for other variables. 42* Variable Aliases:: Variables that are aliases for other variables.
44* Variables with Restricted Values:: Non-constant variables whose value can 43* Variables with Restricted Values:: Non-constant variables whose value can
45 @emph{not} be an arbitrary Lisp object. 44 @emph{not} be an arbitrary Lisp object.
@@ -1187,8 +1186,7 @@ additional, unusual kinds of variable binding, such as
1187@dfn{buffer-local} bindings, which apply only in one buffer. Having 1186@dfn{buffer-local} bindings, which apply only in one buffer. Having
1188different values for a variable in different buffers is an important 1187different values for a variable in different buffers is an important
1189customization method. (Variables can also have bindings that are 1188customization method. (Variables can also have bindings that are
1190local to each terminal, or to each frame. @xref{Multiple Terminals}, 1189local to each terminal. @xref{Multiple Terminals}.)
1191and @xref{Frame-Local Variables}.)
1192 1190
1193@menu 1191@menu
1194* Intro to Buffer-Local:: Introduction and concepts. 1192* Intro to Buffer-Local:: Introduction and concepts.
@@ -1287,9 +1285,8 @@ buffer-local binding of buffer @samp{b}.
1287values when you visit the file. @xref{File Variables,,, emacs, The 1285values when you visit the file. @xref{File Variables,,, emacs, The
1288GNU Emacs Manual}. 1286GNU Emacs Manual}.
1289 1287
1290 A buffer-local variable cannot be made frame-local 1288 A buffer-local variable cannot be made terminal-local
1291(@pxref{Frame-Local Variables}) or terminal-local (@pxref{Multiple 1289(@pxref{Multiple Terminals}).
1292Terminals}).
1293 1290
1294@node Creating Buffer-Local 1291@node Creating Buffer-Local
1295@subsection Creating and Deleting Buffer-Local Bindings 1292@subsection Creating and Deleting Buffer-Local Bindings
@@ -1340,9 +1337,9 @@ is not current either on entry to or exit from the @code{let}. This is
1340because @code{let} does not distinguish between different kinds of 1337because @code{let} does not distinguish between different kinds of
1341bindings; it knows only which variable the binding was made for. 1338bindings; it knows only which variable the binding was made for.
1342 1339
1343If the variable is terminal-local (@pxref{Multiple Terminals}), or 1340If the variable is terminal-local (@pxref{Multiple Terminals}), this
1344frame-local (@pxref{Frame-Local Variables}), this function signals an 1341function signals an error. Such variables cannot have buffer-local
1345error. Such variables cannot have buffer-local bindings as well. 1342bindings as well.
1346 1343
1347@strong{Warning:} do not use @code{make-local-variable} for a hook 1344@strong{Warning:} do not use @code{make-local-variable} for a hook
1348variable. The hook variables are automatically made buffer-local as 1345variable. The hook variables are automatically made buffer-local as
@@ -1880,36 +1877,6 @@ modification times of the associated directory local variables file
1880updates this list. 1877updates this list.
1881@end defvar 1878@end defvar
1882 1879
1883@node Frame-Local Variables
1884@section Frame-Local Values for Variables
1885@cindex frame-local variables
1886
1887 In addition to buffer-local variable bindings (@pxref{Buffer-Local
1888Variables}), Emacs supports @dfn{frame-local} bindings. A frame-local
1889binding for a variable is in effect in a frame for which it was
1890defined.
1891
1892 In practice, frame-local variables have not proven very useful.
1893Ordinary frame parameters are generally used instead (@pxref{Frame
1894Parameters}). The function @code{make-variable-frame-local}, which
1895was used to define frame-local variables, has been deprecated since
1896Emacs 22.2. However, you can still define a frame-specific binding
1897for a variable @var{var} in frame @var{frame}, by setting the
1898@var{var} frame parameter for that frame:
1899
1900@lisp
1901 (modify-frame-parameters @var{frame} '((@var{var} . @var{value})))
1902@end lisp
1903
1904@noindent
1905This causes the variable @var{var} to be bound to the specified
1906@var{value} in the named @var{frame}. To check the frame-specific
1907values of such variables, use @code{frame-parameter}. @xref{Parameter
1908Access}.
1909
1910 Note that you cannot have a frame-local binding for a variable that
1911has a buffer-local binding.
1912
1913@node Variable Aliases 1880@node Variable Aliases
1914@section Variable Aliases 1881@section Variable Aliases
1915@cindex variable aliases 1882@cindex variable aliases