* src/lisp.h (struct Lisp_Buffer_Local_Value): Update commentary.

This commit is contained in:
Noam Postavsky 2018-03-23 04:51:53 -04:00
parent 8c92a37cb4
commit b8ebf5fb64

View file

@ -2593,13 +2593,12 @@ struct Lisp_Buffer_Objfwd
variable, you must first make sure the right binding is loaded;
then you can access the value in (or through) `realvalue'.
`buffer' and `frame' are the buffer and frame for which the loaded
binding was found. If those have changed, to make sure the right
binding is loaded it is necessary to find which binding goes with
the current buffer and selected frame, then load it. To load it,
first unload the previous binding, then copy the value of the new
binding into `realvalue' (or through it). Also update
LOADED-BINDING to point to the newly loaded binding.
`where' is the buffer for which the loaded binding was found. If
it has changed, to make sure the right binding is loaded it is
necessary to find which binding goes with the current buffer, then
load it. To load it, first unload the previous binding, then copy
the value of the new binding into `realvalue' (or through it).
Also update LOADED-BINDING to point to the newly loaded binding.
`local_if_set' indicates that merely setting the variable creates a
local binding for the current buffer. Otherwise the latter, setting
@ -2615,14 +2614,14 @@ struct Lisp_Buffer_Local_Value
bool_bf found : 1;
/* If non-NULL, a forwarding to the C var where it should also be set. */
union Lisp_Fwd *fwd; /* Should never be (Buffer|Kboard)_Objfwd. */
/* The buffer or frame for which the loaded binding was found. */
/* The buffer for which the loaded binding was found. */
Lisp_Object where;
/* A cons cell that holds the default value. It has the form
(SYMBOL . DEFAULT-VALUE). */
Lisp_Object defcell;
/* The cons cell from `where's parameter alist.
It always has the form (SYMBOL . VALUE)
Note that if `forward' is non-nil, VALUE may be out of date.
Note that if `fwd' is non-NULL, VALUE may be out of date.
Also if the currently loaded binding is the default binding, then
this is `eq'ual to defcell. */
Lisp_Object valcell;