Mercurial > hg > xemacs-beta
annotate lisp/obsolete.el @ 5127:a9c41067dd88 ben-lisp-object
more cleanups, terminology clarification, lots of doc work
-------------------- ChangeLog entries follow: --------------------
man/ChangeLog addition:
2010-03-05 Ben Wing <ben@xemacs.org>
* internals/internals.texi (Introduction to Allocation):
* internals/internals.texi (Integers and Characters):
* internals/internals.texi (Allocation from Frob Blocks):
* internals/internals.texi (lrecords):
* internals/internals.texi (Low-level allocation):
Rewrite section on allocation of Lisp objects to reflect the new
reality. Remove references to nonexistent XSETINT and XSETCHAR.
modules/ChangeLog addition:
2010-03-05 Ben Wing <ben@xemacs.org>
* postgresql/postgresql.c (allocate_pgconn):
* postgresql/postgresql.c (allocate_pgresult):
* postgresql/postgresql.h (struct Lisp_PGconn):
* postgresql/postgresql.h (struct Lisp_PGresult):
* ldap/eldap.c (allocate_ldap):
* ldap/eldap.h (struct Lisp_LDAP):
Same changes as in src/ dir. See large log there in ChangeLog,
but basically:
ALLOC_LISP_OBJECT -> ALLOC_NORMAL_LISP_OBJECT
LISP_OBJECT_HEADER -> NORMAL_LISP_OBJECT_HEADER
../hlo/src/ChangeLog addition:
2010-03-05 Ben Wing <ben@xemacs.org>
* alloc.c:
* alloc.c (old_alloc_sized_lcrecord):
* alloc.c (very_old_free_lcrecord):
* alloc.c (copy_lisp_object):
* alloc.c (zero_sized_lisp_object):
* alloc.c (zero_nonsized_lisp_object):
* alloc.c (lisp_object_storage_size):
* alloc.c (free_normal_lisp_object):
* alloc.c (FREE_FIXED_TYPE_WHEN_NOT_IN_GC):
* alloc.c (ALLOC_FROB_BLOCK_LISP_OBJECT):
* alloc.c (Fcons):
* alloc.c (noseeum_cons):
* alloc.c (make_float):
* alloc.c (make_bignum):
* alloc.c (make_bignum_bg):
* alloc.c (make_ratio):
* alloc.c (make_ratio_bg):
* alloc.c (make_ratio_rt):
* alloc.c (make_bigfloat):
* alloc.c (make_bigfloat_bf):
* alloc.c (size_vector):
* alloc.c (make_compiled_function):
* alloc.c (Fmake_symbol):
* alloc.c (allocate_extent):
* alloc.c (allocate_event):
* alloc.c (make_key_data):
* 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 (Fmake_marker):
* alloc.c (noseeum_make_marker):
* alloc.c (size_string_direct_data):
* alloc.c (make_uninit_string):
* alloc.c (make_string_nocopy):
* alloc.c (mark_lcrecord_list):
* alloc.c (alloc_managed_lcrecord):
* alloc.c (free_managed_lcrecord):
* alloc.c (sweep_lcrecords_1):
* alloc.c (malloced_storage_size):
* buffer.c (allocate_buffer):
* buffer.c (compute_buffer_usage):
* buffer.c (DEFVAR_BUFFER_LOCAL_1):
* buffer.c (nuke_all_buffer_slots):
* buffer.c (common_init_complex_vars_of_buffer):
* buffer.h (struct buffer_text):
* buffer.h (struct buffer):
* bytecode.c:
* bytecode.c (make_compiled_function_args):
* bytecode.c (size_compiled_function_args):
* bytecode.h (struct compiled_function_args):
* casetab.c (allocate_case_table):
* casetab.h (struct Lisp_Case_Table):
* charset.h (struct Lisp_Charset):
* chartab.c (fill_char_table):
* chartab.c (Fmake_char_table):
* chartab.c (make_char_table_entry):
* chartab.c (copy_char_table_entry):
* chartab.c (Fcopy_char_table):
* chartab.c (put_char_table):
* chartab.h (struct Lisp_Char_Table_Entry):
* chartab.h (struct Lisp_Char_Table):
* console-gtk-impl.h (struct gtk_device):
* console-gtk-impl.h (struct gtk_frame):
* console-impl.h (struct console):
* console-msw-impl.h (struct Lisp_Devmode):
* console-msw-impl.h (struct mswindows_device):
* console-msw-impl.h (struct msprinter_device):
* console-msw-impl.h (struct mswindows_frame):
* console-msw-impl.h (struct mswindows_dialog_id):
* console-stream-impl.h (struct stream_console):
* console-stream.c (stream_init_console):
* console-tty-impl.h (struct tty_console):
* console-tty-impl.h (struct tty_device):
* console-tty.c (allocate_tty_console_struct):
* console-x-impl.h (struct x_device):
* console-x-impl.h (struct x_frame):
* console.c (allocate_console):
* console.c (nuke_all_console_slots):
* console.c (DEFVAR_CONSOLE_LOCAL_1):
* console.c (common_init_complex_vars_of_console):
* data.c (make_weak_list):
* data.c (make_weak_box):
* data.c (make_ephemeron):
* database.c:
* database.c (struct Lisp_Database):
* database.c (allocate_database):
* database.c (finalize_database):
* device-gtk.c (allocate_gtk_device_struct):
* device-impl.h (struct device):
* device-msw.c:
* device-msw.c (mswindows_init_device):
* device-msw.c (msprinter_init_device):
* device-msw.c (finalize_devmode):
* device-msw.c (allocate_devmode):
* device-tty.c (allocate_tty_device_struct):
* device-x.c (allocate_x_device_struct):
* device.c:
* device.c (nuke_all_device_slots):
* device.c (allocate_device):
* dialog-msw.c (handle_question_dialog_box):
* elhash.c:
* elhash.c (struct Lisp_Hash_Table):
* elhash.c (finalize_hash_table):
* elhash.c (make_general_lisp_hash_table):
* elhash.c (Fcopy_hash_table):
* elhash.h (htentry):
* emacs.c (main_1):
* eval.c:
* eval.c (size_multiple_value):
* event-stream.c (finalize_command_builder):
* event-stream.c (allocate_command_builder):
* event-stream.c (free_command_builder):
* event-stream.c (event_stream_generate_wakeup):
* event-stream.c (event_stream_resignal_wakeup):
* event-stream.c (event_stream_disable_wakeup):
* event-stream.c (event_stream_wakeup_pending_p):
* events.h (struct Lisp_Timeout):
* events.h (struct command_builder):
* extents-impl.h:
* extents-impl.h (struct extent_auxiliary):
* extents-impl.h (struct extent_info):
* extents-impl.h (set_extent_no_chase_aux_field):
* extents-impl.h (set_extent_no_chase_normal_field):
* extents.c:
* extents.c (gap_array_marker):
* extents.c (gap_array):
* extents.c (extent_list_marker):
* extents.c (extent_list):
* extents.c (stack_of_extents):
* extents.c (gap_array_make_marker):
* extents.c (extent_list_make_marker):
* extents.c (allocate_extent_list):
* extents.c (SLOT):
* extents.c (mark_extent_auxiliary):
* extents.c (allocate_extent_auxiliary):
* extents.c (attach_extent_auxiliary):
* extents.c (size_gap_array):
* extents.c (finalize_extent_info):
* extents.c (allocate_extent_info):
* extents.c (uninit_buffer_extents):
* extents.c (allocate_soe):
* extents.c (copy_extent):
* extents.c (vars_of_extents):
* extents.h:
* faces.c (allocate_face):
* faces.h (struct Lisp_Face):
* faces.h (struct face_cachel):
* file-coding.c:
* file-coding.c (finalize_coding_system):
* file-coding.c (sizeof_coding_system):
* file-coding.c (Fcopy_coding_system):
* file-coding.h (struct Lisp_Coding_System):
* file-coding.h (MARKED_SLOT):
* fns.c (size_bit_vector):
* font-mgr.c:
* font-mgr.c (finalize_fc_pattern):
* font-mgr.c (print_fc_pattern):
* font-mgr.c (Ffc_pattern_p):
* font-mgr.c (Ffc_pattern_create):
* font-mgr.c (Ffc_name_parse):
* font-mgr.c (Ffc_name_unparse):
* font-mgr.c (Ffc_pattern_duplicate):
* font-mgr.c (Ffc_pattern_add):
* font-mgr.c (Ffc_pattern_del):
* font-mgr.c (Ffc_pattern_get):
* font-mgr.c (fc_config_create_using):
* font-mgr.c (fc_strlist_to_lisp_using):
* font-mgr.c (fontset_to_list):
* font-mgr.c (Ffc_config_p):
* font-mgr.c (Ffc_config_up_to_date):
* font-mgr.c (Ffc_config_build_fonts):
* font-mgr.c (Ffc_config_get_cache):
* font-mgr.c (Ffc_config_get_fonts):
* font-mgr.c (Ffc_config_set_current):
* font-mgr.c (Ffc_config_get_blanks):
* font-mgr.c (Ffc_config_get_rescan_interval):
* font-mgr.c (Ffc_config_set_rescan_interval):
* font-mgr.c (Ffc_config_app_font_add_file):
* font-mgr.c (Ffc_config_app_font_add_dir):
* font-mgr.c (Ffc_config_app_font_clear):
* font-mgr.c (size):
* font-mgr.c (Ffc_config_substitute):
* font-mgr.c (Ffc_font_render_prepare):
* font-mgr.c (Ffc_font_match):
* font-mgr.c (Ffc_font_sort):
* font-mgr.c (finalize_fc_config):
* font-mgr.c (print_fc_config):
* font-mgr.h:
* font-mgr.h (struct fc_pattern):
* font-mgr.h (XFC_PATTERN):
* font-mgr.h (struct fc_config):
* font-mgr.h (XFC_CONFIG):
* frame-gtk.c (allocate_gtk_frame_struct):
* frame-impl.h (struct frame):
* frame-msw.c (mswindows_init_frame_1):
* frame-x.c (allocate_x_frame_struct):
* frame.c (nuke_all_frame_slots):
* frame.c (allocate_frame_core):
* gc.c:
* gc.c (GC_CHECK_NOT_FREE):
* glyphs.c (finalize_image_instance):
* glyphs.c (allocate_image_instance):
* glyphs.c (Fcolorize_image_instance):
* glyphs.c (allocate_glyph):
* glyphs.c (unmap_subwindow_instance_cache_mapper):
* glyphs.c (register_ignored_expose):
* glyphs.h (struct Lisp_Image_Instance):
* glyphs.h (struct Lisp_Glyph):
* glyphs.h (struct glyph_cachel):
* glyphs.h (struct expose_ignore):
* gui.c (allocate_gui_item):
* gui.h (struct Lisp_Gui_Item):
* keymap.c (struct Lisp_Keymap):
* keymap.c (make_keymap):
* lisp.h:
* lisp.h (struct Lisp_String_Direct_Data):
* lisp.h (struct Lisp_String_Indirect_Data):
* lisp.h (struct Lisp_Vector):
* lisp.h (struct Lisp_Bit_Vector):
* lisp.h (DECLARE_INLINE_LISP_BIT_VECTOR):
* lisp.h (struct weak_box):
* lisp.h (struct ephemeron):
* lisp.h (struct weak_list):
* lrecord.h:
* lrecord.h (struct lrecord_implementation):
* lrecord.h (MC_ALLOC_CALL_FINALIZER):
* lrecord.h (struct lcrecord_list):
* lstream.c (finalize_lstream):
* lstream.c (sizeof_lstream):
* lstream.c (Lstream_new):
* lstream.c (Lstream_delete):
* lstream.h (struct lstream):
* marker.c:
* marker.c (finalize_marker):
* marker.c (compute_buffer_marker_usage):
* mule-charset.c:
* mule-charset.c (make_charset):
* mule-charset.c (compute_charset_usage):
* objects-impl.h (struct Lisp_Color_Instance):
* objects-impl.h (struct Lisp_Font_Instance):
* objects-tty-impl.h (struct tty_color_instance_data):
* objects-tty-impl.h (struct tty_font_instance_data):
* objects-tty.c (tty_initialize_color_instance):
* objects-tty.c (tty_initialize_font_instance):
* objects.c (finalize_color_instance):
* objects.c (Fmake_color_instance):
* objects.c (finalize_font_instance):
* objects.c (Fmake_font_instance):
* objects.c (reinit_vars_of_objects):
* opaque.c:
* opaque.c (sizeof_opaque):
* opaque.c (make_opaque_ptr):
* opaque.c (free_opaque_ptr):
* opaque.h:
* opaque.h (Lisp_Opaque):
* opaque.h (Lisp_Opaque_Ptr):
* print.c (printing_unreadable_lcrecord):
* print.c (external_object_printer):
* print.c (debug_p4):
* process.c (finalize_process):
* process.c (make_process_internal):
* procimpl.h (struct Lisp_Process):
* rangetab.c (Fmake_range_table):
* rangetab.c (Fcopy_range_table):
* rangetab.h (struct Lisp_Range_Table):
* scrollbar.c:
* scrollbar.c (create_scrollbar_instance):
* scrollbar.c (compute_scrollbar_instance_usage):
* scrollbar.h (struct scrollbar_instance):
* specifier.c (finalize_specifier):
* specifier.c (sizeof_specifier):
* specifier.c (set_specifier_caching):
* specifier.h (struct Lisp_Specifier):
* specifier.h (struct specifier_caching):
* symeval.h:
* symeval.h (SYMBOL_VALUE_MAGIC_P):
* symeval.h (DEFVAR_SYMVAL_FWD):
* symsinit.h:
* syntax.c (init_buffer_syntax_cache):
* syntax.h (struct syntax_cache):
* toolbar.c:
* toolbar.c (allocate_toolbar_button):
* toolbar.c (update_toolbar_button):
* toolbar.h (struct toolbar_button):
* tooltalk.c (struct Lisp_Tooltalk_Message):
* tooltalk.c (make_tooltalk_message):
* tooltalk.c (struct Lisp_Tooltalk_Pattern):
* tooltalk.c (make_tooltalk_pattern):
* ui-gtk.c:
* ui-gtk.c (allocate_ffi_data):
* ui-gtk.c (emacs_gtk_object_finalizer):
* ui-gtk.c (allocate_emacs_gtk_object_data):
* ui-gtk.c (allocate_emacs_gtk_boxed_data):
* ui-gtk.h:
* window-impl.h (struct window):
* window-impl.h (struct window_mirror):
* window.c (finalize_window):
* window.c (allocate_window):
* window.c (new_window_mirror):
* window.c (mark_window_as_deleted):
* window.c (make_dummy_parent):
* window.c (compute_window_mirror_usage):
* window.c (compute_window_usage):
Overall point of this change and previous ones in this repository:
(1) Introduce new, clearer terminology: everything other than int
or char is a "record" object, which comes in two types: "normal
objects" and "frob-block objects". Fix up all places that
referred to frob-block objects as "simple", "basic", etc.
(2) Provide an advertised interface for doing operations on Lisp
objects, including creating new types, that is clean and
consistent in its naming, uses the above-referenced terms and
avoids referencing "lrecords", "old lcrecords", etc., which should
hide under the surface.
(3) Make the size_in_bytes and finalizer methods take a
Lisp_Object rather than a void * for consistency with other methods.
(4) Separate finalizer method into finalizer and disksaver, so
that normal finalize methods don't have to worry about disksaving.
Other specifics:
(1) Renaming:
LISP_OBJECT_HEADER -> NORMAL_LISP_OBJECT_HEADER
ALLOC_LISP_OBJECT -> ALLOC_NORMAL_LISP_OBJECT
implementation->basic_p -> implementation->frob_block_p
ALLOCATE_FIXED_TYPE_AND_SET_IMPL -> ALLOC_FROB_BLOCK_LISP_OBJECT
*FCCONFIG*, wrap_fcconfig -> *FC_CONFIG*, wrap_fc_config
*FCPATTERN*, wrap_fcpattern -> *FC_PATTERN*, wrap_fc_pattern
(the last two changes make the naming of these macros consistent
with the naming of all other macros, since the objects are named
fc-config and fc-pattern with a hyphen)
(2) Lots of documentation fixes in lrecord.h.
(3) Eliminate macros for copying, freeing, zeroing objects, getting
their storage size. Instead, new functions:
zero_sized_lisp_object()
zero_nonsized_lisp_object()
lisp_object_storage_size()
free_normal_lisp_object()
(copy_lisp_object() already exists)
LISP_OBJECT_FROB_BLOCK_P() (actually a macro)
Eliminated:
free_lrecord()
zero_lrecord()
copy_lrecord()
copy_sized_lrecord()
old_copy_lcrecord()
old_copy_sized_lcrecord()
old_zero_lcrecord()
old_zero_sized_lcrecord()
LISP_OBJECT_STORAGE_SIZE()
COPY_SIZED_LISP_OBJECT()
COPY_SIZED_LCRECORD()
COPY_LISP_OBJECT()
ZERO_LISP_OBJECT()
FREE_LISP_OBJECT()
(4) Catch the remaining places where lrecord stuff was used directly
and use the advertised interface, e.g. alloc_sized_lrecord() ->
ALLOC_SIZED_LISP_OBJECT().
(5) Make certain statically-declared pseudo-objects
(buffer_local_flags, console_local_flags) have their lheader
initialized correctly, so things like copy_lisp_object() can work
on them. Make extent_auxiliary_defaults a proper heap object
Vextent_auxiliary_defaults, and make extent auxiliaries dumpable
so that this object can be dumped. allocate_extent_auxiliary()
now just creates the object, and attach_extent_auxiliary()
creates an extent auxiliary and attaches to an extent, like the
old allocate_extent_auxiliary().
(6) Create EXTENT_AUXILIARY_SLOTS macro, similar to the foo-slots.h
files but in a macro instead of a file. The purpose is to avoid
duplication when iterating over all the slots in an extent auxiliary.
Use it.
(7) In lstream.c, don't zero out object after allocation because
allocation routines take care of this.
(8) In marker.c, fix a mistake in computing marker overhead.
(9) In print.c, clean up printing_unreadable_lcrecord(),
external_object_printer() to avoid lots of ifdef NEW_GC's.
(10) Separate toolbar-button allocation into a separate
allocate_toolbar_button() function for use in the example code
in lrecord.h.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Fri, 05 Mar 2010 04:08:17 -0600 |
| parents | c17c857e20bf |
| children | dc94bf0afa37 |
| rev | line source |
|---|---|
| 428 | 1 ;;; obsolete.el --- obsoleteness support |
| 2 | |
| 3 ;; Copyright (C) 1985-1994, 1997 Free Software Foundation, Inc. | |
| 4 ;; Copyright (C) 1994, 1995 Amdahl Corporation. | |
| 5 ;; Copyright (C) 1995 Sun Microsystems. | |
| 2527 | 6 ;; Copyright (C) 2002, 2004 Ben Wing. |
| 428 | 7 |
| 8 ;; Maintainer: XEmacs Development Team | |
| 9 ;; Keywords: internal, dumped | |
| 10 | |
| 11 ;; This file is part of XEmacs. | |
| 12 | |
| 13 ;; XEmacs is free software; you can redistribute it and/or modify it | |
| 14 ;; under the terms of the GNU General Public License as published by | |
| 15 ;; the Free Software Foundation; either version 2, or (at your option) | |
| 16 ;; any later version. | |
| 17 | |
| 18 ;; XEmacs is distributed in the hope that it will be useful, but | |
| 19 ;; WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
| 21 ;; General Public License for more details. | |
| 22 | |
| 23 ;; You should have received a copy of the GNU General Public License | |
| 24 ;; along with XEmacs; see the file COPYING. If not, write to the | |
| 25 ;; Free Software Foundation, 59 Temple Place - Suite 330, | |
| 26 ;; Boston, MA 02111-1307, USA. | |
| 27 | |
| 28 ;;; Synched up with: Not in FSF. | |
| 29 | |
| 30 ;;; Commentary: | |
| 31 | |
| 32 ;; This file is dumped with XEmacs. | |
| 33 | |
| 34 ;; The obsoleteness support used to be scattered throughout various | |
| 35 ;; source files. We put the stuff in one place to remove the junkiness | |
| 36 ;; from other source files and to facilitate creating/updating things | |
| 37 ;; like sysdep.el. | |
| 38 | |
| 39 ;;; Code: | |
| 40 | |
| 41 (defsubst define-obsolete-function-alias (oldfun newfun) | |
| 42 "Define OLDFUN as an obsolete alias for function NEWFUN. | |
| 43 This makes calling OLDFUN equivalent to calling NEWFUN and marks OLDFUN | |
| 44 as obsolete." | |
| 45 (define-function oldfun newfun) | |
| 46 (make-obsolete oldfun newfun)) | |
| 47 | |
| 48 (defsubst define-compatible-function-alias (oldfun newfun) | |
| 49 "Define OLDFUN as a compatible alias for function NEWFUN. | |
| 50 This makes calling OLDFUN equivalent to calling NEWFUN and marks OLDFUN | |
| 51 as provided for compatibility only." | |
| 52 (define-function oldfun newfun) | |
| 53 (make-compatible oldfun newfun)) | |
| 54 | |
| 55 (defsubst define-obsolete-variable-alias (oldvar newvar) | |
| 56 "Define OLDVAR as an obsolete alias for variable NEWVAR. | |
| 57 This makes referencing or setting OLDVAR equivalent to referencing or | |
| 58 setting NEWVAR and marks OLDVAR as obsolete. | |
| 59 If OLDVAR was bound and NEWVAR was not, Set NEWVAR to OLDVAR. | |
| 60 | |
| 444 | 61 Note: Use this before any other references (defvar/defcustom) to NEWVAR." |
| 428 | 62 (let ((needs-setting (and (boundp oldvar) (not (boundp newvar)))) |
| 63 (value (and (boundp oldvar) (symbol-value oldvar)))) | |
| 64 (defvaralias oldvar newvar) | |
| 65 (make-obsolete-variable oldvar newvar) | |
| 66 (and needs-setting (set newvar value)))) | |
| 67 | |
| 68 (defsubst define-compatible-variable-alias (oldvar newvar) | |
| 69 "Define OLDVAR as a compatible alias for variable NEWVAR. | |
| 70 This makes referencing or setting OLDVAR equivalent to referencing or | |
| 71 setting NEWVAR and marks OLDVAR as provided for compatibility only." | |
| 72 (defvaralias oldvar newvar) | |
| 73 (make-compatible-variable oldvar newvar)) | |
| 74 | |
| 75 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; device stuff | |
| 76 | |
| 77 (make-compatible-variable 'window-system "use (console-type)") | |
| 78 | |
| 79 (defun x-display-color-p (&optional device) | |
| 80 "Return t if DEVICE is a color device." | |
| 81 (eq 'color (device-class device))) | |
| 82 (make-compatible 'x-display-color-p 'device-class) | |
| 83 | |
| 84 (define-function 'x-color-display-p 'x-display-color-p) | |
| 85 (make-compatible 'x-display-color-p 'device-class) | |
| 86 | |
| 87 (defun x-display-grayscale-p (&optional device) | |
| 88 "Return t if DEVICE is a grayscale device." | |
| 89 (eq 'grayscale (device-class device))) | |
| 90 (make-compatible 'x-display-grayscale-p 'device-class) | |
| 91 | |
| 92 (define-function 'x-grayscale-display-p 'x-display-grayscale-p) | |
| 93 (make-compatible 'x-display-grayscale-p 'device-class) | |
| 94 | |
| 95 (define-compatible-function-alias 'x-display-pixel-width 'device-pixel-width) | |
| 96 (define-compatible-function-alias 'x-display-pixel-height 'device-pixel-height) | |
| 97 (define-compatible-function-alias 'x-display-planes 'device-bitplanes) | |
| 98 (define-compatible-function-alias 'x-display-color-cells 'device-color-cells) | |
| 99 | |
| 100 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; events | |
| 101 | |
| 102 (define-obsolete-function-alias 'menu-event-p 'misc-user-event-p) | |
| 103 (make-obsolete-variable 'unread-command-char 'unread-command-events) | |
| 104 | |
| 105 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; extents | |
| 106 | |
| 107 (make-obsolete 'set-window-dot 'set-window-point) | |
| 108 | |
| 109 (define-obsolete-function-alias 'extent-buffer 'extent-object) | |
| 1024 | 110 (define-compatible-variable-alias 'parse-sexp-lookup-properties |
| 111 'lookup-syntax-properties) | |
| 428 | 112 |
| 113 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; frames | |
| 114 (defun frame-first-window (frame) | |
| 115 "Return the topmost, leftmost window of FRAME. | |
| 116 If omitted, FRAME defaults to the currently selected frame." | |
| 117 (frame-highest-window frame 0)) | |
| 118 (make-compatible 'frame-first-window 'frame-highest-window) | |
| 119 | |
| 120 (define-obsolete-variable-alias 'initial-frame-alist 'initial-frame-plist) | |
| 121 (define-obsolete-variable-alias 'minibuffer-frame-alist | |
| 122 'minibuffer-frame-plist) | |
| 123 (define-obsolete-variable-alias 'pop-up-frame-alist 'pop-up-frame-plist) | |
| 124 (define-obsolete-variable-alias 'special-display-frame-alist | |
| 125 'special-display-frame-plist) | |
| 126 | |
| 127 ;; Defined in C. | |
| 128 | |
| 129 (define-obsolete-variable-alias 'default-frame-alist 'default-frame-plist) | |
| 130 (define-obsolete-variable-alias 'default-x-frame-alist 'default-x-frame-plist) | |
| 131 (define-obsolete-variable-alias 'default-tty-frame-alist | |
| 132 'default-tty-frame-plist) | |
| 133 | |
| 134 (make-compatible 'frame-parameters 'frame-property) | |
| 135 (defun frame-parameters (&optional frame) | |
| 136 "Return the parameters-alist of frame FRAME. | |
| 137 It is a list of elements of the form (PARM . VALUE), where PARM is a symbol. | |
| 138 The meaningful PARMs depend on the kind of frame. | |
| 139 If FRAME is omitted, return information on the currently selected frame. | |
| 140 | |
| 141 See the variables `default-frame-plist', `default-x-frame-plist', and | |
| 142 `default-tty-frame-plist' for a description of the parameters meaningful | |
| 143 for particular types of frames." | |
| 144 (or frame (setq frame (selected-frame))) | |
| 145 ;; #### This relies on a `copy-sequence' of the user properties in | |
| 146 ;; `frame-properties'. Removing that would make `frame-properties' more | |
| 147 ;; efficient but this function less efficient, as we couldn't be | |
| 148 ;; destructive. Since most callers now use `frame-parameters', we'll | |
| 149 ;; do it this way. Should probably change this at some point in the | |
| 150 ;; future. | |
| 151 (destructive-plist-to-alist (frame-properties frame))) | |
| 152 | |
| 883 | 153 (make-compatible 'frame-parameter 'frame-property) |
| 154 (defun frame-parameter (frame parameter) | |
| 155 "Return FRAME's value for parameter PARAMETER. | |
| 156 If FRAME is nil, describe the currently selected frame." | |
| 157 (cdr (assq parameter (frame-parameters frame)))) | |
| 158 | |
| 428 | 159 (make-compatible 'modify-frame-parameters 'set-frame-properties) |
| 160 (defun modify-frame-parameters (frame alist) | |
| 161 "Modify the properties of frame FRAME according to ALIST. | |
| 162 ALIST is an alist of properties to change and their new values. | |
| 163 Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol. | |
| 164 The meaningful PARMs depend on the kind of frame. | |
| 165 | |
| 166 See `set-frame-properties' for built-in property names." | |
| 167 ;; it would be nice to be destructive here but that's not safe. | |
| 168 (set-frame-properties frame (alist-to-plist alist))) | |
| 169 | |
| 170 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; faces | |
| 171 | |
| 172 (define-obsolete-function-alias 'list-faces-display 'edit-faces) | |
| 173 (define-obsolete-function-alias 'list-faces 'face-list) | |
| 174 | |
| 175 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; paths | |
| 176 | |
| 177 (defvar Info-default-directory-list nil | |
| 178 "This used to be the initial value of Info-directory-list. | |
| 179 If you want to change the locations where XEmacs looks for info files, | |
| 180 set Info-directory-list.") | |
| 181 (make-obsolete-variable 'Info-default-directory-list 'Info-directory-list) | |
| 182 | |
| 183 (defvar init-file-user nil | |
| 184 "This used to be the name of the user whose init file was read at startup.") | |
| 185 (make-obsolete-variable 'init-file-user 'load-user-init-file-p) | |
| 186 | |
| 1365 | 187 (define-obsolete-function-alias 'pui-add-install-directory |
| 188 'pui-set-local-package-get-directory) ; misleading name | |
| 428 | 189 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; hooks |
| 190 | |
| 191 (make-compatible-variable 'lisp-indent-hook 'lisp-indent-function) | |
| 192 (make-compatible-variable 'comment-indent-hook 'comment-indent-function) | |
| 193 (make-obsolete-variable 'temp-buffer-show-hook | |
| 194 'temp-buffer-show-function) | |
| 195 (make-obsolete-variable 'inhibit-local-variables | |
| 196 "use `enable-local-variables' (with the reversed sense).") | |
| 197 (make-obsolete-variable 'suspend-hooks 'suspend-hook) | |
| 198 (make-obsolete-variable 'first-change-function 'first-change-hook) | |
| 199 (make-obsolete-variable 'before-change-function | |
| 200 "use before-change-functions; which is a list of functions rather than a single function.") | |
| 201 (make-obsolete-variable 'after-change-function | |
| 202 "use after-change-functions; which is a list of functions rather than a single function.") | |
| 203 | |
| 204 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; insertion and deletion | |
| 205 | |
| 206 (define-compatible-function-alias 'insert-and-inherit 'insert) | |
| 207 (define-compatible-function-alias 'insert-before-markers-and-inherit | |
| 208 'insert-before-markers) | |
| 209 | |
| 210 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; keymaps | |
| 211 | |
| 212 (defun keymap-parent (keymap) | |
| 213 "Return the first parent of the given keymap." | |
| 214 (car (keymap-parents keymap))) | |
| 215 (make-compatible 'keymap-parent 'keymap-parents) | |
| 216 | |
| 217 (defun set-keymap-parent (keymap parent) | |
| 218 "Make the given keymap have (only) the given parent." | |
| 219 (set-keymap-parents keymap (if parent (list parent) '())) | |
| 220 parent) | |
| 221 (make-compatible 'set-keymap-parent 'set-keymap-parents) | |
| 222 | |
| 223 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; menu stuff | |
| 224 | |
|
4317
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
225 (defun add-menu-item (menu-path item-name function enabled-p &optional before) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
226 "Obsolete. See the function `add-menu-button'." |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
227 (or item-name (error "must specify an item name")) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
228 (declare-fboundp (add-menu-button menu-path (vector item-name function enabled-p) before))) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
229 (make-obsolete 'add-menu-item 'add-menu-button) |
| 428 | 230 |
|
4317
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
231 (defun add-menu (menu-path menu-name menu-items &optional before) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
232 "See the function `add-submenu'." |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
233 (or menu-name (error "must specify a menu name")) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
234 (or menu-items (error "must specify some menu items")) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
235 (declare-fboundp (add-submenu menu-path (cons menu-name menu-items) before))) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
236 ;; Can't make this obsolete. easymenu depends on it. |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
237 (make-compatible 'add-menu 'add-submenu) |
| 428 | 238 |
|
4317
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
239 (define-obsolete-function-alias 'package-get-download-menu |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
240 'package-ui-download-menu) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
241 |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
242 (unless (featurep 'menubar) |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
243 ;; Don't provide the last three functions unless the menubar feature is |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
244 ;; available. This approach (with #'unintern) avoids warnings about lost |
|
15d36164ebd7
Eliminate lost docstring warnings on 21.5.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4222
diff
changeset
|
245 ;; docstrings since make-docfile doesn't parse bytecode. |
|
4783
e29fcfd8df5f
Eliminate most core code byte-compile warnings.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4677
diff
changeset
|
246 (mapc #'unintern '(add-menu-item add-menu package-get-download-menu))) |
| 1365 | 247 |
| 428 | 248 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; minibuffer |
| 249 | |
| 250 (define-compatible-function-alias 'read-minibuffer | |
| 251 'read-expression) ; misleading name | |
| 252 (define-compatible-function-alias 'read-input 'read-string) | |
| 253 | |
| 254 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; misc | |
| 255 | |
| 256 ;; (defun user-original-login-name () | |
| 257 ;; "Return user's login name from original login. | |
| 258 ;; This tries to remain unaffected by `su', by looking in environment variables." | |
| 259 ;; (or (getenv "LOGNAME") (getenv "USER") (user-login-name))) | |
| 260 (define-obsolete-function-alias 'user-original-login-name 'user-login-name) | |
| 261 | |
| 262 ; old names | |
| 263 (define-obsolete-function-alias 'show-buffer 'set-window-buffer) | |
| 264 (define-obsolete-function-alias 'buffer-flush-undo 'buffer-disable-undo) | |
| 265 (make-compatible 'eval-current-buffer 'eval-buffer) | |
| 266 (define-compatible-function-alias 'byte-code-function-p | |
| 267 'compiled-function-p) ;FSFmacs | |
| 268 | |
| 269 (define-obsolete-function-alias 'isearch-yank-x-selection | |
| 270 'isearch-yank-selection) | |
| 271 (define-obsolete-function-alias 'isearch-yank-x-clipboard | |
| 272 'isearch-yank-clipboard) | |
| 273 | |
| 274 ;; too bad there's not a way to check for aref, assq, and nconc | |
| 275 ;; being called on the values of functions known to return keymaps, | |
| 276 ;; or known to return vectors of events instead of strings... | |
| 277 | |
|
4885
6772ce4d982b
Fix hash tables, #'member*, #'assoc*, #'eql compiler macros if bignums
Aidan Kehoe <kehoea@parhasard.net>
parents:
4783
diff
changeset
|
278 ;;; Yes there is; make compiler macros for aref, assq, nconc, checking that |
|
6772ce4d982b
Fix hash tables, #'member*, #'assoc*, #'eql compiler macros if bignums
Aidan Kehoe <kehoea@parhasard.net>
parents:
4783
diff
changeset
|
279 ;;; the car of the relevant argument is sane. |
|
6772ce4d982b
Fix hash tables, #'member*, #'assoc*, #'eql compiler macros if bignums
Aidan Kehoe <kehoea@parhasard.net>
parents:
4783
diff
changeset
|
280 |
| 428 | 281 (make-obsolete-variable 'executing-macro 'executing-kbd-macro) |
| 282 | |
| 718 | 283 (define-compatible-function-alias 'interactive-form |
| 863 | 284 'function-interactive) ;GNU 21.1 |
| 285 (define-compatible-function-alias 'assq-delete-all | |
| 286 'remassq) ;GNU 21.1 | |
| 718 | 287 |
| 883 | 288 (defun makehash (&optional test) |
| 289 "Create a new hash table. | |
| 290 Optional first argument TEST specifies how to compare keys in the table. | |
| 291 Predefined tests are `eq', `eql', and `equal'. Default is `eql'." | |
| 292 (make-hash-table :test test)) | |
| 293 (make-compatible 'makehash 'make-hash-table) | |
| 294 | |
| 295 (defun buffer-local-value (variable buffer) | |
| 296 "Return the value of VARIABLE in BUFFER. | |
| 297 If VARIABLE does not have a buffer-local binding in BUFFER, the value | |
| 298 is the default binding of variable." | |
| 299 (symbol-value-in-buffer variable buffer)) | |
| 300 (make-compatible 'buffer-local-value 'symbol-value-in-buffer) | |
| 301 | |
| 302 (define-compatible-function-alias 'line-beginning-position 'point-at-bol) | |
| 303 (define-compatible-function-alias 'line-end-position 'point-at-eol) | |
| 304 | |
| 428 | 305 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; modeline |
| 306 | |
| 307 (define-compatible-function-alias 'redraw-mode-line 'redraw-modeline) | |
| 308 (define-compatible-function-alias 'force-mode-line-update | |
| 309 'redraw-modeline) ;; FSF compatibility | |
| 310 (define-compatible-variable-alias 'mode-line-map 'modeline-map) | |
| 311 (define-compatible-variable-alias 'mode-line-buffer-identification | |
| 312 'modeline-buffer-identification) | |
| 313 (define-compatible-variable-alias 'mode-line-process 'modeline-process) | |
| 314 (define-compatible-variable-alias 'mode-line-modified 'modeline-modified) | |
| 315 (make-compatible-variable 'mode-line-inverse-video | |
| 316 "use set-face-highlight-p and set-face-reverse-p") | |
| 317 (define-compatible-variable-alias 'default-mode-line-format | |
| 318 'default-modeline-format) | |
| 319 (define-compatible-variable-alias 'mode-line-format 'modeline-format) | |
| 320 (define-compatible-variable-alias 'mode-line-menu 'modeline-menu) | |
| 321 | |
| 322 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; mouse | |
| 323 | |
| 324 ;;; (defun mouse-eval-last-sexpr (event) | |
| 325 ;;; (interactive "@e") | |
| 326 ;;; (save-excursion | |
| 327 ;;; (mouse-set-point event) | |
| 328 ;;; (eval-last-sexp nil))) | |
| 329 | |
| 330 (define-obsolete-function-alias 'mouse-eval-last-sexpr 'mouse-eval-sexp) | |
| 331 | |
| 332 (defun read-mouse-position (frame) | |
| 333 (cdr (mouse-position (frame-device frame)))) | |
| 334 (make-obsolete 'read-mouse-position 'mouse-position) | |
| 335 | |
| 336 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; redisplay | |
| 337 | |
| 338 (defun redraw-display (&optional device) | |
| 339 (if (eq device t) | |
| 340 (mapcar 'redisplay-device (device-list)) | |
| 341 (redisplay-device device))) | |
| 342 | |
| 777 | 343 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; strings |
| 344 | |
| 345 (define-obsolete-function-alias 'sref 'aref) | |
| 346 | |
| 347 (defun char-bytes (character) | |
| 348 "Return number of bytes a CHARACTER occupies in a string or buffer. | |
| 349 It always returns 1 in XEmacs, and in recent FSF Emacs versions." | |
| 350 1) | |
| 351 (make-obsolete 'char-bytes "This function always returns 1") | |
| 352 | |
| 860 | 353 (defun find-non-ascii-charset-string (string) |
| 354 "Return a list of charsets in the STRING except ascii. | |
| 355 It might be available for compatibility with Mule 2.3, | |
| 356 because its `find-charset-string' ignores ASCII charset." | |
| 4222 | 357 (delq 'ascii (and-fboundp #'charsets-in-string (charsets-in-string string)))) |
| 860 | 358 (make-obsolete 'find-non-ascii-charset-string |
| 359 "use (delq 'ascii (charsets-in-string STRING)) instead.") | |
| 360 | |
| 361 (defun find-non-ascii-charset-region (start end) | |
| 362 "Return a list of charsets except ascii in the region between START and END. | |
| 363 It might be available for compatibility with Mule 2.3, | |
| 364 because its `find-charset-string' ignores ASCII charset." | |
| 4222 | 365 (delq 'ascii (and-fboundp #'charsets-in-region |
| 366 (charsets-in-region start end)))) | |
| 860 | 367 (make-obsolete 'find-non-ascii-charset-region |
| 368 "use (delq 'ascii (charsets-in-region START END)) instead.") | |
| 818 | 369 |
| 3555 | 370 ;; < 21.5 compatibility, eg. https://bugzilla.redhat.com/201524#c2 |
| 371 (define-obsolete-function-alias 'string-to-char-list 'string-to-list) | |
| 372 | |
| 428 | 373 ;;;;;;;;;;;;;;;;;;;;;;;;;;;; window-system objects |
| 374 | |
| 375 ;; the functionality of column.el has been moved into C | |
| 376 ;; Function obsoleted for XEmacs 20.0/February 1997. | |
| 377 (defalias 'display-column-mode 'column-number-mode) | |
| 378 | |
| 379 (defun x-color-values (color &optional frame) | |
| 380 "Return a description of the color named COLOR on frame FRAME. | |
| 381 The value is a list of integer RGB values--(RED GREEN BLUE). | |
| 382 These values appear to range from 0 to 65280 or 65535, depending | |
| 383 on the system; white is (65280 65280 65280) or (65535 65535 65535). | |
| 384 If FRAME is omitted or nil, use the selected frame." | |
| 385 (color-instance-rgb-components (make-color-instance color))) | |
| 386 (make-compatible 'x-color-values 'color-instance-rgb-components) | |
| 387 | |
| 2527 | 388 (make-obsolete 'mswindows-color-list 'color-list) |
| 389 (make-obsolete 'tty-color-list 'color-list) | |
| 390 (make-compatible 'list-fonts 'font-list) | |
| 391 | |
| 428 | 392 ;; Two loser functions which shouldn't be used. |
| 393 (make-obsolete 'following-char 'char-after) | |
| 394 (make-obsolete 'preceding-char 'char-before) | |
| 395 | |
| 396 ;; Keywords already do The Right Thing in XEmacs | |
| 397 (make-compatible 'define-widget-keywords "Just use them") | |
| 398 | |
| 399 (make-obsolete 'function-called-at-point 'function-at-point) | |
| 400 | |
|
4905
755ae5b97edb
Change "special form" to "special operator" in our sources.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4885
diff
changeset
|
401 ;; As of 21.5, #'throw is a special operator. This makes bytecode using it |
|
4677
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
402 ;; compiled for 21.4 fail; making this function available works around that. |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
403 (defun obsolete-throw (tag value) |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
404 "Ugly compatibility hack. |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
405 |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
406 See the implementation of #'funcall in eval.c. This should be removed once |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
407 we no longer encounter bytecode from 21.4." |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
408 (throw tag value)) |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
409 |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
410 (make-obsolete |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
411 'obsolete-throw |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
412 "it says `obsolete' in the name, you know you shouldn't be using this.") |
|
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4317
diff
changeset
|
413 |
|
4995
8431b52e43b1
Move the various map* functions to C; add #'map-into.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4885
diff
changeset
|
414 (define-compatible-function-alias 'cl-mapc 'mapc) |
|
8431b52e43b1
Move the various map* functions to C; add #'map-into.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4885
diff
changeset
|
415 |
| 428 | 416 (provide 'obsolete) |
| 417 ;;; obsolete.el ends here |