[Emacs-diffs] /srv/bzr/emacs/trunk r105137: Remove frame-local vars from Lisp manual; obsolete since Emacs 22.3.

[Chong Yidong]

------------------------------------------------------------
revno: 105137
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Tue 2011-07-12 13:33:18 -0400
message:
  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.
modified:
  doc/lispref/ChangeLog
  doc/lispref/display.texi
  doc/lispref/elisp.texi
  doc/lispref/frames.texi
  doc/lispref/variables.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-07-12 12:50:42 +0000
+++ b/doc/lispref/ChangeLog     2011-07-12 17:33:18 +0000
@@ -1,3 +1,17 @@
+2011-07-12  Chong Yidong  <address@hidden>
+
+       * display.texi (Window Systems): `window-system' is
+       terminal-local.
+
+       * frames.texi (Frame Parameters, Parameter Access): Don't mention
+       frame-local variables.
+
+       * variables.texi (Buffer-Local Variables): Don't mention obsolete
+       frame-local variables.
+       (Frame-Local Variables): Node deleted.
+
+       * elisp.texi (Top): Update node listing.
+
 2011-07-12  Lars Magne Ingebrigtsen  <address@hidden>
 
        * elisp.texi: Change "inferiors" to "subnodes" in three places

=== modified file 'doc/lispref/display.texi'
--- a/doc/lispref/display.texi  2011-07-06 02:42:10 +0000
+++ b/doc/lispref/display.texi  2011-07-12 17:33:18 +0000
@@ -5910,8 +5910,8 @@
 concerned; the individual Emacs windows are not known to X at all.
 
 @defvar window-system
-This frame-local variable tells Lisp programs what window system Emacs is using
-for displaying the frame.  The possible values are
+This terminal-local variable tells Lisp programs what window system
+Emacs is using for displaying the frame.  The possible values are
 
 @table @code
 @item x

=== modified file 'doc/lispref/elisp.texi'
--- a/doc/lispref/elisp.texi    2011-07-12 12:50:42 +0000
+++ b/doc/lispref/elisp.texi    2011-07-12 17:33:18 +0000
@@ -430,7 +430,6 @@
 * File Local Variables::    Handling local variable lists in files.
 * Directory Local Variables:: Local variables common to all files in a
                                 directory.
-* Frame-Local Variables::   Frame-local bindings for variables.
 * Variable Aliases::        Variables that are aliases for other variables.
 * Variables with Restricted Values::  Non-constant variables whose value can
                                         @emph{not} be an arbitrary Lisp object.

=== modified file 'doc/lispref/frames.texi'
--- a/doc/lispref/frames.texi   2011-07-11 18:40:48 +0000
+++ b/doc/lispref/frames.texi   2011-07-12 17:33:18 +0000
@@ -337,9 +337,6 @@
 If the terminal supports frame transparency, the parameter
 @code{alpha} is also meaningful.
 
-  You can use frame parameters to define frame-local bindings for
-variables.  @xref{Frame-Local Variables}.
-
 @menu
 * Parameter Access::       How to change a frame's parameters.
 * Initial Parameters::     Specifying frame parameters when you make a frame.
@@ -374,9 +371,6 @@
 parameter.  If you don't mention a parameter in @var{alist}, its value
 doesn't change.  If @var{frame} is @code{nil}, it defaults to the selected
 frame.
-
-You can use this function to define frame-local bindings for
-variables, see @ref{Frame-Local Variables}.
 @end defun
 
 @defun set-frame-parameter frame parm value

=== modified file 'doc/lispref/variables.texi'
--- a/doc/lispref/variables.texi        2011-07-02 17:18:16 +0000
+++ b/doc/lispref/variables.texi        2011-07-12 17:33:18 +0000
@@ -39,7 +39,6 @@
 * Buffer-Local Variables::      Variable values in effect only in one buffer.
 * File Local Variables::        Handling local variable lists in files.
 * Directory Local Variables::   Local variables common to all files in a 
directory.
-* Frame-Local Variables::       Frame-local bindings for variables.
 * Variable Aliases::            Variables that are aliases for other variables.
 * Variables with Restricted Values::  Non-constant variables whose value can
                                         @emph{not} be an arbitrary Lisp object.
@@ -1187,8 +1186,7 @@
 @dfn{buffer-local} bindings, which apply only in one buffer.  Having
 different values for a variable in different buffers is an important
 customization method.  (Variables can also have bindings that are
-local to each terminal, or to each frame.  @xref{Multiple Terminals},
-and @xref{Frame-Local Variables}.)
+local to each terminal.  @xref{Multiple Terminals}.)
 
 @menu
 * Intro to Buffer-Local::       Introduction and concepts.
@@ -1287,9 +1285,8 @@
 values when you visit the file.  @xref{File Variables,,, emacs, The
 GNU Emacs Manual}.
 
-  A buffer-local variable cannot be made frame-local
-(@pxref{Frame-Local Variables}) or terminal-local (@pxref{Multiple
-Terminals}).
+  A buffer-local variable cannot be made terminal-local
+(@pxref{Multiple Terminals}).
 
 @node Creating Buffer-Local
 @subsection Creating and Deleting Buffer-Local Bindings
@@ -1340,9 +1337,9 @@
 because @code{let} does not distinguish between different kinds of
 bindings; it knows only which variable the binding was made for.
 
-If the variable is terminal-local (@pxref{Multiple Terminals}), or
-frame-local (@pxref{Frame-Local Variables}), this function signals an
-error.  Such variables cannot have buffer-local bindings as well.
+If the variable is terminal-local (@pxref{Multiple Terminals}), this
+function signals an error.  Such variables cannot have buffer-local
+bindings as well.
 
 @strong{Warning:} do not use @code{make-local-variable} for a hook
 variable.  The hook variables are automatically made buffer-local as
@@ -1880,36 +1877,6 @@
 updates this list.
 @end defvar
 
address@hidden Frame-Local Variables
address@hidden Frame-Local Values for Variables
address@hidden frame-local variables
-
-  In addition to buffer-local variable bindings (@pxref{Buffer-Local
-Variables}), Emacs supports @dfn{frame-local} bindings.  A frame-local
-binding for a variable is in effect in a frame for which it was
-defined.
-
-  In practice, frame-local variables have not proven very useful.
-Ordinary frame parameters are generally used instead (@pxref{Frame
-Parameters}).  The function @code{make-variable-frame-local}, which
-was used to define frame-local variables, has been deprecated since
-Emacs 22.2.  However, you can still define a frame-specific binding
-for a variable @var{var} in frame @var{frame}, by setting the
address@hidden frame parameter for that frame:
-
address@hidden
-  (modify-frame-parameters @var{frame} '((@var{var} . @var{value})))
address@hidden lisp
-
address@hidden
-This causes the variable @var{var} to be bound to the specified
address@hidden in the named @var{frame}.  To check the frame-specific
-values of such variables, use @code{frame-parameter}.  @xref{Parameter
-Access}.
-
-  Note that you cannot have a frame-local binding for a variable that
-has a buffer-local binding.
-
 @node Variable Aliases
 @section Variable Aliases
 @cindex variable aliases