annotate etc/README @ 5146:88bd4f3ef8e4

make lrecord UID's have a separate UID space for each object, resurrect debug SOE code in extents.c -------------------- ChangeLog entries follow: -------------------- src/ChangeLog addition: 2010-03-15 Ben Wing <ben@xemacs.org> * alloc.c: * alloc.c (c_readonly): * alloc.c (deadbeef_memory): * alloc.c (make_compiled_function): * alloc.c (make_button_data): * alloc.c (make_motion_data): * alloc.c (make_process_data): * alloc.c (make_timeout_data): * alloc.c (make_magic_data): * alloc.c (make_magic_eval_data): * alloc.c (make_eval_data): * alloc.c (make_misc_user_data): * alloc.c (noseeum_make_marker): * alloc.c (ADDITIONAL_FREE_string): * alloc.c (common_init_alloc_early): * alloc.c (init_alloc_once_early): * bytecode.c (print_compiled_function): * bytecode.c (mark_compiled_function): * casetab.c: * casetab.c (print_case_table): * console.c: * console.c (print_console): * 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_multiple_value): * eval.c (mark_multiple_value): * events.c (deinitialize_event): * events.c (print_event): * events.c (event_equal): * extents.c: * extents.c (soe_dump): * extents.c (soe_insert): * extents.c (soe_delete): * extents.c (soe_move): * extents.c (extent_fragment_update): * extents.c (print_extent_1): * extents.c (print_extent): * extents.c (vars_of_extents): * frame.c: * frame.c (print_frame): * free-hook.c: * free-hook.c (check_free): * glyphs.c: * glyphs.c (print_image_instance): * glyphs.c (print_glyph): * gui.c: * gui.c (copy_gui_item): * hash.c: * hash.c (NULL_ENTRY): * hash.c (KEYS_DIFFER_P): * keymap.c (print_keymap): * keymap.c (MARKED_SLOT): * lisp.h: * lrecord.h: * lrecord.h (LISP_OBJECT_UID): * lrecord.h (set_lheader_implementation): * lrecord.h (struct old_lcrecord_header): * lstream.c (print_lstream): * lstream.c (finalize_lstream): * marker.c (print_marker): * marker.c (marker_equal): * mc-alloc.c (visit_all_used_page_headers): * mule-charset.c: * mule-charset.c (print_charset): * objects.c (print_color_instance): * objects.c (print_font_instance): * objects.c (finalize_font_instance): * opaque.c (print_opaque): * opaque.c (print_opaque_ptr): * opaque.c (equal_opaque_ptr): * print.c (internal_object_printer): * print.c (enum printing_badness): * rangetab.c (print_range_table): * rangetab.c (range_table_equal): * specifier.c (print_specifier): * specifier.c (finalize_specifier): * symbols.c: * symbols.c (print_symbol_value_magic): * tooltalk.c: * tooltalk.c (print_tooltalk_message): * tooltalk.c (print_tooltalk_pattern): * window.c (print_window): * window.c (debug_print_window): (1) Make lrecord UID's have a separate UID space for each object. Otherwise, with 20-bit UID's, we rapidly wrap around, especially when common objects like conses and strings increment the UID value for every object created. (Originally I tried making two UID spaces, one for objects that always print readably and hence don't display the UID, and one for other objects. But certain objects like markers for which a UID is displayed are still generated rapidly enough that UID overflow is a serious issue.) This also has the advantage of making UID values smaller, hence easier to remember -- their main purpose is to make it easier to keep track of different objects of the same type when debugging code. Make sure we dump lrecord UID's so that we don't have problems with pdumped and non-dumped objects having the same UID. (2) Display UID's consistently whenever an object (a) doesn't consistently print readably (objects like cons and string, which always print readably, can't display a UID), and (b) doesn't otherwise have a unique property that makes objects of a particular type distinguishable. (E.g. buffers didn't and still don't print an ID, but the buffer name uniquely identifies the buffer.) Some types, such as event, extent, compiled-function, didn't always (or didn't ever) display an ID; others (such as marker, extent, lstream, opaque, opaque-ptr, any object using internal_object_printer()) used to display the actual machine pointer instead. (3) Rename NORMAL_LISP_OBJECT_UID to LISP_OBJECT_UID; make it work over all Lisp objects and take a Lisp object, not a struct pointer. (4) Some misc cleanups in alloc.c, elhash.c. (5) Change code in events.c that "deinitializes" an event so that it doesn't increment the event UID counter in the process. Also use deadbeef_memory() to overwrite memory instead of doing the same with custom code. In the process, make deadbeef_memory() in alloc.c always available, and delete extraneous copy in mc-alloc.c. Also capitalize all uses of 0xDEADBEEF. Similarly in elhash.c call deadbeef_memory(). (6) Resurrect "debug SOE" code in extents.c. Make it conditional on DEBUG_XEMACS and on a `debug-soe' variable, rather than on SOE_DEBUG. Make it output to stderr, not stdout. (7) Delete some custom print methods that were identical to external_object_printer().
author Ben Wing <ben@xemacs.org>
date Mon, 15 Mar 2010 16:35:38 -0500
parents a883e09e54f7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2 This directory contains some text files of documentation for XEmacs or
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3 of interest to XEmacs users, some programs used by or with XEmacs, and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4 the file of on-line documentation for XEmacs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
5
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
6 COPYING GNU Public License
2537
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
7 ChangeLog ChangeLog for etc/
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
8 ETAGS.EBNF Description of TAGS file format
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
9 Emacs.ad Sample Resource file
2537
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
10 HELLO Hello in many languages (Mule test file)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
11 InstallGuide Fast track to installation
2537
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
12 NEWS XEmacs 21.5 release information
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
13 ONEWS Older release information
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
14 OONEWS Even older release information
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
15 README This file
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
16 TUTORIAL Tutorial for first time users (English version)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
17 TUTORIAL.* Tutorials in non-English languages
2537
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
18 VEGETABLES XEmacs 21.5 code names
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
19 XKeysymDB X Keysym Database with Motif bindings
4428
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
20 cbx.png "Created by XEmacs" logo (150x54 8bpp)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
21 ctags.1 Ctags man page
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
22 custom/ Images used in Custom mode
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
23 editclient.sh Either start up XEmacs or connect to a running one
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24 emacskeys.sco
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
25 emacsstrs.sco Special files for running on an SCO console
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26 eos/ Images for EOS support (GUD)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
27 etags.1 Etags man page
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
28 gnuattach.1 Gnuattach man page
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
29 gnuclient.1 Gnuclient man page
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
30 gnudoit.1 Gnudoit man page
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31 gnuserv.1 Gnuserv man page
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 gnuserv.README Original README file from gnuserv
4428
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
33 gray1.xbm Halftone gray bitmap (16x16)
2537
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
34 idd/ ?
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
35 package-index.LATEST.gpg ?
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
36 photos/* Various pictures of XEmacs developers
4428
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
37 recycle.xpm Chartreuse recycle cursor (51x51)
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
38 recycle2.xpm Chartreuse recycle cursor (32x32)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
39 refcard.ps.gz Postscript version of XEmacs reference card
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
40 refcard.tex XEmacs reference card
1389
6355bae896e3 [xemacs-hg @ 2003-03-27 12:57:36 by stephent]
stephent
parents: 462
diff changeset
41 sample.Xdefaults (legacy -- to be removed)
6355bae896e3 [xemacs-hg @ 2003-03-27 12:57:36 by stephent]
stephent
parents: 462
diff changeset
42 sample.Xresources Example ~/.Xresources file
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
43 sample.init.el Example ~/.xemacs/init.el file
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
44 sparcworks/ Support files for Sparcworks
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
45 tests/ Testcases for external widget
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
46 toolbar/ Image files for the toolbar
4428
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
47 trash.xpm B&W garbage can icon (32x46)
2537
b7b90f750a78 [xemacs-hg @ 2005-01-31 20:08:32 by ben]
ben
parents: 1389
diff changeset
48 unicode/ Unicode conversion tables
4429
a883e09e54f7 Add Dan Polansky's icons. <87ejayxrsm.fsf@uwakimon.sk.tsukuba.ac.jp>
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4428
diff changeset
49 xemacs-X-16.png Violet boxed X icon (16x16)
a883e09e54f7 Add Dan Polansky's icons. <87ejayxrsm.fsf@uwakimon.sk.tsukuba.ac.jp>
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4428
diff changeset
50 xemacs-X-32.png Violet boxed X icon (32x32)
a883e09e54f7 Add Dan Polansky's icons. <87ejayxrsm.fsf@uwakimon.sk.tsukuba.ac.jp>
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4428
diff changeset
51 xemacs-X.ico Violet boxed X icon in MS Windows format
4428
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
52 xemacs-beta.xpm XEmacs Beta logo for splashscreen (388x145)
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
53 xemacs-enhanced.png "XEmacs-enhanced" logo (90x32)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
54 xemacs-fe.sh XEmacs frontend driver
4428
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
55 xemacs-icon.xpm Color XE on page icon (48x48)
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
56 xemacs-icon2.xbm B&W kitchen sink icon (50x50)
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
57 xemacs-icon2.xpm Color kitchen sink icon (50x50)
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
58 xemacs-icon3.xpm Grayscale X icon (48x48)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
59 xemacs.1 XEmacs man page
4428
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
60 xemacs.xbm Half-tone XEmacs logo (266x61)
a2954f0b7507 Improve etc/README.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 2537
diff changeset
61 xemacs.xpm XEmacs logo for splashscreen (388x145)