view etc/README @ 5142:f965e31a35f0

reduce lcrecord headers to 2 words, rename printing_unreadable_object -------------------- ChangeLog entries follow: -------------------- man/ChangeLog addition: 2010-03-13 Ben Wing <ben@xemacs.org> * internals/internals.texi (Working with Lisp Objects): * internals/internals.texi (Writing Macros): * internals/internals.texi (lrecords): More rewriting to correspond with changes from *LRECORD* to *LISP_OBJECT*. modules/ChangeLog addition: 2010-03-13 Ben Wing <ben@xemacs.org> * postgresql/postgresql.c (print_pgconn): * postgresql/postgresql.c (print_pgresult): printing_unreadable_object -> printing_unreadable_object_fmt. 2010-03-13 Ben Wing <ben@xemacs.org> * ldap/eldap.c (print_ldap): printing_unreadable_object -> printing_unreadable_object_fmt. src/ChangeLog addition: 2010-03-13 Ben Wing <ben@xemacs.org> * alloc.c (alloc_sized_lrecord_1): * alloc.c (alloc_sized_lrecord_array): * alloc.c (old_alloc_sized_lcrecord): * alloc.c (disksave_object_finalization_1): * alloc.c (mark_lcrecord_list): * alloc.c (alloc_managed_lcrecord): * alloc.c (free_managed_lcrecord): * alloc.c (tick_lcrecord_stats): * alloc.c (sweep_lcrecords_1): * buffer.c (print_buffer): * buffer.c (DEFVAR_BUFFER_LOCAL_1): * casetab.c: * casetab.c (print_case_table): * console.c (print_console): * console.c (DEFVAR_CONSOLE_LOCAL_1): * data.c (print_weak_list): * data.c (print_weak_box): * data.c (print_ephemeron): * data.c (ephemeron_equal): * database.c (print_database): * database.c (finalize_database): * device-msw.c (sync_printer_with_devmode): * device-msw.c (print_devmode): * device-msw.c (finalize_devmode): * device.c: * device.c (print_device): * elhash.c: * elhash.c (print_hash_table): * eval.c (print_subr): * eval.c (print_multiple_value): * event-stream.c (event_stream_resignal_wakeup): * events.c (clear_event_resource): * events.c (zero_event): * events.c (print_event): * extents.c: * extents.c (print_extent): * file-coding.c (print_coding_system): * font-mgr.c: * font-mgr.c (Ffc_init): * frame.c: * frame.c (print_frame): * gc.c: * gc.c (GC_CHECK_NOT_FREE): * glyphs.c: * glyphs.c (print_image_instance): * glyphs.c (print_glyph): * gui.c (print_gui_item): * gui.c (copy_gui_item): * keymap.c (print_keymap): * keymap.c (MARKED_SLOT): * lisp.h: * lisp.h (struct Lisp_String): * lisp.h (DEFUN): * lisp.h (DEFUN_NORETURN): * lrecord.h: * lrecord.h (NORMAL_LISP_OBJECT_UID): * lrecord.h (struct lrecord_header): * lrecord.h (set_lheader_implementation): * lrecord.h (struct old_lcrecord_header): * lrecord.h (struct free_lcrecord_header): * marker.c (print_marker): * mule-charset.c: * mule-charset.c (print_charset): * objects.c (print_color_instance): * objects.c (print_font_instance): * objects.c (finalize_font_instance): * print.c (print_cons): * print.c (printing_unreadable_object_fmt): * print.c (printing_unreadable_lisp_object): * print.c (external_object_printer): * print.c (internal_object_printer): * print.c (debug_p4): * print.c (ext_print_begin): * process.c (print_process): * rangetab.c (print_range_table): * rangetab.c (range_table_equal): * scrollbar.c (free_scrollbar_instance): * specifier.c (print_specifier): * specifier.c (finalize_specifier): * symbols.c (guts_of_unbound_marker): * symeval.h: * symeval.h (DEFVAR_SYMVAL_FWD): * tooltalk.c: * tooltalk.c (print_tooltalk_message): * tooltalk.c (print_tooltalk_pattern): * ui-gtk.c (ffi_object_printer): * ui-gtk.c (emacs_gtk_object_printer): * ui-gtk.c (emacs_gtk_boxed_printer): * window.c (print_window): * window.c (free_window_mirror): * window.c (debug_print_window): * xemacs.def.in.in: (1) printing_unreadable_object -> printing_unreadable_object_fmt. (2) printing_unreadable_lcrecord -> printing_unreadable_lisp_object and fix up so it no longer requires an lcrecord. These previous changes eliminate most of the remaining places where the terms `lcrecord' and `lrecord' occurred outside of specialized code. (3) Fairly major change: Reduce the number of words in an lcrecord from 3 to 2. The third word consisted of a uid that duplicated the lrecord uid, and a single free bit, which was moved into the lrecord structure. This reduces the size of the `uid' slot from 21 bits to 20 bits. Arguably this isn't enough -- we could easily have more than 1,000,000 or so objects created in a session. The answer is (a) It doesn't really matter if we overflow the uid field because it's only used for debugging, to identify an object uniquely (or pretty much so). (b) If we cared about it overflowing and wanted to reduce this, we could make it so that cons, string, float and certain other frob-block types that never print out the uid simply don't store a uid in them and don't increment the lrecord_uid_counter. (4) In conjunction with (3), create new macro NORMAL_LISP_OBJECT_UID() and use it to abstract out the differences between NEWGC and old-GC in accessing the `uid' value from a "normal Lisp Object pointer". (5) In events.c, use zero_nonsized_lisp_object() in place of custom- written equivalent. In font-mgr.c use external_object_printer() in place of custom-written equivalents.
author Ben Wing <ben@xemacs.org>
date Sat, 13 Mar 2010 05:38:08 -0600
parents a883e09e54f7
children
line wrap: on
line source


This directory contains some text files of documentation for XEmacs or
of interest to XEmacs users, some programs used by or with XEmacs, and
the file of on-line documentation for XEmacs.

COPYING			GNU Public License
ChangeLog		ChangeLog for etc/
ETAGS.EBNF              Description of TAGS file format
Emacs.ad		Sample Resource file
HELLO			Hello in many languages (Mule test file)
InstallGuide		Fast track to installation
NEWS			XEmacs 21.5 release information
ONEWS			Older release information
OONEWS			Even older release information
README			This file
TUTORIAL		Tutorial for first time users (English version)
TUTORIAL.*		Tutorials in non-English languages
VEGETABLES		XEmacs 21.5 code names
XKeysymDB		X Keysym Database with Motif bindings
cbx.png			"Created by XEmacs" logo (150x54 8bpp)
ctags.1			Ctags man page
custom/			Images used in Custom mode
editclient.sh		Either start up XEmacs or connect to a running one
emacskeys.sco		
emacsstrs.sco		Special files for running on an SCO console
eos/			Images for EOS support (GUD)
etags.1			Etags man page
gnuattach.1		Gnuattach man page
gnuclient.1		Gnuclient man page
gnudoit.1		Gnudoit man page
gnuserv.1		Gnuserv man page
gnuserv.README		Original README file from gnuserv
gray1.xbm		Halftone gray bitmap (16x16)
idd/			?
package-index.LATEST.gpg ?
photos/*		Various pictures of XEmacs developers
recycle.xpm		Chartreuse recycle cursor (51x51)
recycle2.xpm		Chartreuse recycle cursor (32x32)
refcard.ps.gz		Postscript version of XEmacs reference card
refcard.tex		XEmacs reference card
sample.Xdefaults	(legacy -- to be removed)
sample.Xresources	Example ~/.Xresources file
sample.init.el		Example ~/.xemacs/init.el file
sparcworks/		Support files for Sparcworks
tests/			Testcases for external widget
toolbar/		Image files for the toolbar
trash.xpm		B&W garbage can icon (32x46)
unicode/		Unicode conversion tables
xemacs-X-16.png		Violet boxed X icon (16x16)
xemacs-X-32.png		Violet boxed X icon (32x32)
xemacs-X.ico		Violet boxed X icon in MS Windows format
xemacs-beta.xpm		XEmacs Beta logo for splashscreen (388x145)
xemacs-enhanced.png	"XEmacs-enhanced" logo (90x32)
xemacs-fe.sh		XEmacs frontend driver
xemacs-icon.xpm		Color XE on page icon (48x48)
xemacs-icon2.xbm	B&W kitchen sink icon (50x50)
xemacs-icon2.xpm	Color kitchen sink icon (50x50)
xemacs-icon3.xpm	Grayscale X icon (48x48)
xemacs.1		XEmacs man page
xemacs.xbm		Half-tone XEmacs logo (266x61)
xemacs.xpm		XEmacs logo for splashscreen (388x145)