Mercurial > hg > xemacs-beta
annotate lisp/objects.el @ 4981:4aebb0131297
Cleanups/renaming of EXTERNAL_TO_C_STRING and friends
-------------------- ChangeLog entries follow: --------------------
modules/ChangeLog addition:
2010-02-05 Ben Wing <ben@xemacs.org>
* postgresql/postgresql.c:
* postgresql/postgresql.c (CHECK_LIVE_CONNECTION):
* postgresql/postgresql.c (Fpq_connectdb):
* postgresql/postgresql.c (Fpq_connect_start):
* postgresql/postgresql.c (Fpq_lo_import):
* postgresql/postgresql.c (Fpq_lo_export):
* ldap/eldap.c (Fldap_open):
* ldap/eldap.c (Fldap_search_basic):
* ldap/eldap.c (Fldap_add):
* ldap/eldap.c (Fldap_modify):
* ldap/eldap.c (Fldap_delete):
* canna/canna_api.c (Fcanna_initialize):
* canna/canna_api.c (Fcanna_store_yomi):
* canna/canna_api.c (Fcanna_parse):
* canna/canna_api.c (Fcanna_henkan_begin):
EXTERNAL_TO_C_STRING returns its argument instead of storing it
in a parameter, and is renamed to EXTERNAL_TO_ITEXT. Similar
things happen to related macros. See entry in src/ChangeLog.
More Mule-izing of postgresql.c. Extract out common code
between `pq-connectdb' and `pq-connect-start'. Fix places
that signal an error string using a formatted string to instead
follow the standard and have a fixed reason followed by the
particular error message stored as one of the frobs.
src/ChangeLog addition:
2010-02-05 Ben Wing <ben@xemacs.org>
* console-msw.c (write_string_to_mswindows_debugging_output):
* console-msw.c (Fmswindows_message_box):
* console-x.c (x_perhaps_init_unseen_key_defaults):
* console.c:
* database.c (dbm_get):
* database.c (dbm_put):
* database.c (dbm_remove):
* database.c (berkdb_get):
* database.c (berkdb_put):
* database.c (berkdb_remove):
* database.c (Fopen_database):
* device-gtk.c (gtk_init_device):
* device-msw.c (msprinter_init_device_internal):
* device-msw.c (msprinter_default_printer):
* device-msw.c (msprinter_init_device):
* device-msw.c (sync_printer_with_devmode):
* device-msw.c (Fmsprinter_select_settings):
* device-x.c (sanity_check_geometry_resource):
* device-x.c (Dynarr_add_validified_lisp_string):
* device-x.c (x_init_device):
* device-x.c (Fx_put_resource):
* device-x.c (Fx_valid_keysym_name_p):
* device-x.c (Fx_set_font_path):
* dialog-msw.c (push_lisp_string_as_unicode):
* dialog-msw.c (handle_directory_dialog_box):
* dialog-msw.c (handle_file_dialog_box):
* dialog-x.c (dbox_descriptor_to_widget_value):
* editfns.c (Fformat_time_string):
* editfns.c (Fencode_time):
* editfns.c (Fset_time_zone_rule):
* emacs.c (make_argc_argv):
* emacs.c (Fdump_emacs):
* emodules.c (emodules_load):
* eval.c:
* eval.c (maybe_signal_error_1):
* event-msw.c (Fdde_alloc_advise_item):
* event-msw.c (mswindows_dde_callback):
* event-msw.c (mswindows_wnd_proc):
* fileio.c (report_error_with_errno):
* fileio.c (Fsysnetunam):
* fileio.c (Fdo_auto_save):
* font-mgr.c (extract_fcapi_string):
* font-mgr.c (Ffc_config_app_font_add_file):
* font-mgr.c (Ffc_config_app_font_add_dir):
* font-mgr.c (Ffc_config_filename):
* frame-gtk.c (gtk_set_frame_text_value):
* frame-gtk.c (gtk_create_widgets):
* frame-msw.c (mswindows_init_frame_1):
* frame-msw.c (mswindows_set_title_from_ibyte):
* frame-msw.c (msprinter_init_frame_3):
* frame-x.c (x_set_frame_text_value):
* frame-x.c (x_set_frame_properties):
* frame-x.c (start_drag_internal_1):
* frame-x.c (x_cde_transfer_callback):
* frame-x.c (x_create_widgets):
* glyphs-eimage.c (my_jpeg_output_message):
* glyphs-eimage.c (jpeg_instantiate):
* glyphs-eimage.c (gif_instantiate):
* glyphs-eimage.c (png_instantiate):
* glyphs-eimage.c (tiff_instantiate):
* glyphs-gtk.c (xbm_instantiate_1):
* glyphs-gtk.c (gtk_xbm_instantiate):
* glyphs-gtk.c (gtk_xpm_instantiate):
* glyphs-gtk.c (gtk_xface_instantiate):
* glyphs-gtk.c (cursor_font_instantiate):
* glyphs-gtk.c (gtk_redisplay_widget):
* glyphs-gtk.c (gtk_widget_instantiate_1):
* glyphs-gtk.c (gtk_add_tab_item):
* glyphs-msw.c (mswindows_xpm_instantiate):
* glyphs-msw.c (bmp_instantiate):
* glyphs-msw.c (mswindows_resource_instantiate):
* glyphs-msw.c (xbm_instantiate_1):
* glyphs-msw.c (mswindows_xbm_instantiate):
* glyphs-msw.c (mswindows_xface_instantiate):
* glyphs-msw.c (mswindows_redisplay_widget):
* glyphs-msw.c (mswindows_widget_instantiate):
* glyphs-msw.c (add_tree_item):
* glyphs-msw.c (add_tab_item):
* glyphs-msw.c (mswindows_combo_box_instantiate):
* glyphs-msw.c (mswindows_widget_query_string_geometry):
* glyphs-x.c (x_locate_pixmap_file):
* glyphs-x.c (xbm_instantiate_1):
* glyphs-x.c (x_xbm_instantiate):
* glyphs-x.c (extract_xpm_color_names):
* glyphs-x.c (x_xpm_instantiate):
* glyphs-x.c (x_xface_instantiate):
* glyphs-x.c (autodetect_instantiate):
* glyphs-x.c (safe_XLoadFont):
* glyphs-x.c (cursor_font_instantiate):
* glyphs-x.c (x_redisplay_widget):
* glyphs-x.c (Fchange_subwindow_property):
* glyphs-x.c (x_widget_instantiate):
* glyphs-x.c (x_tab_control_redisplay):
* glyphs.c (pixmap_to_lisp_data):
* gui-x.c (menu_separator_style_and_to_external):
* gui-x.c (add_accel_and_to_external):
* gui-x.c (button_item_to_widget_value):
* hpplay.c (player_error_internal):
* hpplay.c (play_sound_file):
* hpplay.c (play_sound_data):
* intl.c (Fset_current_locale):
* lisp.h:
* menubar-gtk.c (gtk_xemacs_set_accel_keys):
* menubar-msw.c (populate_menu_add_item):
* menubar-msw.c (populate_or_checksum_helper):
* menubar-x.c (menu_item_descriptor_to_widget_value_1):
* nt.c (init_user_info):
* nt.c (get_long_basename):
* nt.c (nt_get_resource):
* nt.c (init_mswindows_environment):
* nt.c (get_cached_volume_information):
* nt.c (mswindows_readdir):
* nt.c (read_unc_volume):
* nt.c (mswindows_stat):
* nt.c (mswindows_getdcwd):
* nt.c (mswindows_executable_type):
* nt.c (Fmswindows_short_file_name):
* ntplay.c (nt_play_sound_file):
* objects-gtk.c:
* objects-gtk.c (gtk_valid_color_name_p):
* objects-gtk.c (gtk_initialize_font_instance):
* objects-gtk.c (gtk_font_list):
* objects-msw.c (font_enum_callback_2):
* objects-msw.c (parse_font_spec):
* objects-x.c (x_parse_nearest_color):
* objects-x.c (x_valid_color_name_p):
* objects-x.c (x_initialize_font_instance):
* objects-x.c (x_font_instance_truename):
* objects-x.c (x_font_list):
* objects-xlike-inc.c (XFUN):
* objects-xlike-inc.c (xft_find_charset_font):
* process-nt.c (mswindows_report_winsock_error):
* process-nt.c (nt_create_process):
* process-nt.c (get_internet_address):
* process-nt.c (nt_open_network_stream):
* process-unix.c:
* process-unix.c (allocate_pty):
* process-unix.c (get_internet_address):
* process-unix.c (unix_canonicalize_host_name):
* process-unix.c (unix_open_network_stream):
* realpath.c:
* select-common.h (lisp_data_to_selection_data):
* select-gtk.c (symbol_to_gtk_atom):
* select-gtk.c (atom_to_symbol):
* select-msw.c (symbol_to_ms_cf):
* select-msw.c (mswindows_register_selection_data_type):
* select-x.c (symbol_to_x_atom):
* select-x.c (x_atom_to_symbol):
* select-x.c (hack_motif_clipboard_selection):
* select-x.c (Fx_store_cutbuffer_internal):
* sound.c (Fplay_sound_file):
* sound.c (Fplay_sound):
* sound.h (sound_perror):
* sysdep.c:
* sysdep.c (qxe_allocating_getcwd):
* sysdep.c (qxe_execve):
* sysdep.c (copy_in_passwd):
* sysdep.c (qxe_getpwnam):
* sysdep.c (qxe_ctime):
* sysdll.c (dll_open):
* sysdll.c (dll_function):
* sysdll.c (dll_variable):
* sysdll.c (search_linked_libs):
* sysdll.c (dll_error):
* sysfile.h:
* sysfile.h (PATHNAME_CONVERT_OUT_TSTR):
* sysfile.h (PATHNAME_CONVERT_OUT_UTF_8):
* sysfile.h (PATHNAME_CONVERT_OUT):
* sysfile.h (LISP_PATHNAME_CONVERT_OUT):
* syswindows.h (ITEXT_TO_TSTR):
* syswindows.h (LOCAL_FILE_FORMAT_TO_TSTR):
* syswindows.h (TSTR_TO_LOCAL_FILE_FORMAT):
* syswindows.h (LOCAL_FILE_FORMAT_TO_INTERNAL_MSWIN):
* syswindows.h (LISP_LOCAL_FILE_FORMAT_MAYBE_URL_TO_TSTR):
* text.h:
* text.h (eicpy_ext_len):
* text.h (enum new_dfc_src_type):
* text.h (EXTERNAL_TO_ITEXT):
* text.h (GET_STRERROR):
* tooltalk.c (check_status):
* tooltalk.c (Fadd_tooltalk_message_arg):
* tooltalk.c (Fadd_tooltalk_pattern_attribute):
* tooltalk.c (Fadd_tooltalk_pattern_arg):
* win32.c (tstr_to_local_file_format):
* win32.c (mswindows_lisp_error_1):
* win32.c (mswindows_report_process_error):
* win32.c (Fmswindows_shell_execute):
* win32.c (mswindows_read_link_1):
Changes involving external/internal format conversion,
mostly code cleanup and renaming.
1. Eliminate the previous macros like LISP_STRING_TO_EXTERNAL
that stored its result in a parameter. The new version of
LISP_STRING_TO_EXTERNAL returns its result through the
return value, same as the previous NEW_LISP_STRING_TO_EXTERNAL.
Use the new-style macros throughout the code.
2. Rename C_STRING_TO_EXTERNAL and friends to ITEXT_TO_EXTERNAL,
in keeping with overall naming rationalization involving
Itext and related types.
Macros involved in previous two:
EXTERNAL_TO_C_STRING -> EXTERNAL_TO_ITEXT
EXTERNAL_TO_C_STRING_MALLOC -> EXTERNAL_TO_ITEXT_MALLOC
SIZED_EXTERNAL_TO_C_STRING -> SIZED_EXTERNAL_TO_ITEXT
SIZED_EXTERNAL_TO_C_STRING_MALLOC -> SIZED_EXTERNAL_TO_ITEXT_MALLOC
C_STRING_TO_EXTERNAL -> ITEXT_TO_EXTERNAL
C_STRING_TO_EXTERNAL_MALLOC -> ITEXT_TO_EXTERNAL_MALLOC
LISP_STRING_TO_EXTERNAL
LISP_STRING_TO_EXTERNAL_MALLOC
LISP_STRING_TO_TSTR
C_STRING_TO_TSTR -> ITEXT_TO_TSTR
TSTR_TO_C_STRING -> TSTR_TO_ITEXT
The following four still return their values through parameters,
since they have more than one value to return:
C_STRING_TO_SIZED_EXTERNAL -> ITEXT_TO_SIZED_EXTERNAL
LISP_STRING_TO_SIZED_EXTERNAL
C_STRING_TO_SIZED_EXTERNAL_MALLOC -> ITEXT_TO_SIZED_EXTERNAL_MALLOC
LISP_STRING_TO_SIZED_EXTERNAL_MALLOC
Sometimes additional casts had to be inserted, since the old
macros played strange games and completely defeated the type system
of the store params.
3. Rewrite many places where direct calls to TO_EXTERNAL_FORMAT
occurred with calls to one of the convenience macros listed above,
or to make_extstring().
4. Eliminate SIZED_C_STRING macros (they were hardly used, anyway)
and use a direct call to TO_EXTERNAL_FORMAT or TO_INTERNAL_FORMAT.
4. Use LISP_PATHNAME_CONVERT_OUT in many places instead of something
like LISP_STRING_TO_EXTERNAL(..., Qfile_name).
5. Eliminate some temporary variables that are no longer necessary
now that we return a value rather than storing it into a variable.
6. Some Mule-izing in database.c.
7. Error functions:
-- A bit of code cleanup in maybe_signal_error_1.
-- Eliminate report_file_type_error; it's just an alias for
signal_error_2 with params in a different order.
-- Fix some places in the hostname-handling code that directly
inserted externally-retrieved error strings into the
supposed ASCII "reason" param instead of doing the right thing
and sticking text descriptive of what was going on in "reason"
and putting the external message in a frob.
8. Use Ascbyte instead of CIbyte in process-unix.c and maybe one
or two other places.
9. Some code cleanup in copy_in_passwd() in sysdep.c.
10. Fix a real bug due to accidental variable shadowing in
tstr_to_local_file_format() in win32.c.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Fri, 05 Feb 2010 11:02:24 -0600 |
| parents | 6e9bd19ec103 |
| children | 5502045ec510 |
| rev | line source |
|---|---|
| 428 | 1 ;;; objects.el --- Lisp interface to C window-system objects |
| 2 | |
| 3 ;; Copyright (C) 1994, 1997 Free Software Foundation, Inc. | |
| 4 ;; Copyright (C) 1995 Ben Wing | |
| 5 | |
| 6 ;; Author: Chuck Thompson <cthomp@xemacs.org> | |
| 7 ;; Author: Ben Wing <ben@xemacs.org> | |
| 8 ;; Maintainer: XEmacs Development Team | |
| 9 ;; Keywords: faces, 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 ;;; Code: | |
| 35 | |
| 36 (defun ws-object-property-1 (function object domain &optional matchspec) | |
| 37 (let ((instance (if matchspec | |
| 38 (specifier-matching-instance object matchspec domain) | |
| 39 (specifier-instance object domain)))) | |
| 40 (and instance (funcall function instance)))) | |
| 41 | |
| 42 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; font specifiers | |
| 43 | |
| 44 (defun make-font-specifier (spec-list) | |
| 45 "Return a new `font' specifier object with the given specification list. | |
| 46 SPEC-LIST can be a list of specifications (each of which is a cons of a | |
| 47 locale and a list of instantiators), a single instantiator, or a list | |
| 48 of instantiators. See `make-specifier' for more information about | |
| 442 | 49 specifiers. |
| 50 | |
| 51 Valid instantiators for font specifiers are: | |
| 52 | |
| 3111 | 53 -- a string naming a font; syntax is platform dependent. Some examples for |
| 54 a 14-point upright medium-weight Courier font: | |
| 55 X11 (and GTK1): \"-*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-*\" | |
| 56 Xft (and GTK2): \"Courier-14\" | |
| 57 MS-Windows: \"Courier:14:Western\" | |
| 442 | 58 -- a font instance (use that instance directly if the device matches, |
| 59 or use the string that generated it) | |
| 60 -- a vector of no elements (only on TTY's; this means to set no font | |
| 61 at all, thus using the \"natural\" font of the terminal's text) | |
| 62 -- a vector of one element (a face to inherit from) | |
| 63 " | |
| 428 | 64 (make-specifier-and-init 'font spec-list)) |
| 65 | |
| 66 (defun font-name (font &optional domain charset) | |
| 67 "Return the name of the FONT in the specified DOMAIN, if any. | |
| 68 FONT should be a font specifier object and DOMAIN is normally a window | |
| 69 and defaults to the selected window if omitted. This is equivalent | |
| 70 to using `specifier-instance' and applying `font-instance-name' to | |
| 71 the result. See `make-specifier' for more information about specifiers." | |
| 72 (ws-object-property-1 'font-instance-name font domain charset)) | |
| 73 | |
| 74 (defun font-ascent (font &optional domain charset) | |
| 75 "Return the ascent of the FONT in the specified DOMAIN, if any. | |
| 76 FONT should be a font specifier object and DOMAIN is normally a window | |
| 77 and defaults to the selected window if omitted. This is equivalent | |
| 78 to using `specifier-instance' and applying `font-instance-ascent' to | |
| 79 the result. See `make-specifier' for more information about specifiers." | |
| 80 (ws-object-property-1 'font-instance-ascent font domain charset)) | |
| 81 | |
| 82 (defun font-descent (font &optional domain charset) | |
| 83 "Return the descent of the FONT in the specified DOMAIN, if any. | |
| 84 FONT should be a font specifier object and DOMAIN is normally a window | |
| 85 and defaults to the selected window if omitted. This is equivalent | |
| 86 to using `specifier-instance' and applying `font-instance-descent' to | |
| 87 the result. See `make-specifier' for more information about specifiers." | |
| 88 (ws-object-property-1 'font-instance-descent font domain charset)) | |
| 89 | |
| 90 (defun font-width (font &optional domain charset) | |
| 91 "Return the width of the FONT in the specified DOMAIN, if any. | |
| 92 FONT should be a font specifier object and DOMAIN is normally a window | |
| 93 and defaults to the selected window if omitted. This is equivalent | |
| 94 to using `specifier-instance' and applying `font-instance-width' to | |
| 95 the result. See `make-specifier' for more information about specifiers." | |
| 96 (ws-object-property-1 'font-instance-width font domain charset)) | |
| 97 | |
| 98 (defun font-height (font &optional domain charset) | |
| 99 "Return the height of the FONT in the specified DOMAIN, if any. | |
| 100 FONT should be a font specifier object and DOMAIN is normally a window | |
| 101 and defaults to the selected window if omitted. This is equivalent | |
| 102 to using `specifier-instance' and applying `font-instance-height' to | |
| 103 the result. See `make-specifier' for more information about specifiers." | |
| 104 (ws-object-property-1 'font-instance-height font domain charset)) | |
| 105 | |
| 106 (defun font-proportional-p (font &optional domain charset) | |
| 107 "Return whether FONT is proportional in the specified DOMAIN, if known. | |
| 108 FONT should be a font specifier object and DOMAIN is normally a window | |
| 109 and defaults to the selected window if omitted. This is equivalent | |
| 110 to using `specifier-instance' and applying `font-instance-proportional-p' to | |
| 111 the result. See `make-specifier' for more information about specifiers." | |
| 112 (ws-object-property-1 'font-instance-proportional-p font domain charset)) | |
| 113 | |
| 114 (defun font-properties (font &optional domain charset) | |
| 115 "Return the properties of the FONT in the specified DOMAIN, if any. | |
| 116 FONT should be a font specifier object and DOMAIN is normally a window | |
| 117 and defaults to the selected window if omitted. This is equivalent | |
| 118 to using `specifier-instance' and applying `font-instance-properties' | |
| 119 to the result. See `make-specifier' for more information about specifiers." | |
| 120 (ws-object-property-1 'font-instance-properties font domain charset)) | |
| 121 | |
| 122 (defun font-truename (font &optional domain charset) | |
| 123 "Return the truename of the FONT in the specified DOMAIN, if any. | |
| 124 FONT should be a font specifier object and DOMAIN is normally a window | |
| 125 and defaults to the selected window if omitted. This is equivalent | |
| 126 to using `specifier-instance' and applying `font-instance-truename' | |
| 127 to the result. See `make-specifier' for more information about specifiers." | |
| 128 (ws-object-property-1 'font-instance-truename font domain charset)) | |
| 129 | |
| 130 (defun font-instance-height (font-instance) | |
| 131 "Return the height in pixels of FONT-INSTANCE. | |
| 132 The returned value is the maximum height for all characters in the font,\n\ | |
| 133 and is equivalent to the sum of the font instance's ascent and descent." | |
| 134 (+ (font-instance-ascent font-instance) | |
| 135 (font-instance-descent font-instance))) | |
| 136 | |
| 137 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; color specifiers | |
| 138 | |
| 139 (defun make-color-specifier (spec-list) | |
| 140 "Return a new `color' specifier object with the given specification list. | |
| 141 SPEC-LIST can be a list of specifications (each of which is a cons of a | |
| 142 locale and a list of instantiators), a single instantiator, or a list | |
| 143 of instantiators. See `make-specifier' for a detailed description of | |
| 442 | 144 how specifiers work. |
| 145 | |
| 146 Valid instantiators for color specifiers are: | |
| 147 | |
| 148 -- a string naming a color (e.g. under X this might be \"lightseagreen2\" | |
| 149 or \"#F534B2\") | |
| 150 -- a color instance (use that instance directly if the device matches, | |
| 151 or use the string that generated it) | |
| 152 -- a vector of no elements (only on TTY's; this means to set no color | |
| 153 at all, thus using the \"natural\" color of the terminal's text) | |
| 154 -- a vector of one or two elements: a face to inherit from, and | |
| 155 optionally a symbol naming which property of that face to inherit, | |
| 156 either `foreground' or `background' (if omitted, defaults to the same | |
| 157 property that this color specifier is used for; if this specifier is | |
| 158 not part of a face, the instantiator would not be valid)." | |
| 428 | 159 (make-specifier-and-init 'color spec-list)) |
| 160 | |
| 161 (defun color-name (color &optional domain) | |
| 162 "Return the name of the COLOR in the specified DOMAIN, if any. | |
| 163 COLOR should be a color specifier object and DOMAIN is normally a window | |
| 164 and defaults to the selected window if omitted. This is equivalent | |
| 165 to using `specifier-instance' and applying `color-instance-name' to | |
| 166 the result. See `make-specifier' for more information about specifiers." | |
| 167 (ws-object-property-1 'color-instance-name color domain)) | |
| 168 | |
| 169 (defun color-rgb-components (color &optional domain) | |
| 170 "Return the RGB components of the COLOR in the specified DOMAIN, if any. | |
| 171 COLOR should be a color specifier object and DOMAIN is normally a window | |
| 172 and defaults to the selected window if omitted. This is equivalent | |
| 173 to using `specifier-instance' and applying `color-instance-rgb-components' | |
| 174 to the result. See `make-specifier' for more information about specifiers." | |
| 175 (ws-object-property-1 'color-instance-rgb-components color domain)) | |
| 176 | |
| 442 | 177 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; face-boolean specifiers |
| 178 | |
| 179 (defun make-face-boolean-specifier (spec-list) | |
| 180 "Return a new `face-boolean' specifier object with the given spec list. | |
| 181 SPEC-LIST can be a list of specifications (each of which is a cons of a | |
| 182 locale and a list of instantiators), a single instantiator, or a list | |
| 183 of instantiators. See `make-specifier' for a detailed description of | |
| 184 how specifiers work. | |
| 185 | |
| 186 Valid instantiators for face-boolean specifiers are | |
| 187 | |
| 188 -- t or nil | |
| 4201 | 189 -- a vector of one, two or three elements: a face to inherit from, |
| 442 | 190 optionally a symbol naming the property of that face to inherit from |
| 191 (if omitted, defaults to the same property that this face-boolean | |
| 192 specifier is used for; if this specifier is not part of a face, | |
| 193 the instantiator would not be valid), and optionally a value which, | |
| 194 if non-nil, means to invert the sense of the inherited property." | |
| 4201 | 195 (make-specifier-and-init 'face-boolean spec-list)) |
| 442 | 196 |
| 428 | 197 ;;; objects.el ends here. |