Mercurial > hg > xemacs-beta
annotate man/lispref/databases.texi @ 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 | 576fb035e263 |
| children | 9fae6227ede5 |
| rev | line source |
|---|---|
| 428 | 1 @c -*-texinfo-*- |
| 2 @c This is part of the XEmacs Lisp Reference Manual. | |
| 3 @c Copyright (C) 1996 Ben Wing. | |
| 4 @c See the file lispref.texi for copying conditions. | |
| 5 @setfilename ../../info/databases.info | |
| 6 @node Databases, Processes, Range Tables, top | |
| 7 @chapter Databases | |
| 8 @cindex database | |
| 9 | |
| 10 @defun databasep object | |
| 11 This function returns non-@code{nil} if @var{object} is a database. | |
| 12 @end defun | |
| 13 | |
| 14 @menu | |
| 15 * Connecting to a Database:: | |
| 16 * Working With a Database:: | |
| 17 * Other Database Functions:: | |
| 18 @end menu | |
| 19 | |
| 20 @node Connecting to a Database | |
| 21 @section Connecting to a Database | |
| 22 | |
| 23 @defun open-database file &optional type subtype access mode | |
| 24 This function opens database @var{file}, using database method | |
| 25 @var{type} and @var{subtype}, with access rights @var{access} and | |
| 26 permissions @var{mode}. @var{access} can be any combination of @code{r} | |
| 27 @code{w} and @code{+}, for read, write, and creation flags. | |
| 28 | |
| 442 | 29 @var{type} can have the value @code{'dbm} or @code{'berkeley-db} to |
| 428 | 30 select the type of database file to use. (Note: XEmacs may not |
| 31 support both of these types.) | |
| 32 | |
| 33 For a @var{type} of @code{'dbm}, there are no subtypes, so | |
| 442 | 34 @var{subtype} should be @code{nil}. |
| 428 | 35 |
| 442 | 36 For a @var{type} of @code{'berkeley-db}, the following subtypes are |
| 428 | 37 available: @code{'hash}, @code{'btree}, and @code{'recno}. See the |
| 444 | 38 manpages for the Berkeley DB functions for more information about these |
| 428 | 39 types. |
| 40 @end defun | |
| 41 | |
| 444 | 42 @defun close-database database |
| 43 This function closes database @var{database}. | |
| 428 | 44 @end defun |
| 45 | |
| 444 | 46 @defun database-live-p object |
| 47 This function returns @code{t} if @var{object} is an active database, else | |
| 428 | 48 @code{nil}. |
| 49 @end defun | |
| 50 | |
| 51 @node Working With a Database | |
| 52 @section Working With a Database | |
| 53 | |
| 444 | 54 @defun get-database key database &optional default |
| 428 | 55 This function finds the value for @var{key} in @var{database}. If there is no |
| 56 corresponding value, @var{default} is returned (@code{nil} if @var{default} is | |
| 57 omitted). | |
| 58 @end defun | |
| 59 | |
| 444 | 60 @defun map-database function database |
| 428 | 61 This function maps @var{function} over entries in @var{database}, |
| 62 calling it with two args, each key and value in the database. | |
| 63 @end defun | |
| 64 | |
| 444 | 65 @defun put-database key value database &optional replace |
| 66 This function stores @var{key} and @var{value} in @var{database}. | |
| 67 If optional fourth arg @var{replace} is non-@code{nil}, replace any | |
| 428 | 68 existing entry in the database. |
| 69 @end defun | |
| 70 | |
| 444 | 71 @defun remove-database key database |
| 428 | 72 This function removes @var{key} from @var{database}. |
| 73 @end defun | |
| 74 | |
| 75 @node Other Database Functions | |
| 76 @section Other Database Functions | |
| 77 | |
| 444 | 78 @defun database-file-name database |
| 79 This function returns the filename associated with @var{database}. | |
| 428 | 80 @end defun |
| 81 | |
| 444 | 82 @defun database-last-error &optional database |
| 83 This function returns the last error associated with @var{database}. | |
| 428 | 84 @end defun |
| 85 | |
| 444 | 86 @defun database-subtype database |
| 87 This function returns the subtype of @var{database}, if any. | |
| 428 | 88 @end defun |
| 89 | |
| 444 | 90 @defun database-type database |
| 91 This function returns the type of @var{database}. | |
| 428 | 92 @end defun |