annotate lisp/wid-browse.el @ 4953:304aebb79cd3

function renamings to track names of char typedefs -------------------- ChangeLog entries follow: -------------------- man/ChangeLog addition: 2010-01-27 Ben Wing <ben@xemacs.org> * internals/internals.texi (lrecords): * internals/internals.texi (The DFC API): * internals/internals.texi (Conversion to and from External Data): * internals/internals.texi (Mule-izing Code): * internals/internals.texi (Pervasive changes throughout XEmacs sources): * internals/internals.texi (Ben's README): * internals/internals.texi (Future Work -- Localized Text/Messages): * emodules.texi (Defining Variables): Rename: write_c_string -> write_cistring build_intstring -> build_istring build_string -> build_cistring build_ext_string -> build_extstring make_ext_string -> make_extstring buffer_insert_c_string -> buffer_insert_ascstring intern_int -> intern_istring See comment in src/ChangeLog about this. modules/ChangeLog addition: 2010-01-27 Ben Wing <ben@xemacs.org> * postgresql/postgresql.c (print_pgconn): * postgresql/postgresql.c (print_pgresult): * postgresql/postgresql.c (Fpq_conn_defaults): * postgresql/postgresql.c (Fpq_pgconn): * postgresql/postgresql.c (Fpq_res_status): * postgresql/postgresql.c (Fpq_result_error_message): * postgresql/postgresql.c (Fpq_fname): * postgresql/postgresql.c (Fpq_get_value): * postgresql/postgresql.c (Fpq_cmd_status): * postgresql/postgresql.c (Fpq_cmd_tuples): * postgresql/postgresql.c (Fpq_notifies): * postgresql/postgresql.c (Fpq_get_line): * postgresql/postgresql.c (Fpq_get_line_async): * postgresql/postgresql.c (FROB): * postgresql/postgresql.c (init_postgresql_from_environment): * ldap/eldap.c: * ldap/eldap.c (Fldap_open): * ldap/eldap.c (Fldap_search_basic): * canna/canna_api.c: * canna/canna_api.c (make_euc_string): Rename: write_c_string -> write_cistring build_intstring -> build_istring build_string -> build_cistring build_ext_string -> build_extstring make_ext_string -> make_extstring buffer_insert_c_string -> buffer_insert_ascstring intern_int -> intern_istring See comment in src/ChangeLog about this. src/ChangeLog addition: 2010-01-27 Ben Wing <ben@xemacs.org> * .gdbinit.in.in: * README: * abbrev.c (write_abbrev): * abbrev.c (describe_abbrev): * alloc.c (make_extstring): * alloc.c (build_istring): * alloc.c (build_cistring): * alloc.c (build_ascstring): * alloc.c (build_extstring): * alloc.c (build_msg_istring): * alloc.c (build_defer_istring): * buffer.c (Fgenerate_new_buffer_name): * buffer.c (init_buffer_2): * console-tty.c (tty_init_console): * console-x.c (get_display_arg_connection): * console-x.c (x_perhaps_init_unseen_key_defaults): * database.c (dbm_map): * database.c (dbm_get): * database.c (berkdb_get): * database.c (berkdb_map): * device-gtk.c (FROB_PIXMAP): * device-gtk.c (Fgtk_style_info): * device-msw.c (msprinter_default_printer): * device-msw.c (sync_printer_with_devmode): * device-x.c (coding_system_of_xrm_database): * device-x.c (x_init_device): * device-x.c (signal_if_x_error): * device-x.c (Fx_get_resource): * device-x.c (Fx_server_vendor): * device-x.c (Fx_get_font_path): * dialog-x.c (maybe_run_dbox_text_callback): * doc.c (extract_object_file_name): * doc.c (unparesseuxify_doc_string): * doc.c (get_doc_string): * doc.c (get_object_file_name): * doc.c (Fdocumentation): * doc.c (Fsnarf_documentation): * doc.c (Fsubstitute_command_keys): * editfns.c (init_editfns): * editfns.c (Ftemp_directory): * editfns.c (Fuser_login_name): * editfns.c (Fuser_real_login_name): * editfns.c (Fuser_home_directory): * editfns.c (Fformat_time_string): * editfns.c (Fcurrent_time_string): * editfns.c (Fcurrent_time_zone): * emacs.c: * emacs.c (main_1): * emodules.c (Flist_modules): * emodules.c (emodules_load): * emodules.c (emodules_doc_sym): * emodules.c (vars_of_module): * event-Xt.c (x_has_keysym): * event-gtk.c (emacs_gtk_format_magic_event): * event-gtk.c (dragndrop_data_received): * event-gtk.c (gtk_reset_key_mapping): * event-msw.c (mswindows_dde_callback): * event-msw.c (mswindows_wnd_proc): * faces.c (complex_vars_of_faces): * file-coding.c (find_coding_system): * file-coding.c (setup_eol_coding_systems): * file-coding.c (make_coding_system_1): * file-coding.c (snarf_coding_system): * fileio.c: * fileio.c (lisp_strerror): * fileio.c (Ffile_name_directory): * fileio.c (Ffile_name_as_directory): * fileio.c (Fdirectory_file_name): * fileio.c (if): * fileio.c (Ffile_symlink_p): * fileio.c (Fencrypt_string): * fileio.c (Fdecrypt_string): * filelock.c (lock_file): * filelock.c (Ffile_locked_p): * floatfns.c (matherr): * font-mgr.c (build_fcapi_string): * font-mgr.c (make_xlfd_font_regexp): * frame-msw.c (mswindows_window_id): * frame-msw.c (mswindows_frame_property): * frame-x.c: * frame-x.c (color_to_string): * frame-x.c (maybe_set_frame_title_format): * frame-x.c (x_cde_transfer_callback): * frame-x.c (Fx_window_id): * glade.c (connector): * glade.c (Fglade_xml_textdomain): * glade.c (syms_of_glade): * glyphs-eimage.c (jpeg_instantiate): * glyphs-eimage.c (png_instantiate): * glyphs-eimage.c (tiff_instantiate): * glyphs-gtk.c (font_instantiate): * glyphs-gtk.c (BUILD_GLYPH_INST): * glyphs-x.c (x_locate_pixmap_file): * glyphs-x.c (font_instantiate): * glyphs-x.c (x_widget_property): * glyphs-x.c (BUILD_GLYPH_INST): * glyphs.c (print_image_instance): * glyphs.c (bitmap_to_lisp_data): * glyphs.c (pixmap_to_lisp_data): * gpmevent.c (turn_off_gpm): * gpmevent.c (Fgpm_enabled_p): * gpmevent.c (Fgpm_enable): * gtk-glue.c (__make_string_mapper): * gtk-glue.c (xemacs_gtklist_to_list): * gtk-xemacs.c (FROB_FACE): * gtk-xemacs.c (xemacs_gtk_convert_color): * hpplay.c (player_error_internal): * hpplay.c (myHandler): * insdel.c (buffer_insert_ascstring_1): * insdel.h: * insdel.h (buffer_insert_ascstring): * intl.c (Fcurrent_locale): * intl.c (Fset_current_locale): * keymap.c (make_key_description): * keymap.c (Ftext_char_description): * keymap.c (describe_command): * keymap.c (describe_map): * lisp.h: * lread.c: * lread.c (locate_file_in_directory_mapper): * lread.c (locate_file_construct_suffixed_files_mapper): * mule-charset.c (Fmake_charset): * nt.c (Fmswindows_short_file_name): * nt.c (Fmswindows_long_file_name): * objects-gtk.c (__get_gtk_font_truename): * objects-gtk.c (__gtk_font_list_internal): * objects-msw.c (font_enum_callback_2): * objects-msw.c (create_hfont_from_font_spec): * objects-msw.c (mswindows_font_list): * objects-msw.c (mswindows_font_spec_matches_charset_stage_2): * objects-tty.c (tty_initialize_font_instance): * objects-x.c (x_font_truename): * objects-x.c (x_font_instance_truename): * objects-x.c (x_font_instance_properties): * objects-x.c (x_font_list): * print.c (write_cistring): * print.c (print_vector_internal): * print.c (print_cons): * process-nt.c (nt_canonicalize_host_name): * process-unix.c (unix_create_process): * process-unix.c (unix_canonicalize_host_name): * process.c (status_message): * process.c (status_notify): * process.c (init_xemacs_process): * process.c (syms_of_process): * redisplay-tty.c (term_get_fkeys_1): * redisplay-tty.c (CONDITIONAL_REASSIGN): * search.c (compile_pattern_1): * select-common.h (selection_data_to_lisp_data): * select-gtk.c (atom_to_symbol): * select-gtk.c (PROCESSING_GTK_CODE): * select-msw.c (mswindows_get_foreign_selection): * select-x.c (x_atom_to_symbol): * select-x.c (Fx_get_cutbuffer_internal): * symbols.c (intern_istring): * symbols.c (intern): * symbols.c (intern_converting_underscores_to_dashes): * symbols.c (Fintern): * sysdep.c (init_system_name): * sysdll.c (dll_error): * sysdll.c (dll_open): * syswindows.h: * syswindows.h (build_tstr_string): * tests.c (DFC_CHECK_LENGTH): * tests.c (DFC_CHECK_CONTENT): * tests.c (DFC_RESULT_PASS): * tests.c (Ftest_data_format_conversion): * text.c: * text.c (new_dfc_convert_now_damn_it): * text.h: * text.h (build_wext_string): * tooltalk.c (tt_build_c_string): * tooltalk.c (Ftooltalk_default_procid): * tooltalk.c (Ftooltalk_default_session): * tooltalk.c (init_tooltalk): * ui-byhand.c (Fgtk_clist_get_text): * ui-byhand.c (Fgtk_clist_get_pixtext): * ui-byhand.c (Fgtk_label_get): * ui-byhand.c (Fgtk_notebook_query_tab_label_packing): * ui-gtk.c (emacs_gtk_object_printer): * ui-gtk.c (emacs_gtk_boxed_printer): * ui-gtk.c (gtk_type_to_lisp): * ui-gtk.c (symbol_to_enum): * ui-gtk.c (enum_to_symbol): * unexaix.c (report_error): * unexaix.c (ERROR0): * unexec.c (report_error): * unexec.c (ERROR0): * unicode.c (unicode_to_ichar): * win32.c (tstr_to_local_file_format): * win32.c (Fmswindows_cygwin_to_win32_path): * win32.c (struct read_link_hash): * xemacs.def.in.in: Rename: write_c_string -> write_cistring build_intstring -> build_istring build_string -> build_cistring build_ext_string -> build_extstring make_ext_string -> make_extstring buffer_insert_c_string -> buffer_insert_ascstring intern_int -> intern_istring These functions have been renamed so that the naming harmonizes with the typedefs for strings: `cistring' along with CIbyte *, `istring' along with Ibyte *, `extstring' along with Extbyte *, `ascstring' along with Ascbyte *. Also make buffer_insert_ascstring take Ascbyte * and assert that its argument is ASCII.
author Ben Wing <ben@xemacs.org>
date Wed, 27 Jan 2010 00:35:36 -0600
parents 023b83f4e54b
children 308d34e9f07d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
1 ;;; wid-browse.el --- Functions for browsing widgets.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
2 ;;
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
3 ;; Copyright (C) 1997 Free Software Foundation, Inc.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
4 ;;
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
5 ;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
6 ;; Keywords: extensions
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
7 ;; Version: 1.9960
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
8 ;; X-URL: http://www.dina.kvl.dk/~abraham/custom/
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
9
613
023b83f4e54b [xemacs-hg @ 2001-06-10 10:42:16 by ben]
ben
parents: 502
diff changeset
10 ;; This file is part of XEmacs.
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
11
613
023b83f4e54b [xemacs-hg @ 2001-06-10 10:42:16 by ben]
ben
parents: 502
diff changeset
12 ;; XEmacs is free software; you can redistribute it and/or modify
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
13 ;; it under the terms of the GNU General Public License as published by
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
14 ;; the Free Software Foundation; either version 2, or (at your option)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
15 ;; any later version.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
16
613
023b83f4e54b [xemacs-hg @ 2001-06-10 10:42:16 by ben]
ben
parents: 502
diff changeset
17 ;; XEmacs is distributed in the hope that it will be useful,
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
20 ;; GNU General Public License for more details.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
21
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
22 ;; You should have received a copy of the GNU General Public License
613
023b83f4e54b [xemacs-hg @ 2001-06-10 10:42:16 by ben]
ben
parents: 502
diff changeset
23 ;; along with XEmacs; see the file COPYING. If not, write to the
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
25 ;; Boston, MA 02111-1307, USA.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
26
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
27 ;;; Commentary:
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
28 ;;
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
29 ;; Widget browser. See `widget.el'.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
30
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
31 ;;; Code:
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
32
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
33 (require 'easymenu)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
34 (require 'custom)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
35 (require 'wid-edit)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
36 (eval-when-compile (require 'cl))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
37
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
38 (defgroup widget-browse nil
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
39 "Customization support for browsing widgets."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
40 :group 'widgets)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
41
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
42 ;;; The Mode.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
43
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
44 (defvar widget-browse-mode-map nil
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
45 "Keymap for `widget-browse-mode'.")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
46
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
47 (unless widget-browse-mode-map
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
48 (setq widget-browse-mode-map (make-sparse-keymap))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
49 (set-keymap-parent widget-browse-mode-map widget-keymap)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
50 (define-key widget-browse-mode-map "q" 'bury-buffer))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
51
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
52 (easy-menu-define widget-browse-mode-customize-menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
53 widget-browse-mode-map
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
54 "Menu used in widget browser buffers."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
55 (customize-menu-create 'widgets))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
56
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
57 (easy-menu-define widget-browse-mode-menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
58 widget-browse-mode-map
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
59 "Menu used in widget browser buffers."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
60 '("Widget"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
61 ["Browse" widget-browse t]
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
62 ["Browse At" widget-browse-at t]))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
63
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
64 (defcustom widget-browse-mode-hook nil
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
65 "Hook called when entering widget-browse-mode."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
66 :type 'hook
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
67 :group 'widget-browse)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
68
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
69 (defun widget-browse-mode ()
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
70 "Major mode for widget browser buffers.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
71
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
72 The following commands are available:
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
73
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
74 \\[widget-forward] Move to next button or editable field.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
75 \\[widget-backward] Move to previous button or editable field.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
76 \\[widget-button-click] Activate button under the mouse pointer.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
77 \\[widget-button-press] Activate button under point.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
78
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
79 Entry to this mode calls the value of `widget-browse-mode-hook'
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
80 if that value is non-nil."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
81 (kill-all-local-variables)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
82 (setq major-mode 'widget-browse-mode
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
83 mode-name "Widget")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
84 (use-local-map widget-browse-mode-map)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
85 (easy-menu-add widget-browse-mode-customize-menu)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
86 (easy-menu-add widget-browse-mode-menu)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
87 (run-hooks 'widget-browse-mode-hook))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
88
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
89 ;;; Commands.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
90
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
91 ;;;###autoload
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
92 (defun widget-browse-at (pos)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
93 "Browse the widget under point."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
94 (interactive "d")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
95 (let* ((field (get-char-property pos 'field))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
96 (button (get-char-property pos 'button))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
97 (doc (get-char-property pos 'widget-doc))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
98 (text (cond (field "This is an editable text area.")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
99 (button "This is an active area.")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
100 (doc "This is documentation text.")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
101 (t "This is unidentified text.")))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
102 (widget (or field button doc)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
103 (when widget
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
104 (widget-browse widget))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
105 (message text)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
106
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
107 (defvar widget-browse-history nil)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
108
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
109 ;;;###autoload
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
110 (defun widget-browse (widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
111 "Create a widget browser for WIDGET."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
112 (interactive (list (completing-read "Widget: "
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
113 obarray
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
114 (lambda (symbol)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
115 (get symbol 'widget-type))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
116 t nil 'widget-browse-history)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
117 (if (stringp widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
118 (setq widget (intern widget)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
119 (unless (if (symbolp widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
120 (get widget 'widget-type)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
121 (and (consp widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
122 (get (widget-type widget) 'widget-type)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
123 (error "Not a widget."))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
124 ;; Create the buffer.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
125 (if (symbolp widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
126 (let ((buffer (format "*Browse %s Widget*" widget)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
127 (kill-buffer (get-buffer-create buffer))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
128 (switch-to-buffer (get-buffer-create buffer)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
129 (kill-buffer (get-buffer-create "*Browse Widget*"))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
130 (switch-to-buffer (get-buffer-create "*Browse Widget*")))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
131 (widget-browse-mode)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
132
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
133 ;; Quick way to get out.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
134 ;; (widget-create 'push-button
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
135 ;; :action (lambda (widget &optional event)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
136 ;; (bury-buffer))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
137 ;; "Quit")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
138 ;; (widget-insert "\n")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
139
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
140 ;; Top text indicating whether it is a class or object browser.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
141 (if (listp widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
142 (widget-insert "Widget object browser.\n\nClass: ")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
143 (widget-insert "Widget class browser.\n\n")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
144 (widget-create 'widget-browse
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
145 :format "%[%v%]\n%d"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
146 :doc (get widget 'widget-documentation)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
147 widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
148 (unless (eq (preceding-char) ?\n)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
149 (widget-insert "\n"))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
150 (widget-insert "\nSuper: ")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
151 (setq widget (get widget 'widget-type)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
152
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
153 ;; Now show the attributes.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
154 (let ((name (car widget))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
155 (items (cdr widget))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
156 key value printer)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
157 (widget-create 'widget-browse
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
158 :format "%[%v%]"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
159 name)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
160 (widget-insert "\n")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
161 (while items
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
162 (setq key (nth 0 items)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
163 value (nth 1 items)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
164 printer (or (get key 'widget-keyword-printer)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
165 'widget-browse-sexp)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
166 items (cdr (cdr items)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
167 (widget-insert "\n" (symbol-name key) "\n\t")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
168 (funcall printer widget key value)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
169 (widget-insert "\n")))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
170 (widget-setup)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
171 (goto-char (point-min)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
172
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
173 ;;;###autoload
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
174 (defun widget-browse-other-window (&optional widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
175 "Show widget browser for WIDGET in other window."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
176 (interactive)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
177 (let ((window (selected-window)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
178 (switch-to-buffer-other-window "*Browse Widget*")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
179 (if widget
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
180 (widget-browse widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
181 (call-interactively 'widget-browse))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
182 (select-window window)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
183
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
184
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
185 ;;; The `widget-browse' Widget.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
186
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
187 (define-widget 'widget-browse 'push-button
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
188 "Button for creating a widget browser.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
189 The :value of the widget shuld be the widget to be browsed."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
190 :format "%[[%v]%]"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
191 :value-create 'widget-browse-value-create
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
192 :action 'widget-browse-action)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
193
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
194 (defun widget-browse-action (widget &optional event)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
195 ;; Create widget browser for WIDGET's :value.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
196 (widget-browse (widget-get widget :value)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
197
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
198 (defun widget-browse-value-create (widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
199 ;; Insert type name.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
200 (let ((value (widget-get widget :value)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
201 (cond ((symbolp value)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
202 (insert (symbol-name value)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
203 ((consp value)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
204 (insert (symbol-name (widget-type value))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
205 (t
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
206 (insert "strange")))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
207
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
208 ;;; Keyword Printer Functions.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
210 (defun widget-browse-widget (widget key value)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
211 "Insert description of WIDGET's KEY VALUE.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
212 VALUE is assumed to be a widget."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
213 (widget-create 'widget-browse value))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
214
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
215 (defun widget-browse-widgets (widget key value)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
216 "Insert description of WIDGET's KEY VALUE.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
217 VALUE is assumed to be a list of widgets."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
218 (while value
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
219 (widget-create 'widget-browse
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
220 (car value))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
221 (setq value (cdr value))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
222 (when value
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
223 (widget-insert " "))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
224
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
225 (defun widget-browse-sexp (widget key value)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
226 "Insert description of WIDGET's KEY VALUE.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
227 Nothing is assumed about value."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
228 (let ((pp (condition-case signal
502
7039e6323819 [xemacs-hg @ 2001-05-04 22:41:46 by ben]
ben
parents: 209
diff changeset
229 (declare-fboundp (pp-to-string value))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
230 (error (prin1-to-string signal)))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
231 (when (string-match "\n\\'" pp)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
232 (setq pp (substring pp 0 (1- (length pp)))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
233 (if (cond ((string-match "\n" pp)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
234 nil)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
235 ((> (length pp) (- (window-width) (current-column)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
236 nil)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
237 (t t))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
238 (widget-insert pp)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
239 (widget-create 'push-button
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
240 :tag "show"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
241 :action (lambda (widget &optional event)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
242 (with-output-to-temp-buffer
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
243 "*Pp Eval Output*"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
244 (princ (widget-get widget :value))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
245 pp))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
246
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
247 (defun widget-browse-sexps (widget key value)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
248 "Insert description of WIDGET's KEY VALUE.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
249 VALUE is assumed to be a list of widgets."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
250 (let ((target (current-column)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
251 (while value
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
252 (widget-browse-sexp widget key (car value))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
253 (setq value (cdr value))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
254 (when value
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
255 (widget-insert "\n" (make-string target ?\ ))))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
256
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
257 ;;; Keyword Printers.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
258
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
259 (put :parent 'widget-keyword-printer 'widget-browse-widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
260 (put :children 'widget-keyword-printer 'widget-browse-widgets)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
261 (put :buttons 'widget-keyword-printer 'widget-browse-widgets)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
262 (put :button 'widget-keyword-printer 'widget-browse-widget)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
263 (put :args 'widget-keyword-printer 'widget-browse-sexps)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
264
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
265 ;;; Widget Minor Mode.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
266
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
267 (defvar widget-minor-mode nil
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
268 "I non-nil, we are in Widget Minor Mode.")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
269 (make-variable-buffer-local 'widget-minor-mode)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
270
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
271 (defvar widget-minor-mode-map nil
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
272 "Keymap used in Widget Minor Mode.")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
273
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
274 (unless widget-minor-mode-map
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
275 (setq widget-minor-mode-map (make-sparse-keymap))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
276 (set-keymap-parent widget-minor-mode-map widget-keymap))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
277
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
278 ;;;###autoload
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
279 (defun widget-minor-mode (&optional arg)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
280 "Togle minor mode for traversing widgets.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
281 With arg, turn widget mode on if and only if arg is positive."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
282 (interactive "P")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
283 (cond ((null arg)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
284 (setq widget-minor-mode (not widget-minor-mode)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
285 ((<= arg 0)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
286 (setq widget-minor-mode nil))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
287 (t
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
288 (setq widget-minor-mode t)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
289 (force-mode-line-update))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
290
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
291 (add-to-list 'minor-mode-alist '(widget-minor-mode " Widget"))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
292
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
293 (add-to-list 'minor-mode-map-alist
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
294 (cons 'widget-minor-mode widget-minor-mode-map))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
295
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
296 ;;; The End:
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
297
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
298 (provide 'wid-browse)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
299
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
300 ;; wid-browse.el ends here