diff options
| -rw-r--r-- | doc/lispref/ChangeLog | 14 | ||||
| -rw-r--r-- | doc/lispref/display.texi | 4 | ||||
| -rw-r--r-- | doc/lispref/elisp.texi | 1 | ||||
| -rw-r--r-- | doc/lispref/frames.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/variables.texi | 45 |
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 @@ | |||
| 1 | 2011-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 | |||
| 1 | 2011-07-12 Lars Magne Ingebrigtsen <larsi@gnus.org> | 15 | 2011-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 | |||
| 5910 | concerned; the individual Emacs windows are not known to X at all. | 5910 | concerned; the individual Emacs windows are not known to X at all. |
| 5911 | 5911 | ||
| 5912 | @defvar window-system | 5912 | @defvar window-system |
| 5913 | This frame-local variable tells Lisp programs what window system Emacs is using | 5913 | This terminal-local variable tells Lisp programs what window system |
| 5914 | for displaying the frame. The possible values are | 5914 | Emacs 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}, | |||
| 337 | If the terminal supports frame transparency, the parameter | 337 | If 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 | ||
| 341 | variables. @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 | |||
| 374 | parameter. If you don't mention a parameter in @var{alist}, its value | 371 | parameter. If you don't mention a parameter in @var{alist}, its value |
| 375 | doesn't change. If @var{frame} is @code{nil}, it defaults to the selected | 372 | doesn't change. If @var{frame} is @code{nil}, it defaults to the selected |
| 376 | frame. | 373 | frame. |
| 377 | |||
| 378 | You can use this function to define frame-local bindings for | ||
| 379 | variables, 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 |
| 1188 | different values for a variable in different buffers is an important | 1187 | different values for a variable in different buffers is an important |
| 1189 | customization method. (Variables can also have bindings that are | 1188 | customization method. (Variables can also have bindings that are |
| 1190 | local to each terminal, or to each frame. @xref{Multiple Terminals}, | 1189 | local to each terminal. @xref{Multiple Terminals}.) |
| 1191 | and @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}. | |||
| 1287 | values when you visit the file. @xref{File Variables,,, emacs, The | 1285 | values when you visit the file. @xref{File Variables,,, emacs, The |
| 1288 | GNU Emacs Manual}. | 1286 | GNU 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}). |
| 1292 | Terminals}). | ||
| 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 | |||
| 1340 | because @code{let} does not distinguish between different kinds of | 1337 | because @code{let} does not distinguish between different kinds of |
| 1341 | bindings; it knows only which variable the binding was made for. | 1338 | bindings; it knows only which variable the binding was made for. |
| 1342 | 1339 | ||
| 1343 | If the variable is terminal-local (@pxref{Multiple Terminals}), or | 1340 | If the variable is terminal-local (@pxref{Multiple Terminals}), this |
| 1344 | frame-local (@pxref{Frame-Local Variables}), this function signals an | 1341 | function signals an error. Such variables cannot have buffer-local |
| 1345 | error. Such variables cannot have buffer-local bindings as well. | 1342 | bindings 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 |
| 1348 | variable. The hook variables are automatically made buffer-local as | 1345 | variable. The hook variables are automatically made buffer-local as |
| @@ -1880,36 +1877,6 @@ modification times of the associated directory local variables file | |||
| 1880 | updates this list. | 1877 | updates 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 | ||
| 1888 | Variables}), Emacs supports @dfn{frame-local} bindings. A frame-local | ||
| 1889 | binding for a variable is in effect in a frame for which it was | ||
| 1890 | defined. | ||
| 1891 | |||
| 1892 | In practice, frame-local variables have not proven very useful. | ||
| 1893 | Ordinary frame parameters are generally used instead (@pxref{Frame | ||
| 1894 | Parameters}). The function @code{make-variable-frame-local}, which | ||
| 1895 | was used to define frame-local variables, has been deprecated since | ||
| 1896 | Emacs 22.2. However, you can still define a frame-specific binding | ||
| 1897 | for 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 | ||
| 1905 | This causes the variable @var{var} to be bound to the specified | ||
| 1906 | @var{value} in the named @var{frame}. To check the frame-specific | ||
| 1907 | values of such variables, use @code{frame-parameter}. @xref{Parameter | ||
| 1908 | Access}. | ||
| 1909 | |||
| 1910 | Note that you cannot have a frame-local binding for a variable that | ||
| 1911 | has 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 |