view doc/lispref/elisp-covers.texi @ 107984:bef5d1738c0b

Make variable forwarding explicit rather the using special values. Basically, this makes the structure of buffer-local values and object forwarding explicit in the type of Lisp_Symbols rather than use special Lisp_Objects for that. This tends to lead to slightly more verbose code, but is more C-like, simpler, and makes it easier to make sure we handled all cases, among other things by letting the compiler help us check it. * lisp.h (enum Lisp_Misc_Type, union Lisp_Misc): Removing forwarding objects. (enum Lisp_Fwd_Type, enum symbol_redirect, union Lisp_Fwd): New types. (struct Lisp_Symbol): Make the various forms of variable-forwarding explicit rather than hiding them inside Lisp_Object "values". (XFWDTYPE): New macro. (XINTFWD, XBOOLFWD, XOBJFWD, XKBOARD_OBJFWD): Redefine. (XBUFFER_LOCAL_VALUE): Remove. (SYMBOL_VAL, SYMBOL_ALIAS, SYMBOL_BLV, SYMBOL_FWD, SET_SYMBOL_VAL) (SET_SYMBOL_ALIAS, SET_SYMBOL_BLV, SET_SYMBOL_FWD): New macros. (SYMBOL_VALUE, SET_SYMBOL_VALUE): Remove. (struct Lisp_Intfwd, struct Lisp_Boolfwd, struct Lisp_Objfwd) (struct Lisp_Buffer_Objfwd, struct Lisp_Kboard_Objfwd): Remove the Lisp_Misc_* header. (struct Lisp_Buffer_Local_Value): Redefine. (BLV_FOUND, SET_BLV_FOUND, BLV_VALUE, SET_BLV_VALUE): New macros. (struct Lisp_Misc_Any): Add filler to get the right size. (struct Lisp_Free): Use struct Lisp_Misc_Any rather than struct Lisp_Intfwd. (DEFVAR_LISP, DEFVAR_LISP_NOPRO, DEFVAR_BOOL, DEFVAR_INT) (DEFVAR_KBOARD): Allocate a forwarding object. * data.c (do_blv_forwarding, store_blv_forwarding): New macros. (let_shadows_global_binding_p): New function. (union Lisp_Val_Fwd): New type. (make_blv): New function. (swap_in_symval_forwarding, indirect_variable, do_symval_forwarding) (store_symval_forwarding, swap_in_global_binding, Fboundp) (swap_in_symval_forwarding, find_symbol_value, Fset) (let_shadows_buffer_binding_p, set_internal, default_value) (Fset_default, Fmake_variable_buffer_local, Fmake_local_variable) (Fkill_local_variable, Fmake_variable_frame_local) (Flocal_variable_p, Flocal_variable_if_set_p) (Fvariable_binding_locus): * xdisp.c (select_frame_for_redisplay): * lread.c (Fintern, Funintern, init_obarray, defvar_int) (defvar_bool, defvar_lisp_nopro, defvar_lisp, defvar_kboard): * frame.c (store_frame_param): * eval.c (Fdefvaralias, Fuser_variable_p, specbind, unbind_to): * bytecode.c (Fbyte_code) <varref, varset>: Adapt to the new symbol value structure. * buffer.c (PER_BUFFER_SYMBOL): Move from buffer.h. (clone_per_buffer_values): Only adjust markers into the current buffer. (reset_buffer_local_variables): PER_BUFFER_IDX is never -2. (Fbuffer_local_value, set_buffer_internal_1) (swap_out_buffer_local_variables): Adapt to the new symbol value structure. (DEFVAR_PER_BUFFER): Allocate a Lisp_Buffer_Objfwd object. (defvar_per_buffer): Take a new arg for the fwd object. (buffer_lisp_local_variables): Return a proper alist (different fix for bug#4138). * alloc.c (Fmake_symbol): Use SET_SYMBOL_VAL. (Fgarbage_collect): Don't handle buffer_defaults specially. (mark_object): Handle new symbol value structure rather than the old special Lisp_Misc_* objects. (gc_sweep) <symbols>: Free also the buffer-local-value objects. * term.c (set_tty_color_mode): * bidi.c (bidi_initialize): Don't access the ->value field directly. * buffer.h (PER_BUFFER_VAR_OFFSET): Don't bother with a buffer_local_flags. * print.c (print_object): Get rid of impossible forwarding objects.

\input texinfo    @c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
@c Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
@c   Free Software Foundation, Inc.
@c See the file elisp.texi for copying conditions.
@c
@comment %**start of header
@setfilename covers.info
@settitle GNU Emacs Lisp Reference Manual
@comment %**end of header

@titlepage
@c ================ Volume 1 ================
@w{ }
@sp 2
@center @titlefont{The}
@sp 1
@center @titlefont{GNU}
@sp 1
@center @titlefont{Emacs Lisp}
@sp 1
@center @titlefont{Reference}
@sp 1
@center @titlefont{Manual}
@sp 2
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 2
@center @titlefont{Volume 1}
@sp 2
@center by Bil Lewis, Dan LaLiberte,
@center and the GNU Manual Group

@page
@c ================ Volume 2 ================
@w{ }
@sp 5
@center @titlefont{The}
@sp 1
@center @titlefont{GNU}
@sp 1
@center @titlefont{Emacs Lisp}
@sp 1
@center @titlefont{Reference}
@sp 1
@center @titlefont{Manual}
@sp 2
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 2
@center @titlefont{Volume 2}
@sp 2
@center by Bil Lewis,
@center Dan LaLiberte, and
@center the GNU Manual Group

@page
@c ================ Volume 1 with baseline skip 16pt ================

@tex
\global\baselineskip = 16pt
@end tex

16 pts baseline skip:

@w{ }
@sp 2
@center @titlefont{The}
@sp 1
@center @titlefont{GNU}
@sp 1
@center @titlefont{Emacs Lisp}
@sp 1
@center @titlefont{Reference}
@sp 1
@center @titlefont{Manual}
@sp 2
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 2
@center @titlefont{Volume 1}
@sp 2
@center by Bil Lewis, Dan LaLiberte,
@center and the GNU Manual Group

@page
@c ================ Volume 1 with baseline skip 18pt ================

@tex
\global\baselineskip = 18pt
@end tex

18 pts baseline skip, with 15pts  between sections

@w{ }
@sp 2
@center @titlefont{The}
@sp 1
@center @titlefont{GNU}
@sp 1
@center @titlefont{Emacs Lisp}
@sp 1
@center @titlefont{Reference}
@sp 1
@center @titlefont{Manual}
@tex
\global\baselineskip = 15pt
@end tex

@sp 2
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 2
@center @titlefont{Volume 1}
@sp 2
@center by Bil Lewis,
@center Dan LaLiberte, and
@center the GNU Manual Group

@page
@c ================ Volume 1 with more baseline skip 24 pts ================

@tex
\global\baselineskip = 24pt
@end tex

24 pts baseline skip:

@w{ }
@sp 2
@center @titlefont{The}
@sp 1
@center @titlefont{GNU}
@sp 1
@center @titlefont{Emacs Lisp}
@sp 1
@center @titlefont{Reference}
@sp 1
@center @titlefont{Manual}
@sp 2
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 2
@center @titlefont{Volume 1}
@sp 2
@center by Bil Lewis, Dan LaLiberte,
@center and the GNU Manual Group

@page
@c ================ Volume 2 with more baseline skip 18 pts ================

@tex
\global\baselineskip = 18pt
@end tex

18 pts baseline skip:

@w{ }
@sp 5
@center @titlefont{The}
@sp 1
@center @titlefont{GNU}
@sp 1
@center @titlefont{Emacs Lisp}
@sp 1
@center @titlefont{Reference}
@sp 1
@center @titlefont{Manual}
@sp 2
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 2
@center @titlefont{Volume 2}
@sp 2
@center by Bil Lewis, Dan LaLiberte,
@center and the GNU Manual Group

@page
@c ================ Volume 2 with more baseline skip 24 pts ================

@tex
\global\baselineskip = 24pt
@end tex

24 pts baseline skip:

@w{ }
@sp 5
@center @titlefont{The}
@sp 1
@center @titlefont{GNU}
@sp 1
@center @titlefont{Emacs Lisp}
@sp 1
@center @titlefont{Reference}
@sp 1
@center @titlefont{Manual}
@sp 2
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 2
@center @titlefont{Volume 2}
@sp 2
@center by Bil Lewis, Dan LaLiberte,
@center and the GNU Manual Group


@page
@c ================  Spine 1 ================

@w{@titlefont{The GNU Emacs Lisp Reference Manual --- Vol. 1}}
@sp 4
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 4
@center by Bil Lewis, Dan LaLiberte,
@center and the GNU Manual Group

@sp 4
@author The GNU Emacs Lisp Reference Manual --- Vol. 1
@sp 3
@author FSF

@author

@page
@c ================  Spine 2 ================

@w{@titlefont{The GNU Emacs Lisp Reference Manual --- Vol. 2}}
@sp 4
@center GNU Emacs Version 19
@center for Unix Users
@center Edition 2.3, June 1994
@sp 4
@center by Bil Lewis, Dan LaLiberte,
@center and the GNU Manual Group


@sp 4
@author The GNU Emacs Lisp Reference Manual --- Vol. 2
@sp 3
@author FSF

@end titlepage
@bye

@ignore
   arch-tag: 02d65d63-3b64-49bc-a5c0-bfd5eabb6c98
@end ignore