Mercurial > emacs
annotate src/keymap.c @ 1803:5752a95053f2
* xterm.c (x_window_to_scrollbar): Search frames'
condemned_scrollbars list as well; input might arrive during
redisplay.
(x_scrollbar_report_motion): Don't forget to BLOCK_INPUT.
(XTjudge_scrollbars): Clear the condemned scrollbar list before
traversing it, so we don't try to process an event on a scrollbar
we've killed.
author | Jim Blandy <jimb@redhat.com> |
---|---|
date | Sat, 16 Jan 1993 05:58:15 +0000 |
parents | 892c9f61217a |
children | 04fb1d3d6992 |
rev | line source |
---|---|
250 | 1 /* Manipulation of keymaps |
647 | 2 Copyright (C) 1985, 1986, 1987, 1988, 1992 Free Software Foundation, Inc. |
250 | 3 |
4 This file is part of GNU Emacs. | |
5 | |
6 GNU Emacs is free software; you can redistribute it and/or modify | |
7 it under the terms of the GNU General Public License as published by | |
647 | 8 the Free Software Foundation; either version 2, or (at your option) |
250 | 9 any later version. |
10 | |
11 GNU Emacs is distributed in the hope that it will be useful, | |
12 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 GNU General Public License for more details. | |
15 | |
16 You should have received a copy of the GNU General Public License | |
17 along with GNU Emacs; see the file COPYING. If not, write to | |
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */ | |
19 | |
20 | |
21 #include "config.h" | |
22 #include <stdio.h> | |
23 #undef NULL | |
24 #include "lisp.h" | |
25 #include "commands.h" | |
26 #include "buffer.h" | |
517 | 27 #include "keyboard.h" |
250 | 28 |
29 #define min(a, b) ((a) < (b) ? (a) : (b)) | |
30 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
31 /* The number of elements in keymap vectors. */ |
250 | 32 #define DENSE_TABLE_SIZE (0200) |
33 | |
34 /* Actually allocate storage for these variables */ | |
35 | |
36 Lisp_Object current_global_map; /* Current global keymap */ | |
37 | |
38 Lisp_Object global_map; /* default global key bindings */ | |
39 | |
40 Lisp_Object meta_map; /* The keymap used for globally bound | |
41 ESC-prefixed default commands */ | |
42 | |
43 Lisp_Object control_x_map; /* The keymap used for globally bound | |
44 C-x-prefixed default commands */ | |
45 | |
46 /* was MinibufLocalMap */ | |
47 Lisp_Object Vminibuffer_local_map; | |
48 /* The keymap used by the minibuf for local | |
49 bindings when spaces are allowed in the | |
50 minibuf */ | |
51 | |
52 /* was MinibufLocalNSMap */ | |
53 Lisp_Object Vminibuffer_local_ns_map; | |
54 /* The keymap used by the minibuf for local | |
55 bindings when spaces are not encouraged | |
56 in the minibuf */ | |
57 | |
58 /* keymap used for minibuffers when doing completion */ | |
59 /* was MinibufLocalCompletionMap */ | |
60 Lisp_Object Vminibuffer_local_completion_map; | |
61 | |
62 /* keymap used for minibuffers when doing completion and require a match */ | |
63 /* was MinibufLocalMustMatchMap */ | |
64 Lisp_Object Vminibuffer_local_must_match_map; | |
65 | |
465 | 66 /* Alist of minor mode variables and keymaps. */ |
67 Lisp_Object Vminor_mode_map_alist; | |
68 | |
517 | 69 /* Keymap mapping ASCII function key sequences onto their preferred forms. |
70 Initialized by the terminal-specific lisp files. See DEFVAR for more | |
71 documentation. */ | |
72 Lisp_Object Vfunction_key_map; | |
73 | |
250 | 74 Lisp_Object Qkeymapp, Qkeymap; |
75 | |
76 /* A char over 0200 in a key sequence | |
77 is equivalent to prefixing with this character. */ | |
78 | |
79 extern Lisp_Object meta_prefix_char; | |
80 | |
81 void describe_map_tree (); | |
82 static Lisp_Object describe_buffer_bindings (); | |
83 static void describe_command (); | |
84 static void describe_map (); | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
85 static void describe_map_2 (); |
250 | 86 |
465 | 87 /* Keymap object support - constructors and predicates. */ |
88 | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
89 DEFUN ("make-keymap", Fmake_keymap, Smake_keymap, 0, 1, 0, |
250 | 90 "Construct and return a new keymap, of the form (keymap VECTOR . ALIST).\n\ |
91 VECTOR is a 128-element vector which holds the bindings for the ASCII\n\ | |
92 characters. ALIST is an assoc-list which holds bindings for function keys,\n\ | |
93 mouse events, and any other things that appear in the input stream.\n\ | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
94 All entries in it are initially nil, meaning \"command undefined\".\n\n\ |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
95 The optional arg STRING supplies a menu name for the keymap\n\ |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
96 in case you use it as a menu with `x-popup-menu'.") |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
97 (string) |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
98 Lisp_Object string; |
250 | 99 { |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
100 Lisp_Object tail; |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
101 if (!NILP (string)) |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
102 tail = Fcons (string, Qnil); |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
103 else |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
104 tail = Qnil; |
250 | 105 return Fcons (Qkeymap, |
106 Fcons (Fmake_vector (make_number (DENSE_TABLE_SIZE), Qnil), | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
107 tail)); |
250 | 108 } |
109 | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
110 DEFUN ("make-sparse-keymap", Fmake_sparse_keymap, Smake_sparse_keymap, 0, 1, 0, |
250 | 111 "Construct and return a new sparse-keymap list.\n\ |
112 Its car is `keymap' and its cdr is an alist of (CHAR . DEFINITION),\n\ | |
113 which binds the character CHAR to DEFINITION, or (SYMBOL . DEFINITION),\n\ | |
114 which binds the function key or mouse event SYMBOL to DEFINITION.\n\ | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
115 Initially the alist is nil.\n\n\ |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
116 The optional arg STRING supplies a menu name for the keymap\n\ |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
117 in case you use it as a menu with `x-popup-menu'.") |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
118 (string) |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
119 Lisp_Object string; |
250 | 120 { |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
121 if (!NILP (string)) |
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
122 return Fcons (Qkeymap, Fcons (string, Qnil)); |
250 | 123 return Fcons (Qkeymap, Qnil); |
124 } | |
125 | |
126 /* This function is used for installing the standard key bindings | |
127 at initialization time. | |
128 | |
129 For example: | |
130 | |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
131 initial_define_key (control_x_map, Ctl('X'), "exchange-point-and-mark"); */ |
250 | 132 |
133 void | |
134 initial_define_key (keymap, key, defname) | |
135 Lisp_Object keymap; | |
136 int key; | |
137 char *defname; | |
138 { | |
139 store_in_keymap (keymap, make_number (key), intern (defname)); | |
140 } | |
141 | |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
142 void |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
143 initial_define_lispy_key (keymap, keyname, defname) |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
144 Lisp_Object keymap; |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
145 char *keyname; |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
146 char *defname; |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
147 { |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
148 store_in_keymap (keymap, intern (keyname), intern (defname)); |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
149 } |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
150 |
250 | 151 /* Define character fromchar in map frommap as an alias for character |
152 tochar in map tomap. Subsequent redefinitions of the latter WILL | |
153 affect the former. */ | |
154 | |
155 #if 0 | |
156 void | |
157 synkey (frommap, fromchar, tomap, tochar) | |
158 struct Lisp_Vector *frommap, *tomap; | |
159 int fromchar, tochar; | |
160 { | |
161 Lisp_Object v, c; | |
162 XSET (v, Lisp_Vector, tomap); | |
163 XFASTINT (c) = tochar; | |
164 frommap->contents[fromchar] = Fcons (v, c); | |
165 } | |
166 #endif /* 0 */ | |
167 | |
168 DEFUN ("keymapp", Fkeymapp, Skeymapp, 1, 1, 0, | |
169 "Return t if ARG is a keymap.\n\ | |
362 | 170 \n\ |
171 A keymap is list (keymap . ALIST), a list (keymap VECTOR . ALIST),\n\ | |
172 or a symbol whose function definition is a keymap is itself a keymap.\n\ | |
173 ALIST elements look like (CHAR . DEFN) or (SYMBOL . DEFN);\n\ | |
174 VECTOR is a 128-element vector of bindings for ASCII characters.") | |
250 | 175 (object) |
176 Lisp_Object object; | |
177 { | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
178 return (NILP (get_keymap_1 (object, 0, 0)) ? Qnil : Qt); |
250 | 179 } |
180 | |
181 /* Check that OBJECT is a keymap (after dereferencing through any | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
182 symbols). If it is, return it. |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
183 |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
184 If AUTOLOAD is non-zero and OBJECT is a symbol whose function value |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
185 is an autoload form, do the autoload and try again. |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
186 |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
187 ERROR controls how we respond if OBJECT isn't a keymap. |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
188 If ERROR is non-zero, signal an error; otherwise, just return Qnil. |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
189 |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
190 Note that most of the time, we don't want to pursue autoloads. |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
191 Functions like Faccessible_keymaps which scan entire keymap trees |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
192 shouldn't load every autoloaded keymap. I'm not sure about this, |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
193 but it seems to me that only read_key_sequence, Flookup_key, and |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
194 Fdefine_key should cause keymaps to be autoloaded. */ |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
195 |
250 | 196 Lisp_Object |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
197 get_keymap_1 (object, error, autoload) |
250 | 198 Lisp_Object object; |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
199 int error, autoload; |
250 | 200 { |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
201 Lisp_Object tem; |
250 | 202 |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
203 autoload_retry: |
647 | 204 tem = indirect_function (object); |
250 | 205 if (CONSP (tem) && EQ (XCONS (tem)->car, Qkeymap)) |
206 return tem; | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
207 |
1566
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
208 /* Should we do an autoload? Autoload forms for keymaps have |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
209 Qkeymap as their fifth element. */ |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
210 if (autoload |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
211 && XTYPE (object) == Lisp_Symbol |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
212 && CONSP (tem) |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
213 && EQ (XCONS (tem)->car, Qautoload)) |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
214 { |
1566
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
215 Lisp_Object tail; |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
216 |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
217 tail = Fnth (make_number (4), tem); |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
218 if (EQ (tail, Qkeymap)) |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
219 { |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
220 struct gcpro gcpro1, gcpro2; |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
221 |
1566
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
222 GCPRO2 (tem, object) |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
223 do_autoload (tem, object); |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
224 UNGCPRO; |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
225 |
1566
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
226 goto autoload_retry; |
892c9f61217a
* keymap.c (get_keymap_1): Don't try to autoload OBJECT's function
Jim Blandy <jimb@redhat.com>
parents:
1517
diff
changeset
|
227 } |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
228 } |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
229 |
250 | 230 if (error) |
231 wrong_type_argument (Qkeymapp, object); | |
465 | 232 else |
233 return Qnil; | |
250 | 234 } |
235 | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
236 |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
237 /* Follow any symbol chaining, and return the keymap denoted by OBJECT. |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
238 If OBJECT doesn't denote a keymap at all, signal an error. */ |
250 | 239 Lisp_Object |
240 get_keymap (object) | |
241 Lisp_Object object; | |
242 { | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
243 return get_keymap_1 (object, 0, 0); |
250 | 244 } |
245 | |
246 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
247 /* Look up IDX in MAP. IDX may be any sort of event. |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
248 Note that this does only one level of lookup; IDX must be a single |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
249 event, not a sequence. |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
250 |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
251 If T_OK is non-zero, bindings for Qt are treated as default |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
252 bindings; any key left unmentioned by other tables and bindings is |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
253 given the binding of Qt. |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
254 |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
255 If T_OK is zero, bindings for Qt are not treated specially. */ |
250 | 256 |
257 Lisp_Object | |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
258 access_keymap (map, idx, t_ok) |
250 | 259 Lisp_Object map; |
260 Lisp_Object idx; | |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
261 int t_ok; |
250 | 262 { |
263 /* If idx is a list (some sort of mouse click, perhaps?), | |
264 the index we want to use is the car of the list, which | |
265 ought to be a symbol. */ | |
1315
884c3d7e7172
* keymap.c (access_keymap, store_in_keymap,
Jim Blandy <jimb@redhat.com>
parents:
1264
diff
changeset
|
266 idx = EVENT_HEAD (idx); |
250 | 267 |
268 if (XTYPE (idx) == Lisp_Int | |
269 && (XINT (idx) < 0 || XINT (idx) >= DENSE_TABLE_SIZE)) | |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
270 error ("only ASCII characters may be looked up in keymaps"); |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
271 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
272 /* If idx is a symbol, it might have modifiers, which need to |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
273 be put in the canonical order. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
274 else if (XTYPE (idx) == Lisp_Symbol) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
275 idx = reorder_modifiers (idx); |
250 | 276 |
277 { | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
278 Lisp_Object tail; |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
279 Lisp_Object t_binding = Qnil; |
250 | 280 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
281 for (tail = map; CONSP (tail); tail = XCONS (tail)->cdr) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
282 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
283 Lisp_Object binding = XCONS (tail)->car; |
250 | 284 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
285 switch (XTYPE (binding)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
286 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
287 case Lisp_Cons: |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
288 if (EQ (XCONS (binding)->car, idx)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
289 return XCONS (binding)->cdr; |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
290 if (t_ok && EQ (XCONS (binding)->car, Qt)) |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
291 t_binding = XCONS (binding)->cdr; |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
292 break; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
293 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
294 case Lisp_Vector: |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
295 if (XVECTOR (binding)->size == DENSE_TABLE_SIZE |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
296 && XTYPE (idx) == Lisp_Int) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
297 return XVECTOR (binding)->contents[XINT (idx)]; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
298 break; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
299 } |
1264
6ba9d5aaace6
* keymap.c (access_keymap): Don't forget to QUIT while scanning
Jim Blandy <jimb@redhat.com>
parents:
1236
diff
changeset
|
300 |
6ba9d5aaace6
* keymap.c (access_keymap): Don't forget to QUIT while scanning
Jim Blandy <jimb@redhat.com>
parents:
1236
diff
changeset
|
301 QUIT; |
250 | 302 } |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
303 |
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
304 return t_binding; |
1236
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
305 } |
250 | 306 } |
307 | |
308 /* Given OBJECT which was found in a slot in a keymap, | |
309 trace indirect definitions to get the actual definition of that slot. | |
310 An indirect definition is a list of the form | |
311 (KEYMAP . INDEX), where KEYMAP is a keymap or a symbol defined as one | |
312 and INDEX is the object to look up in KEYMAP to yield the definition. | |
313 | |
314 Also if OBJECT has a menu string as the first element, | |
1160
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
315 remove that. Also remove a menu help string as second element. */ |
250 | 316 |
317 Lisp_Object | |
318 get_keyelt (object) | |
319 register Lisp_Object object; | |
320 { | |
321 while (1) | |
322 { | |
323 register Lisp_Object map, tem; | |
324 | |
1236
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
325 /* If the contents are (KEYMAP . ELEMENT), go indirect. */ |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
326 map = get_keymap_1 (Fcar_safe (object), 0, 0); |
250 | 327 tem = Fkeymapp (map); |
485 | 328 if (!NILP (tem)) |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
329 object = access_keymap (map, Fcdr (object), 0); |
250 | 330 |
331 /* If the keymap contents looks like (STRING . DEFN), | |
332 use DEFN. | |
333 Keymap alist elements like (CHAR MENUSTRING . DEFN) | |
334 will be used by HierarKey menus. */ | |
335 else if (XTYPE (object) == Lisp_Cons | |
336 && XTYPE (XCONS (object)->car) == Lisp_String) | |
1160
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
337 { |
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
338 object = XCONS (object)->cdr; |
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
339 /* Also remove a menu help string, if any, |
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
340 following the menu item name. */ |
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
341 if (XTYPE (object) == Lisp_Cons |
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
342 && XTYPE (XCONS (object)->car) == Lisp_String) |
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
343 object = XCONS (object)->cdr; |
f7b55bfe1c05
(get_keyelt): Skip menu help string after menu item name.
Richard M. Stallman <rms@gnu.org>
parents:
1120
diff
changeset
|
344 } |
250 | 345 |
346 else | |
347 /* Anything else is really the value. */ | |
348 return object; | |
349 } | |
350 } | |
351 | |
352 Lisp_Object | |
353 store_in_keymap (keymap, idx, def) | |
354 Lisp_Object keymap; | |
355 register Lisp_Object idx; | |
356 register Lisp_Object def; | |
357 { | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
358 if (XTYPE (keymap) != Lisp_Cons |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
359 || ! EQ (XCONS (keymap)->car, Qkeymap)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
360 error ("attempt to define a key in a non-keymap"); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
361 |
250 | 362 /* If idx is a list (some sort of mouse click, perhaps?), |
363 the index we want to use is the car of the list, which | |
364 ought to be a symbol. */ | |
1315
884c3d7e7172
* keymap.c (access_keymap, store_in_keymap,
Jim Blandy <jimb@redhat.com>
parents:
1264
diff
changeset
|
365 idx = EVENT_HEAD (idx); |
250 | 366 |
367 if (XTYPE (idx) == Lisp_Int | |
368 && (XINT (idx) < 0 || XINT (idx) >= DENSE_TABLE_SIZE)) | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
369 error ("only ASCII characters may be used as keymap indices"); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
370 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
371 /* If idx is a symbol, it might have modifiers, which need to |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
372 be put in the canonical order. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
373 else if (XTYPE (idx) == Lisp_Symbol) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
374 idx = reorder_modifiers (idx); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
375 |
250 | 376 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
377 /* Scan the keymap for a binding of idx. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
378 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
379 Lisp_Object tail; |
250 | 380 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
381 /* The cons after which we should insert new bindings. If the |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
382 keymap has a table element, we record its position here, so new |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
383 bindings will go after it; this way, the table will stay |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
384 towards the front of the alist and character lookups in dense |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
385 keymaps will remain fast. Otherwise, this just points at the |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
386 front of the keymap. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
387 Lisp_Object insertion_point = keymap; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
388 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
389 for (tail = XCONS (keymap)->cdr; CONSP (tail); tail = XCONS (tail)->cdr) |
250 | 390 { |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
391 Lisp_Object elt = XCONS (tail)->car; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
392 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
393 switch (XTYPE (elt)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
394 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
395 case Lisp_Vector: |
1441
929409595312
* keymap.c (store_in_keymap): Don't forget to QUIT in the
Jim Blandy <jimb@redhat.com>
parents:
1388
diff
changeset
|
396 if (XVECTOR (elt)->size != DENSE_TABLE_SIZE) |
929409595312
* keymap.c (store_in_keymap): Don't forget to QUIT in the
Jim Blandy <jimb@redhat.com>
parents:
1388
diff
changeset
|
397 break; |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
398 if (XTYPE (idx) == Lisp_Int) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
399 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
400 XVECTOR (elt)->contents[XFASTINT (idx)] = def; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
401 return def; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
402 } |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
403 insertion_point = tail; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
404 break; |
250 | 405 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
406 case Lisp_Cons: |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
407 if (EQ (idx, XCONS (elt)->car)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
408 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
409 XCONS (elt)->cdr = def; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
410 return def; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
411 } |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
412 break; |
250 | 413 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
414 case Lisp_Symbol: |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
415 /* If we find a 'keymap' symbol in the spine of KEYMAP, |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
416 then we must have found the start of a second keymap |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
417 being used as the tail of KEYMAP, and a binding for IDX |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
418 should be inserted before it. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
419 if (EQ (elt, Qkeymap)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
420 goto keymap_end; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
421 break; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
422 } |
1441
929409595312
* keymap.c (store_in_keymap): Don't forget to QUIT in the
Jim Blandy <jimb@redhat.com>
parents:
1388
diff
changeset
|
423 |
929409595312
* keymap.c (store_in_keymap): Don't forget to QUIT in the
Jim Blandy <jimb@redhat.com>
parents:
1388
diff
changeset
|
424 QUIT; |
250 | 425 } |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
426 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
427 keymap_end: |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
428 /* We have scanned the entire keymap, and not found a binding for |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
429 IDX. Let's add one. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
430 XCONS (insertion_point)->cdr = |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
431 Fcons (Fcons (idx, def), XCONS (insertion_point)->cdr); |
250 | 432 } |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
433 |
250 | 434 return def; |
435 } | |
436 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
437 |
250 | 438 DEFUN ("copy-keymap", Fcopy_keymap, Scopy_keymap, 1, 1, 0, |
439 "Return a copy of the keymap KEYMAP.\n\ | |
440 The copy starts out with the same definitions of KEYMAP,\n\ | |
441 but changing either the copy or KEYMAP does not affect the other.\n\ | |
362 | 442 Any key definitions that are subkeymaps are recursively copied.\n\ |
443 However, a key definition which is a symbol whose definition is a keymap\n\ | |
444 is not copied.") | |
250 | 445 (keymap) |
446 Lisp_Object keymap; | |
447 { | |
448 register Lisp_Object copy, tail; | |
449 | |
450 copy = Fcopy_alist (get_keymap (keymap)); | |
451 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
452 for (tail = copy; CONSP (tail); tail = XCONS (tail)->cdr) |
250 | 453 { |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
454 Lisp_Object elt = XCONS (tail)->car; |
250 | 455 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
456 if (XTYPE (elt) == Lisp_Vector |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
457 && XVECTOR (elt)->size == DENSE_TABLE_SIZE) |
250 | 458 { |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
459 int i; |
250 | 460 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
461 elt = Fcopy_sequence (elt); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
462 XCONS (tail)->car = elt; |
250 | 463 |
464 for (i = 0; i < DENSE_TABLE_SIZE; i++) | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
465 if (XTYPE (XVECTOR (elt)->contents[i]) != Lisp_Symbol |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
466 && Fkeymapp (XVECTOR (elt)->contents[i])) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
467 XVECTOR (elt)->contents[i] = |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
468 Fcopy_keymap (XVECTOR (elt)->contents[i]); |
250 | 469 } |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
470 else if (CONSP (elt) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
471 && XTYPE (XCONS (elt)->cdr) != Lisp_Symbol |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
472 && ! NILP (Fkeymapp (XCONS (elt)->cdr))) |
250 | 473 XCONS (elt)->cdr = Fcopy_keymap (XCONS (elt)->cdr); |
474 } | |
475 | |
476 return copy; | |
477 } | |
478 | |
465 | 479 /* Simple Keymap mutators and accessors. */ |
480 | |
250 | 481 DEFUN ("define-key", Fdefine_key, Sdefine_key, 3, 3, 0, |
482 "Args KEYMAP, KEY, DEF. Define key sequence KEY, in KEYMAP, as DEF.\n\ | |
483 KEYMAP is a keymap. KEY is a string or a vector of symbols and characters\n\ | |
484 meaning a sequence of keystrokes and events.\n\ | |
485 DEF is anything that can be a key's definition:\n\ | |
486 nil (means key is undefined in this keymap),\n\ | |
487 a command (a Lisp function suitable for interactive calling)\n\ | |
488 a string (treated as a keyboard macro),\n\ | |
489 a keymap (to define a prefix key),\n\ | |
490 a symbol. When the key is looked up, the symbol will stand for its\n\ | |
491 function definition, which should at that time be one of the above,\n\ | |
492 or another symbol whose function definition is used, etc.\n\ | |
493 a cons (STRING . DEFN), meaning that DEFN is the definition\n\ | |
494 (DEFN should be a valid definition in its own right),\n\ | |
368 | 495 or a cons (KEYMAP . CHAR), meaning use definition of CHAR in map KEYMAP.\n\ |
496 \n\ | |
497 If KEYMAP is a sparse keymap, the pair binding KEY to DEF is added at\n\ | |
498 the front of KEYMAP.") | |
250 | 499 (keymap, key, def) |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
500 Lisp_Object keymap; |
250 | 501 Lisp_Object key; |
502 Lisp_Object def; | |
503 { | |
504 register int idx; | |
505 register Lisp_Object c; | |
506 register Lisp_Object tem; | |
507 register Lisp_Object cmd; | |
508 int metized = 0; | |
509 int length; | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
510 struct gcpro gcpro1, gcpro2, gcpro3; |
250 | 511 |
512 keymap = get_keymap (keymap); | |
513 | |
514 if (XTYPE (key) != Lisp_Vector | |
515 && XTYPE (key) != Lisp_String) | |
516 key = wrong_type_argument (Qarrayp, key); | |
517 | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
518 length = XFASTINT (Flength (key)); |
250 | 519 if (length == 0) |
520 return Qnil; | |
521 | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
522 GCPRO3 (keymap, key, def); |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
523 |
250 | 524 idx = 0; |
525 while (1) | |
526 { | |
527 c = Faref (key, make_number (idx)); | |
528 | |
529 if (XTYPE (c) == Lisp_Int | |
530 && XINT (c) >= 0200 | |
531 && !metized) | |
532 { | |
533 c = meta_prefix_char; | |
534 metized = 1; | |
535 } | |
536 else | |
537 { | |
538 if (XTYPE (c) == Lisp_Int) | |
539 XSETINT (c, XINT (c) & 0177); | |
540 | |
541 metized = 0; | |
542 idx++; | |
543 } | |
544 | |
545 if (idx == length) | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
546 RETURN_UNGCPRO (store_in_keymap (keymap, c, def)); |
250 | 547 |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
548 cmd = get_keyelt (access_keymap (keymap, c, 0)); |
250 | 549 |
485 | 550 if (NILP (cmd)) |
250 | 551 { |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
552 cmd = Fmake_sparse_keymap (Qnil); |
250 | 553 store_in_keymap (keymap, c, cmd); |
554 } | |
555 | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
556 keymap = get_keymap_1 (cmd, 0, 1); |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
557 if (NILP (keymap)) |
250 | 558 error ("Key sequence %s uses invalid prefix characters", |
559 XSTRING (key)->data); | |
560 } | |
561 } | |
562 | |
563 /* Value is number if KEY is too long; NIL if valid but has no definition. */ | |
564 | |
565 DEFUN ("lookup-key", Flookup_key, Slookup_key, 2, 2, 0, | |
566 "In keymap KEYMAP, look up key sequence KEY. Return the definition.\n\ | |
567 nil means undefined. See doc of `define-key' for kinds of definitions.\n\ | |
568 A number as value means KEY is \"too long\";\n\ | |
569 that is, characters or symbols in it except for the last one\n\ | |
570 fail to be a valid sequence of prefix characters in KEYMAP.\n\ | |
571 The number is how many characters at the front of KEY\n\ | |
572 it takes to reach a non-prefix command.") | |
573 (keymap, key) | |
574 register Lisp_Object keymap; | |
575 Lisp_Object key; | |
576 { | |
577 register int idx; | |
578 register Lisp_Object tem; | |
579 register Lisp_Object cmd; | |
580 register Lisp_Object c; | |
581 int metized = 0; | |
582 int length; | |
583 | |
584 keymap = get_keymap (keymap); | |
585 | |
586 if (XTYPE (key) != Lisp_Vector | |
587 && XTYPE (key) != Lisp_String) | |
588 key = wrong_type_argument (Qarrayp, key); | |
589 | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
590 length = XFASTINT (Flength (key)); |
250 | 591 if (length == 0) |
592 return keymap; | |
593 | |
594 idx = 0; | |
595 while (1) | |
596 { | |
597 c = Faref (key, make_number (idx)); | |
598 | |
599 if (XTYPE (c) == Lisp_Int | |
600 && XINT (c) >= 0200 | |
601 && !metized) | |
602 { | |
603 c = meta_prefix_char; | |
604 metized = 1; | |
605 } | |
606 else | |
607 { | |
608 if (XTYPE (c) == Lisp_Int) | |
609 XSETINT (c, XINT (c) & 0177); | |
610 | |
611 metized = 0; | |
612 idx++; | |
613 } | |
614 | |
1388
02226bff1476
* keymap.c (initial_define_lispy_key): New function, for defining
Jim Blandy <jimb@redhat.com>
parents:
1315
diff
changeset
|
615 cmd = get_keyelt (access_keymap (keymap, c, 0)); |
250 | 616 if (idx == length) |
617 return cmd; | |
618 | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
619 keymap = get_keymap_1 (cmd, 0, 0); |
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
620 if (NILP (keymap)) |
250 | 621 return make_number (idx); |
622 | |
623 QUIT; | |
624 } | |
625 } | |
626 | |
627 /* Append a key to the end of a key sequence. If key_sequence is a | |
628 string and key is a character, the result will be another string; | |
629 otherwise, it will be a vector. */ | |
630 Lisp_Object | |
631 append_key (key_sequence, key) | |
632 Lisp_Object key_sequence, key; | |
633 { | |
634 Lisp_Object args[2]; | |
635 | |
636 args[0] = key_sequence; | |
637 | |
638 if (XTYPE (key_sequence) == Lisp_String | |
639 && XTYPE (key) == Lisp_Int) | |
640 { | |
641 args[1] = Fchar_to_string (key); | |
642 return Fconcat (2, args); | |
643 } | |
644 else | |
645 { | |
646 args[1] = Fcons (key, Qnil); | |
647 return Fvconcat (2, args); | |
648 } | |
649 } | |
650 | |
651 | |
465 | 652 /* Global, local, and minor mode keymap stuff. */ |
653 | |
485 | 654 /* We can't put these variables inside current_minor_maps, since under |
517 | 655 some systems, static gets macro-defined to be the empty string. |
656 Ickypoo. */ | |
485 | 657 static Lisp_Object *cmm_modes, *cmm_maps; |
658 static int cmm_size; | |
659 | |
465 | 660 /* Store a pointer to an array of the keymaps of the currently active |
661 minor modes in *buf, and return the number of maps it contains. | |
662 | |
663 This function always returns a pointer to the same buffer, and may | |
664 free or reallocate it, so if you want to keep it for a long time or | |
665 hand it out to lisp code, copy it. This procedure will be called | |
666 for every key sequence read, so the nice lispy approach (return a | |
667 new assoclist, list, what have you) for each invocation would | |
668 result in a lot of consing over time. | |
669 | |
670 If we used xrealloc/xmalloc and ran out of memory, they would throw | |
671 back to the command loop, which would try to read a key sequence, | |
672 which would call this function again, resulting in an infinite | |
673 loop. Instead, we'll use realloc/malloc and silently truncate the | |
674 list, let the key sequence be read, and hope some other piece of | |
675 code signals the error. */ | |
676 int | |
677 current_minor_maps (modeptr, mapptr) | |
678 Lisp_Object **modeptr, **mapptr; | |
679 { | |
680 int i = 0; | |
517 | 681 Lisp_Object alist, assoc, var, val; |
465 | 682 |
683 for (alist = Vminor_mode_map_alist; | |
684 CONSP (alist); | |
685 alist = XCONS (alist)->cdr) | |
686 if (CONSP (assoc = XCONS (alist)->car) | |
687 && XTYPE (var = XCONS (assoc)->car) == Lisp_Symbol | |
517 | 688 && ! EQ ((val = find_symbol_value (var)), Qunbound) |
689 && ! NILP (val)) | |
465 | 690 { |
485 | 691 if (i >= cmm_size) |
465 | 692 { |
693 Lisp_Object *newmodes, *newmaps; | |
694 | |
485 | 695 if (cmm_maps) |
465 | 696 { |
485 | 697 newmodes = (Lisp_Object *) realloc (cmm_modes, cmm_size *= 2); |
698 newmaps = (Lisp_Object *) realloc (cmm_maps, cmm_size); | |
465 | 699 } |
700 else | |
701 { | |
485 | 702 newmodes = (Lisp_Object *) malloc (cmm_size = 30); |
703 newmaps = (Lisp_Object *) malloc (cmm_size); | |
465 | 704 } |
705 | |
706 if (newmaps && newmodes) | |
707 { | |
485 | 708 cmm_modes = newmodes; |
709 cmm_maps = newmaps; | |
465 | 710 } |
711 else | |
712 break; | |
713 } | |
485 | 714 cmm_modes[i] = var; |
715 cmm_maps [i] = XCONS (assoc)->cdr; | |
465 | 716 i++; |
717 } | |
718 | |
485 | 719 if (modeptr) *modeptr = cmm_modes; |
720 if (mapptr) *mapptr = cmm_maps; | |
465 | 721 return i; |
722 } | |
723 | |
250 | 724 DEFUN ("key-binding", Fkey_binding, Skey_binding, 1, 1, 0, |
725 "Return the binding for command KEY in current keymaps.\n\ | |
726 KEY is a string, a sequence of keystrokes.\n\ | |
727 The binding is probably a symbol with a function definition.") | |
728 (key) | |
729 Lisp_Object key; | |
730 { | |
465 | 731 Lisp_Object *maps, value; |
732 int nmaps, i; | |
733 | |
734 nmaps = current_minor_maps (0, &maps); | |
735 for (i = 0; i < nmaps; i++) | |
485 | 736 if (! NILP (maps[i])) |
465 | 737 { |
738 value = Flookup_key (maps[i], key); | |
485 | 739 if (! NILP (value) && XTYPE (value) != Lisp_Int) |
465 | 740 return value; |
741 } | |
742 | |
485 | 743 if (! NILP (current_buffer->keymap)) |
250 | 744 { |
465 | 745 value = Flookup_key (current_buffer->keymap, key); |
485 | 746 if (! NILP (value) && XTYPE (value) != Lisp_Int) |
250 | 747 return value; |
748 } | |
465 | 749 |
750 value = Flookup_key (current_global_map, key); | |
485 | 751 if (! NILP (value) && XTYPE (value) != Lisp_Int) |
465 | 752 return value; |
753 | |
754 return Qnil; | |
250 | 755 } |
756 | |
757 DEFUN ("local-key-binding", Flocal_key_binding, Slocal_key_binding, 1, 1, 0, | |
758 "Return the binding for command KEYS in current local keymap only.\n\ | |
759 KEYS is a string, a sequence of keystrokes.\n\ | |
760 The binding is probably a symbol with a function definition.") | |
761 (keys) | |
762 Lisp_Object keys; | |
763 { | |
764 register Lisp_Object map; | |
765 map = current_buffer->keymap; | |
485 | 766 if (NILP (map)) |
250 | 767 return Qnil; |
768 return Flookup_key (map, keys); | |
769 } | |
770 | |
771 DEFUN ("global-key-binding", Fglobal_key_binding, Sglobal_key_binding, 1, 1, 0, | |
772 "Return the binding for command KEYS in current global keymap only.\n\ | |
773 KEYS is a string, a sequence of keystrokes.\n\ | |
517 | 774 The binding is probably a symbol with a function definition.\n\ |
775 This function's return values are the same as those of lookup-key\n\ | |
776 (which see).") | |
250 | 777 (keys) |
778 Lisp_Object keys; | |
779 { | |
780 return Flookup_key (current_global_map, keys); | |
781 } | |
782 | |
465 | 783 DEFUN ("minor-mode-key-binding", Fminor_mode_key_binding, Sminor_mode_key_binding, 1, 1, 0, |
784 "Find the visible minor mode bindings of KEY.\n\ | |
785 Return an alist of pairs (MODENAME . BINDING), where MODENAME is the\n\ | |
786 the symbol which names the minor mode binding KEY, and BINDING is\n\ | |
787 KEY's definition in that mode. In particular, if KEY has no\n\ | |
788 minor-mode bindings, return nil. If the first binding is a\n\ | |
789 non-prefix, all subsequent bindings will be omitted, since they would\n\ | |
790 be ignored. Similarly, the list doesn't include non-prefix bindings\n\ | |
791 that come after prefix bindings.") | |
792 (key) | |
793 { | |
794 Lisp_Object *modes, *maps; | |
795 int nmaps; | |
796 Lisp_Object binding; | |
797 int i, j; | |
798 | |
799 nmaps = current_minor_maps (&modes, &maps); | |
800 | |
801 for (i = j = 0; i < nmaps; i++) | |
485 | 802 if (! NILP (maps[i]) |
803 && ! NILP (binding = Flookup_key (maps[i], key)) | |
465 | 804 && XTYPE (binding) != Lisp_Int) |
805 { | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
806 if (! NILP (get_keymap (binding))) |
465 | 807 maps[j++] = Fcons (modes[i], binding); |
808 else if (j == 0) | |
809 return Fcons (Fcons (modes[i], binding), Qnil); | |
810 } | |
811 | |
812 return Flist (j, maps); | |
813 } | |
814 | |
250 | 815 DEFUN ("global-set-key", Fglobal_set_key, Sglobal_set_key, 2, 2, |
816 "kSet key globally: \nCSet key %s to command: ", | |
817 "Give KEY a global binding as COMMAND.\n\ | |
818 COMMAND is a symbol naming an interactively-callable function.\n\ | |
819 KEY is a string representing a sequence of keystrokes.\n\ | |
820 Note that if KEY has a local binding in the current buffer\n\ | |
821 that local binding will continue to shadow any global binding.") | |
822 (keys, function) | |
823 Lisp_Object keys, function; | |
824 { | |
825 if (XTYPE (keys) != Lisp_Vector | |
826 && XTYPE (keys) != Lisp_String) | |
827 keys = wrong_type_argument (Qarrayp, keys); | |
828 | |
829 Fdefine_key (current_global_map, keys, function); | |
830 return Qnil; | |
831 } | |
832 | |
833 DEFUN ("local-set-key", Flocal_set_key, Slocal_set_key, 2, 2, | |
834 "kSet key locally: \nCSet key %s locally to command: ", | |
835 "Give KEY a local binding as COMMAND.\n\ | |
836 COMMAND is a symbol naming an interactively-callable function.\n\ | |
837 KEY is a string representing a sequence of keystrokes.\n\ | |
838 The binding goes in the current buffer's local map,\n\ | |
839 which is shared with other buffers in the same major mode.") | |
840 (keys, function) | |
841 Lisp_Object keys, function; | |
842 { | |
843 register Lisp_Object map; | |
844 map = current_buffer->keymap; | |
485 | 845 if (NILP (map)) |
250 | 846 { |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
847 map = Fmake_sparse_keymap (Qnil); |
250 | 848 current_buffer->keymap = map; |
849 } | |
850 | |
851 if (XTYPE (keys) != Lisp_Vector | |
852 && XTYPE (keys) != Lisp_String) | |
853 keys = wrong_type_argument (Qarrayp, keys); | |
854 | |
855 Fdefine_key (map, keys, function); | |
856 return Qnil; | |
857 } | |
858 | |
859 DEFUN ("global-unset-key", Fglobal_unset_key, Sglobal_unset_key, | |
860 1, 1, "kUnset key globally: ", | |
861 "Remove global binding of KEY.\n\ | |
862 KEY is a string representing a sequence of keystrokes.") | |
863 (keys) | |
864 Lisp_Object keys; | |
865 { | |
866 return Fglobal_set_key (keys, Qnil); | |
867 } | |
868 | |
869 DEFUN ("local-unset-key", Flocal_unset_key, Slocal_unset_key, 1, 1, | |
870 "kUnset key locally: ", | |
871 "Remove local binding of KEY.\n\ | |
872 KEY is a string representing a sequence of keystrokes.") | |
873 (keys) | |
874 Lisp_Object keys; | |
875 { | |
485 | 876 if (!NILP (current_buffer->keymap)) |
250 | 877 Flocal_set_key (keys, Qnil); |
878 return Qnil; | |
879 } | |
880 | |
881 DEFUN ("define-prefix-command", Fdefine_prefix_command, Sdefine_prefix_command, 1, 2, 0, | |
882 "Define COMMAND as a prefix command.\n\ | |
883 A new sparse keymap is stored as COMMAND's function definition and its value.\n\ | |
362 | 884 If a second optional argument MAPVAR is given, the map is stored as\n\ |
885 its value instead of as COMMAND's value; but COMMAND is still defined\n\ | |
886 as a function.") | |
250 | 887 (name, mapvar) |
888 Lisp_Object name, mapvar; | |
889 { | |
890 Lisp_Object map; | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
891 map = Fmake_sparse_keymap (Qnil); |
250 | 892 Ffset (name, map); |
485 | 893 if (!NILP (mapvar)) |
250 | 894 Fset (mapvar, map); |
895 else | |
896 Fset (name, map); | |
897 return name; | |
898 } | |
899 | |
900 DEFUN ("use-global-map", Fuse_global_map, Suse_global_map, 1, 1, 0, | |
901 "Select KEYMAP as the global keymap.") | |
902 (keymap) | |
903 Lisp_Object keymap; | |
904 { | |
905 keymap = get_keymap (keymap); | |
906 current_global_map = keymap; | |
907 return Qnil; | |
908 } | |
909 | |
910 DEFUN ("use-local-map", Fuse_local_map, Suse_local_map, 1, 1, 0, | |
911 "Select KEYMAP as the local keymap.\n\ | |
912 If KEYMAP is nil, that means no local keymap.") | |
913 (keymap) | |
914 Lisp_Object keymap; | |
915 { | |
485 | 916 if (!NILP (keymap)) |
250 | 917 keymap = get_keymap (keymap); |
918 | |
919 current_buffer->keymap = keymap; | |
920 | |
921 return Qnil; | |
922 } | |
923 | |
924 DEFUN ("current-local-map", Fcurrent_local_map, Scurrent_local_map, 0, 0, 0, | |
925 "Return current buffer's local keymap, or nil if it has none.") | |
926 () | |
927 { | |
928 return current_buffer->keymap; | |
929 } | |
930 | |
931 DEFUN ("current-global-map", Fcurrent_global_map, Scurrent_global_map, 0, 0, 0, | |
932 "Return the current global keymap.") | |
933 () | |
934 { | |
935 return current_global_map; | |
936 } | |
465 | 937 |
938 DEFUN ("current-minor-mode-maps", Fcurrent_minor_mode_maps, Scurrent_minor_mode_maps, 0, 0, 0, | |
939 "Return a list of keymaps for the minor modes of the current buffer.") | |
940 () | |
941 { | |
942 Lisp_Object *maps; | |
943 int nmaps = current_minor_maps (0, &maps); | |
944 | |
945 return Flist (nmaps, maps); | |
946 } | |
250 | 947 |
465 | 948 /* Help functions for describing and documenting keymaps. */ |
949 | |
250 | 950 DEFUN ("accessible-keymaps", Faccessible_keymaps, Saccessible_keymaps, |
951 1, 1, 0, | |
952 "Find all keymaps accessible via prefix characters from KEYMAP.\n\ | |
953 Returns a list of elements of the form (KEYS . MAP), where the sequence\n\ | |
954 KEYS starting from KEYMAP gets you to MAP. These elements are ordered\n\ | |
955 so that the KEYS increase in length. The first element is (\"\" . KEYMAP).") | |
956 (startmap) | |
957 Lisp_Object startmap; | |
958 { | |
959 Lisp_Object maps, tail; | |
960 | |
961 maps = Fcons (Fcons (build_string (""), get_keymap (startmap)), Qnil); | |
962 | |
963 /* For each map in the list maps, | |
964 look at any other maps it points to, | |
965 and stick them at the end if they are not already in the list. | |
966 | |
967 This is a breadth-first traversal, where tail is the queue of | |
968 nodes, and maps accumulates a list of all nodes visited. */ | |
969 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
970 for (tail = maps; CONSP (tail); tail = XCONS (tail)->cdr) |
250 | 971 { |
972 register Lisp_Object thisseq = Fcar (Fcar (tail)); | |
973 register Lisp_Object thismap = Fcdr (Fcar (tail)); | |
974 Lisp_Object last = make_number (XINT (Flength (thisseq)) - 1); | |
975 | |
976 /* Does the current sequence end in the meta-prefix-char? */ | |
977 int is_metized = (XINT (last) >= 0 | |
978 && EQ (Faref (thisseq, last), meta_prefix_char)); | |
979 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
980 for (; CONSP (thismap); thismap = XCONS (thismap)->cdr) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
981 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
982 Lisp_Object elt = XCONS (thismap)->car; |
250 | 983 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
984 QUIT; |
250 | 985 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
986 if (XTYPE (elt) == Lisp_Vector) |
250 | 987 { |
988 register int i; | |
989 | |
990 /* Vector keymap. Scan all the elements. */ | |
991 for (i = 0; i < DENSE_TABLE_SIZE; i++) | |
992 { | |
993 register Lisp_Object tem; | |
994 register Lisp_Object cmd; | |
995 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
996 cmd = get_keyelt (XVECTOR (elt)->contents[i]); |
485 | 997 if (NILP (cmd)) continue; |
250 | 998 tem = Fkeymapp (cmd); |
485 | 999 if (!NILP (tem)) |
250 | 1000 { |
1001 cmd = get_keymap (cmd); | |
1002 /* Ignore keymaps that are already added to maps. */ | |
1003 tem = Frassq (cmd, maps); | |
485 | 1004 if (NILP (tem)) |
250 | 1005 { |
1006 /* If the last key in thisseq is meta-prefix-char, | |
1007 turn it into a meta-ized keystroke. We know | |
1008 that the event we're about to append is an | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1009 ascii keystroke since we're processing a |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1010 keymap table. */ |
250 | 1011 if (is_metized) |
1012 { | |
1013 tem = Fcopy_sequence (thisseq); | |
1014 Faset (tem, last, make_number (i | 0200)); | |
1015 | |
1016 /* This new sequence is the same length as | |
1017 thisseq, so stick it in the list right | |
1018 after this one. */ | |
1019 XCONS (tail)->cdr = | |
1020 Fcons (Fcons (tem, cmd), XCONS (tail)->cdr); | |
1021 } | |
1022 else | |
1023 { | |
1024 tem = append_key (thisseq, make_number (i)); | |
1025 nconc2 (tail, Fcons (Fcons (tem, cmd), Qnil)); | |
1026 } | |
1027 } | |
1028 } | |
1029 } | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1030 } |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1031 else if (CONSP (elt)) |
250 | 1032 { |
1033 register Lisp_Object cmd = get_keyelt (XCONS (elt)->cdr); | |
1034 register Lisp_Object tem; | |
1035 | |
1036 /* Ignore definitions that aren't keymaps themselves. */ | |
1037 tem = Fkeymapp (cmd); | |
485 | 1038 if (!NILP (tem)) |
250 | 1039 { |
1040 /* Ignore keymaps that have been seen already. */ | |
1041 cmd = get_keymap (cmd); | |
1042 tem = Frassq (cmd, maps); | |
485 | 1043 if (NILP (tem)) |
250 | 1044 { |
1045 /* let elt be the event defined by this map entry. */ | |
1046 elt = XCONS (elt)->car; | |
1047 | |
1048 /* If the last key in thisseq is meta-prefix-char, and | |
1049 this entry is a binding for an ascii keystroke, | |
1050 turn it into a meta-ized keystroke. */ | |
1051 if (is_metized && XTYPE (elt) == Lisp_Int) | |
1052 { | |
1053 tem = Fcopy_sequence (thisseq); | |
1054 Faset (tem, last, make_number (XINT (elt) | 0200)); | |
1055 | |
1056 /* This new sequence is the same length as | |
1057 thisseq, so stick it in the list right | |
1058 after this one. */ | |
1059 XCONS (tail)->cdr = | |
1060 Fcons (Fcons (tem, cmd), XCONS (tail)->cdr); | |
1061 } | |
1062 else | |
1063 nconc2 (tail, | |
1064 Fcons (Fcons (append_key (thisseq, elt), cmd), | |
1065 Qnil)); | |
1066 } | |
1067 } | |
1068 } | |
1069 } | |
1070 } | |
1071 | |
1072 return maps; | |
1073 } | |
1074 | |
1075 Lisp_Object Qsingle_key_description, Qkey_description; | |
1076 | |
1077 DEFUN ("key-description", Fkey_description, Skey_description, 1, 1, 0, | |
1078 "Return a pretty description of key-sequence KEYS.\n\ | |
1079 Control characters turn into \"C-foo\" sequences, meta into \"M-foo\"\n\ | |
1080 spaces are put between sequence elements, etc.") | |
1081 (keys) | |
1082 Lisp_Object keys; | |
1083 { | |
1084 return Fmapconcat (Qsingle_key_description, keys, build_string (" ")); | |
1085 } | |
1086 | |
1087 char * | |
1088 push_key_description (c, p) | |
1089 register unsigned int c; | |
1090 register char *p; | |
1091 { | |
1092 if (c >= 0200) | |
1093 { | |
1094 *p++ = 'M'; | |
1095 *p++ = '-'; | |
1096 c -= 0200; | |
1097 } | |
1098 if (c < 040) | |
1099 { | |
1100 if (c == 033) | |
1101 { | |
1102 *p++ = 'E'; | |
1103 *p++ = 'S'; | |
1104 *p++ = 'C'; | |
1105 } | |
1106 else if (c == Ctl('I')) | |
1107 { | |
1108 *p++ = 'T'; | |
1109 *p++ = 'A'; | |
1110 *p++ = 'B'; | |
1111 } | |
1112 else if (c == Ctl('J')) | |
1113 { | |
1114 *p++ = 'L'; | |
1115 *p++ = 'F'; | |
1116 *p++ = 'D'; | |
1117 } | |
1118 else if (c == Ctl('M')) | |
1119 { | |
1120 *p++ = 'R'; | |
1121 *p++ = 'E'; | |
1122 *p++ = 'T'; | |
1123 } | |
1124 else | |
1125 { | |
1126 *p++ = 'C'; | |
1127 *p++ = '-'; | |
1128 if (c > 0 && c <= Ctl ('Z')) | |
1129 *p++ = c + 0140; | |
1130 else | |
1131 *p++ = c + 0100; | |
1132 } | |
1133 } | |
1134 else if (c == 0177) | |
1135 { | |
1136 *p++ = 'D'; | |
1137 *p++ = 'E'; | |
1138 *p++ = 'L'; | |
1139 } | |
1140 else if (c == ' ') | |
1141 { | |
1142 *p++ = 'S'; | |
1143 *p++ = 'P'; | |
1144 *p++ = 'C'; | |
1145 } | |
1146 else | |
1147 *p++ = c; | |
1148 | |
1149 return p; | |
1150 } | |
1151 | |
1152 DEFUN ("single-key-description", Fsingle_key_description, Ssingle_key_description, 1, 1, 0, | |
1153 "Return a pretty description of command character KEY.\n\ | |
1154 Control characters turn into C-whatever, etc.") | |
1155 (key) | |
1156 Lisp_Object key; | |
1157 { | |
1158 register unsigned char c; | |
1159 char tem[6]; | |
1160 | |
1315
884c3d7e7172
* keymap.c (access_keymap, store_in_keymap,
Jim Blandy <jimb@redhat.com>
parents:
1264
diff
changeset
|
1161 key = EVENT_HEAD (key); |
517 | 1162 |
250 | 1163 switch (XTYPE (key)) |
1164 { | |
1165 case Lisp_Int: /* Normal character */ | |
1166 c = XINT (key) & 0377; | |
1167 *push_key_description (c, tem) = 0; | |
1168 return build_string (tem); | |
1169 | |
1170 case Lisp_Symbol: /* Function key or event-symbol */ | |
1171 return Fsymbol_name (key); | |
1172 | |
1173 default: | |
1174 error ("KEY must be an integer, cons, or symbol."); | |
1175 } | |
1176 } | |
1177 | |
1178 char * | |
1179 push_text_char_description (c, p) | |
1180 register unsigned int c; | |
1181 register char *p; | |
1182 { | |
1183 if (c >= 0200) | |
1184 { | |
1185 *p++ = 'M'; | |
1186 *p++ = '-'; | |
1187 c -= 0200; | |
1188 } | |
1189 if (c < 040) | |
1190 { | |
1191 *p++ = '^'; | |
1192 *p++ = c + 64; /* 'A' - 1 */ | |
1193 } | |
1194 else if (c == 0177) | |
1195 { | |
1196 *p++ = '^'; | |
1197 *p++ = '?'; | |
1198 } | |
1199 else | |
1200 *p++ = c; | |
1201 return p; | |
1202 } | |
1203 | |
1204 DEFUN ("text-char-description", Ftext_char_description, Stext_char_description, 1, 1, 0, | |
1205 "Return a pretty description of file-character CHAR.\n\ | |
1206 Control characters turn into \"^char\", etc.") | |
1207 (chr) | |
1208 Lisp_Object chr; | |
1209 { | |
1210 char tem[6]; | |
1211 | |
1212 CHECK_NUMBER (chr, 0); | |
1213 | |
1214 *push_text_char_description (XINT (chr) & 0377, tem) = 0; | |
1215 | |
1216 return build_string (tem); | |
1217 } | |
1218 | |
465 | 1219 /* where-is - finding a command in a set of keymaps. */ |
1220 | |
250 | 1221 DEFUN ("where-is-internal", Fwhere_is_internal, Swhere_is_internal, 1, 5, 0, |
1222 "Return list of keys that invoke DEFINITION in KEYMAP or KEYMAP1.\n\ | |
1223 If KEYMAP is nil, search only KEYMAP1.\n\ | |
1224 If KEYMAP1 is nil, use the current global map.\n\ | |
1225 \n\ | |
1226 If optional 4th arg FIRSTONLY is non-nil,\n\ | |
1227 return a string representing the first key sequence found,\n\ | |
1228 rather than a list of all possible key sequences.\n\ | |
1229 \n\ | |
1230 If optional 5th arg NOINDIRECT is non-nil, don't follow indirections\n\ | |
1231 to other keymaps or slots. This makes it possible to search for an\n\ | |
1232 indirect definition itself.") | |
1233 (definition, local_keymap, global_keymap, firstonly, noindirect) | |
1234 Lisp_Object definition, local_keymap, global_keymap; | |
1235 Lisp_Object firstonly, noindirect; | |
1236 { | |
1237 register Lisp_Object maps; | |
1238 Lisp_Object found; | |
1239 | |
485 | 1240 if (NILP (global_keymap)) |
250 | 1241 global_keymap = current_global_map; |
1242 | |
485 | 1243 if (!NILP (local_keymap)) |
250 | 1244 maps = nconc2 (Faccessible_keymaps (get_keymap (local_keymap)), |
1245 Faccessible_keymaps (get_keymap (global_keymap))); | |
1246 else | |
1247 maps = Faccessible_keymaps (get_keymap (global_keymap)); | |
1248 | |
1249 found = Qnil; | |
1250 | |
485 | 1251 for (; !NILP (maps); maps = Fcdr (maps)) |
250 | 1252 { |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1253 /* Key sequence to reach map */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1254 register Lisp_Object this = Fcar (Fcar (maps)); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1255 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1256 /* The map that it reaches */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1257 register Lisp_Object map = Fcdr (Fcar (maps)); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1258 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1259 /* If Fcar (map) is a VECTOR, the current element within that vector. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1260 int i = 0; |
250 | 1261 |
1262 /* In order to fold [META-PREFIX-CHAR CHAR] sequences into | |
1263 [M-CHAR] sequences, check if last character of the sequence | |
1264 is the meta-prefix char. */ | |
1265 Lisp_Object last = make_number (XINT (Flength (this)) - 1); | |
1266 int last_is_meta = (XINT (last) >= 0 | |
1267 && EQ (Faref (this, last), meta_prefix_char)); | |
1268 | |
1236
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
1269 QUIT; |
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
1270 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1271 while (CONSP (map)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1272 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1273 /* Because the code we want to run on each binding is rather |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1274 large, we don't want to have two separate loop bodies for |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1275 sparse keymap bindings and tables; we want to iterate one |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1276 loop body over both keymap and vector bindings. |
250 | 1277 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1278 For this reason, if Fcar (map) is a vector, we don't |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1279 advance map to the next element until i indicates that we |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1280 have finished off the vector. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1281 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1282 Lisp_Object elt = XCONS (map)->car; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1283 Lisp_Object key, binding, sequence; |
250 | 1284 |
1236
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
1285 QUIT; |
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
1286 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1287 /* Set key and binding to the current key and binding, and |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1288 advance map and i to the next binding. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1289 if (XTYPE (elt) == Lisp_Vector) |
250 | 1290 { |
1291 /* In a vector, look at each element. */ | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1292 binding = XVECTOR (elt)->contents[i]; |
250 | 1293 XFASTINT (key) = i; |
1294 i++; | |
1295 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1296 /* If we've just finished scanning a vector, advance map |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1297 to the next element, and reset i in anticipation of the |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1298 next vector we may find. */ |
250 | 1299 if (i >= DENSE_TABLE_SIZE) |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1300 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1301 map = XCONS (map)->cdr; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1302 i = 0; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1303 } |
250 | 1304 } |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1305 else if (CONSP (elt)) |
250 | 1306 { |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1307 key = Fcar (Fcar (map)); |
250 | 1308 binding = Fcdr (Fcar (map)); |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1309 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1310 map = XCONS (map)->cdr; |
250 | 1311 } |
1312 else | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1313 /* We want to ignore keymap elements that are neither |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1314 vectors nor conses. */ |
1236
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
1315 { |
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
1316 map = XCONS (map)->cdr; |
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
1317 continue; |
5e8c234e5f03
* keymap.c (access_keymap): Remove code to notice bindings for
Jim Blandy <jimb@redhat.com>
parents:
1209
diff
changeset
|
1318 } |
250 | 1319 |
1320 /* Search through indirections unless that's not wanted. */ | |
485 | 1321 if (NILP (noindirect)) |
250 | 1322 binding = get_keyelt (binding); |
1323 | |
1324 /* End this iteration if this element does not match | |
1325 the target. */ | |
1326 | |
1327 if (XTYPE (definition) == Lisp_Cons) | |
1328 { | |
1329 Lisp_Object tem; | |
1330 tem = Fequal (binding, definition); | |
485 | 1331 if (NILP (tem)) |
250 | 1332 continue; |
1333 } | |
1334 else | |
1335 if (!EQ (binding, definition)) | |
1336 continue; | |
1337 | |
1338 /* We have found a match. | |
1339 Construct the key sequence where we found it. */ | |
1340 if (XTYPE (key) == Lisp_Int && last_is_meta) | |
1341 { | |
1342 sequence = Fcopy_sequence (this); | |
1343 Faset (sequence, last, make_number (XINT (key) | 0200)); | |
1344 } | |
1345 else | |
1346 sequence = append_key (this, key); | |
1347 | |
1348 /* Verify that this key binding is not shadowed by another | |
1349 binding for the same key, before we say it exists. | |
1350 | |
1351 Mechanism: look for local definition of this key and if | |
1352 it is defined and does not match what we found then | |
1353 ignore this key. | |
1354 | |
1355 Either nil or number as value from Flookup_key | |
1356 means undefined. */ | |
485 | 1357 if (!NILP (local_keymap)) |
250 | 1358 { |
1359 binding = Flookup_key (local_keymap, sequence); | |
485 | 1360 if (!NILP (binding) && XTYPE (binding) != Lisp_Int) |
250 | 1361 { |
1362 if (XTYPE (definition) == Lisp_Cons) | |
1363 { | |
1364 Lisp_Object tem; | |
1365 tem = Fequal (binding, definition); | |
485 | 1366 if (NILP (tem)) |
250 | 1367 continue; |
1368 } | |
1369 else | |
1370 if (!EQ (binding, definition)) | |
1371 continue; | |
1372 } | |
1373 } | |
1374 | |
1375 /* It is a true unshadowed match. Record it. */ | |
1376 | |
485 | 1377 if (!NILP (firstonly)) |
250 | 1378 return sequence; |
1379 found = Fcons (sequence, found); | |
1380 } | |
1381 } | |
1382 return Fnreverse (found); | |
1383 } | |
1384 | |
1385 /* Return a string listing the keys and buttons that run DEFINITION. */ | |
1386 | |
1387 static Lisp_Object | |
1388 where_is_string (definition) | |
1389 Lisp_Object definition; | |
1390 { | |
1391 register Lisp_Object keys, keys1; | |
1392 | |
1393 keys = Fwhere_is_internal (definition, | |
1394 current_buffer->keymap, Qnil, Qnil, Qnil); | |
1395 keys1 = Fmapconcat (Qkey_description, keys, build_string (", ")); | |
1396 | |
1397 return keys1; | |
1398 } | |
1399 | |
1400 DEFUN ("where-is", Fwhere_is, Swhere_is, 1, 1, "CWhere is command: ", | |
1401 "Print message listing key sequences that invoke specified command.\n\ | |
1402 Argument is a command definition, usually a symbol with a function definition.") | |
1403 (definition) | |
1404 Lisp_Object definition; | |
1405 { | |
1406 register Lisp_Object string; | |
1407 | |
1408 CHECK_SYMBOL (definition, 0); | |
1409 string = where_is_string (definition); | |
1410 | |
1411 if (XSTRING (string)->size) | |
1412 message ("%s is on %s", XSYMBOL (definition)->name->data, | |
1413 XSTRING (string)->data); | |
1414 else | |
1415 message ("%s is not on any key", XSYMBOL (definition)->name->data); | |
1416 return Qnil; | |
1417 } | |
1418 | |
465 | 1419 /* describe-bindings - summarizing all the bindings in a set of keymaps. */ |
1420 | |
250 | 1421 DEFUN ("describe-bindings", Fdescribe_bindings, Sdescribe_bindings, 0, 0, "", |
1422 "Show a list of all defined keys, and their definitions.\n\ | |
1423 The list is put in a buffer, which is displayed.") | |
1424 () | |
1425 { | |
1426 register Lisp_Object thisbuf; | |
1427 XSET (thisbuf, Lisp_Buffer, current_buffer); | |
1428 internal_with_output_to_temp_buffer ("*Help*", | |
1429 describe_buffer_bindings, | |
1430 thisbuf); | |
1431 return Qnil; | |
1432 } | |
1433 | |
1434 static Lisp_Object | |
1435 describe_buffer_bindings (descbuf) | |
1436 Lisp_Object descbuf; | |
1437 { | |
1438 register Lisp_Object start1, start2; | |
1439 | |
1120
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1440 char *key_heading |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1441 = "\ |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1442 key binding\n\ |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1443 --- -------\n"; |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1444 char *alternate_heading |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1445 = "\ |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1446 Alternate Characters (use anywhere the nominal character is listed):\n\ |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1447 nominal alternate\n\ |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1448 ------- ---------\n"; |
250 | 1449 |
1450 Fset_buffer (Vstandard_output); | |
1451 | |
1120
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1452 /* Report on alternates for keys. */ |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1453 if (XTYPE (Vkeyboard_translate_table) == Lisp_String) |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1454 { |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1455 int c; |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1456 unsigned char *translate = XSTRING (Vkeyboard_translate_table)->data; |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1457 int translate_len = XSTRING (Vkeyboard_translate_table)->size; |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1458 |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1459 for (c = 0; c < translate_len; c++) |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1460 if (translate[c] != c) |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1461 { |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1462 char buf[20]; |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1463 char *bufend; |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1464 |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1465 if (alternate_heading) |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1466 { |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1467 insert_string (alternate_heading); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1468 alternate_heading = 0; |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1469 } |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1470 |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1471 bufend = push_key_description (translate[c], buf); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1472 insert (buf, bufend - buf); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1473 Findent_to (make_number (16), make_number (1)); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1474 bufend = push_key_description (c, buf); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1475 insert (buf, bufend - buf); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1476 |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1477 insert ("\n", 1); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1478 } |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1479 |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1480 insert ("\n", 1); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1481 } |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1482 |
465 | 1483 { |
1484 int i, nmaps; | |
1485 Lisp_Object *modes, *maps; | |
1486 | |
1120
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1487 /* Temporarily switch to descbuf, so that we can get that buffer's |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1488 minor modes correctly. */ |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1489 Fset_buffer (descbuf); |
465 | 1490 nmaps = current_minor_maps (&modes, &maps); |
1120
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1491 Fset_buffer (Vstandard_output); |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1492 |
465 | 1493 for (i = 0; i < nmaps; i++) |
1494 { | |
1495 if (XTYPE (modes[i]) == Lisp_Symbol) | |
1496 { | |
1497 insert_char ('`'); | |
1498 insert_string (XSYMBOL (modes[i])->name->data); | |
1499 insert_char ('\''); | |
1500 } | |
1501 else | |
1502 insert_string ("Strangely Named"); | |
1503 insert_string (" Minor Mode Bindings:\n"); | |
1120
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1504 insert_string (key_heading); |
465 | 1505 describe_map_tree (maps[i], 0, Qnil); |
1506 insert_char ('\n'); | |
1507 } | |
1508 } | |
1509 | |
250 | 1510 start1 = XBUFFER (descbuf)->keymap; |
485 | 1511 if (!NILP (start1)) |
250 | 1512 { |
1513 insert_string ("Local Bindings:\n"); | |
1120
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1514 insert_string (key_heading); |
465 | 1515 describe_map_tree (start1, 0, Qnil); |
250 | 1516 insert_string ("\n"); |
1517 } | |
1518 | |
1519 insert_string ("Global Bindings:\n"); | |
1120
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1520 if (NILP (start1)) |
0a486e1a45bc
* keymap.c (describe_buffer_bindings): Adjust key_heading to match
Jim Blandy <jimb@redhat.com>
parents:
1095
diff
changeset
|
1521 insert_string (key_heading); |
250 | 1522 |
465 | 1523 describe_map_tree (current_global_map, 0, XBUFFER (descbuf)->keymap); |
250 | 1524 |
1525 Fset_buffer (descbuf); | |
1526 return Qnil; | |
1527 } | |
1528 | |
1529 /* Insert a desription of the key bindings in STARTMAP, | |
1530 followed by those of all maps reachable through STARTMAP. | |
1531 If PARTIAL is nonzero, omit certain "uninteresting" commands | |
1532 (such as `undefined'). | |
1533 If SHADOW is non-nil, it is another map; | |
1534 don't mention keys which would be shadowed by it. */ | |
1535 | |
1536 void | |
1537 describe_map_tree (startmap, partial, shadow) | |
1538 Lisp_Object startmap, shadow; | |
1539 int partial; | |
1540 { | |
1541 register Lisp_Object elt, sh; | |
1542 Lisp_Object maps; | |
1543 struct gcpro gcpro1; | |
1544 | |
1545 maps = Faccessible_keymaps (startmap); | |
1546 GCPRO1 (maps); | |
1547 | |
485 | 1548 for (; !NILP (maps); maps = Fcdr (maps)) |
250 | 1549 { |
1550 elt = Fcar (maps); | |
1551 sh = Fcar (elt); | |
1552 | |
1553 /* If there is no shadow keymap given, don't shadow. */ | |
485 | 1554 if (NILP (shadow)) |
250 | 1555 sh = Qnil; |
1556 | |
1557 /* If the sequence by which we reach this keymap is zero-length, | |
1558 then the shadow map for this keymap is just SHADOW. */ | |
1559 else if ((XTYPE (sh) == Lisp_String | |
1560 && XSTRING (sh)->size == 0) | |
1561 || (XTYPE (sh) == Lisp_Vector | |
1562 && XVECTOR (sh)->size == 0)) | |
1563 sh = shadow; | |
1564 | |
1565 /* If the sequence by which we reach this keymap actually has | |
1566 some elements, then the sequence's definition in SHADOW is | |
1567 what we should use. */ | |
1568 else | |
1569 { | |
1570 sh = Flookup_key (shadow, Fcar (elt)); | |
1571 if (XTYPE (sh) == Lisp_Int) | |
1572 sh = Qnil; | |
1573 } | |
1574 | |
1575 /* If sh is null (meaning that the current map is not shadowed), | |
1576 or a keymap (meaning that bindings from the current map might | |
1577 show through), describe the map. Otherwise, sh is a command | |
1578 that completely shadows the current map, and we shouldn't | |
1579 bother. */ | |
485 | 1580 if (NILP (sh) || !NILP (Fkeymapp (sh))) |
250 | 1581 describe_map (Fcdr (elt), Fcar (elt), partial, sh); |
1582 } | |
1583 | |
1584 UNGCPRO; | |
1585 } | |
1586 | |
1587 static void | |
1588 describe_command (definition) | |
1589 Lisp_Object definition; | |
1590 { | |
1591 register Lisp_Object tem1; | |
1592 | |
1593 Findent_to (make_number (16), make_number (1)); | |
1594 | |
1595 if (XTYPE (definition) == Lisp_Symbol) | |
1596 { | |
1597 XSET (tem1, Lisp_String, XSYMBOL (definition)->name); | |
1598 insert1 (tem1); | |
1599 insert_string ("\n"); | |
1600 } | |
1601 else | |
1602 { | |
1603 tem1 = Fkeymapp (definition); | |
485 | 1604 if (!NILP (tem1)) |
250 | 1605 insert_string ("Prefix Command\n"); |
1606 else | |
1607 insert_string ("??\n"); | |
1608 } | |
1609 } | |
1610 | |
1611 /* Describe the contents of map MAP, assuming that this map itself is | |
1612 reached by the sequence of prefix keys KEYS (a string or vector). | |
1613 PARTIAL, SHADOW is as in `describe_map_tree' above. */ | |
1614 | |
1615 static void | |
1616 describe_map (map, keys, partial, shadow) | |
1617 Lisp_Object map, keys; | |
1618 int partial; | |
1619 Lisp_Object shadow; | |
1620 { | |
1621 register Lisp_Object keysdesc; | |
1622 | |
1517
72b7bbcaf7d8
* keymap.c (Fdefine_key, Flookup_key, describe_map): Don't assume
Jim Blandy <jimb@redhat.com>
parents:
1441
diff
changeset
|
1623 if (!NILP (keys) && XFASTINT (Flength (keys)) > 0) |
250 | 1624 keysdesc = concat2 (Fkey_description (keys), |
1625 build_string (" ")); | |
1626 else | |
1627 keysdesc = Qnil; | |
1628 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1629 describe_map_2 (map, keysdesc, describe_command, partial, shadow); |
250 | 1630 } |
1631 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1632 /* Insert a description of KEYMAP into the current buffer. */ |
250 | 1633 |
1634 static void | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1635 describe_map_2 (keymap, elt_prefix, elt_describer, partial, shadow) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1636 register Lisp_Object keymap; |
250 | 1637 Lisp_Object elt_prefix; |
1638 int (*elt_describer) (); | |
1639 int partial; | |
1640 Lisp_Object shadow; | |
1641 { | |
1642 Lisp_Object this; | |
1643 Lisp_Object tem1, tem2 = Qnil; | |
1644 Lisp_Object suppress; | |
1645 Lisp_Object kludge; | |
1646 int first = 1; | |
1647 struct gcpro gcpro1, gcpro2, gcpro3; | |
1648 | |
1649 if (partial) | |
1650 suppress = intern ("suppress-keymap"); | |
1651 | |
1652 /* This vector gets used to present single keys to Flookup_key. Since | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1653 that is done once per keymap element, we don't want to cons up a |
250 | 1654 fresh vector every time. */ |
1655 kludge = Fmake_vector (make_number (1), Qnil); | |
1656 | |
1657 GCPRO3 (elt_prefix, tem2, kludge); | |
1658 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1659 for (; CONSP (keymap); keymap = Fcdr (keymap)) |
250 | 1660 { |
1661 QUIT; | |
1662 | |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1663 if (XTYPE (XCONS (keymap)->car) == Lisp_Vector) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1664 describe_vector (XCONS (keymap)->car, |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1665 elt_prefix, elt_describer, partial, shadow); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1666 else |
250 | 1667 { |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1668 tem1 = Fcar_safe (Fcar (keymap)); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1669 tem2 = get_keyelt (Fcdr_safe (Fcar (keymap))); |
250 | 1670 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1671 /* Don't show undefined commands or suppressed commands. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1672 if (NILP (tem2)) continue; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1673 if (XTYPE (tem2) == Lisp_Symbol && partial) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1674 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1675 this = Fget (tem2, suppress); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1676 if (!NILP (this)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1677 continue; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1678 } |
250 | 1679 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1680 /* Don't show a command that isn't really visible |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1681 because a local definition of the same key shadows it. */ |
250 | 1682 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1683 if (!NILP (shadow)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1684 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1685 Lisp_Object tem; |
250 | 1686 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1687 XVECTOR (kludge)->contents[0] = tem1; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1688 tem = Flookup_key (shadow, kludge); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1689 if (!NILP (tem)) continue; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1690 } |
250 | 1691 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1692 if (first) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1693 { |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1694 insert ("\n", 1); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1695 first = 0; |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1696 } |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1697 |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1698 if (!NILP (elt_prefix)) |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1699 insert1 (elt_prefix); |
250 | 1700 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1701 /* THIS gets the string to describe the character TEM1. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1702 this = Fsingle_key_description (tem1); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1703 insert1 (this); |
250 | 1704 |
1209
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1705 /* Print a description of the definition of this character. |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1706 elt_describer will take care of spacing out far enough |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1707 for alignment purposes. */ |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1708 (*elt_describer) (tem2); |
1aa2cd425737
* keymap.c (DENSE_TABLE_SIZE): Doc fix.
Jim Blandy <jimb@redhat.com>
parents:
1160
diff
changeset
|
1709 } |
250 | 1710 } |
1711 | |
1712 UNGCPRO; | |
1713 } | |
1714 | |
1715 static int | |
1716 describe_vector_princ (elt) | |
1717 Lisp_Object elt; | |
1718 { | |
1719 Fprinc (elt, Qnil); | |
1720 } | |
1721 | |
1722 DEFUN ("describe-vector", Fdescribe_vector, Sdescribe_vector, 1, 1, 0, | |
1723 "Print on `standard-output' a description of contents of VECTOR.\n\ | |
1724 This is text showing the elements of vector matched against indices.") | |
1725 (vector) | |
1726 Lisp_Object vector; | |
1727 { | |
1728 CHECK_VECTOR (vector, 0); | |
1729 describe_vector (vector, Qnil, describe_vector_princ, 0, Qnil, Qnil); | |
1730 } | |
1731 | |
1732 describe_vector (vector, elt_prefix, elt_describer, partial, shadow) | |
1733 register Lisp_Object vector; | |
1734 Lisp_Object elt_prefix; | |
1735 int (*elt_describer) (); | |
1736 int partial; | |
1737 Lisp_Object shadow; | |
1738 { | |
1739 Lisp_Object this; | |
1740 Lisp_Object dummy; | |
1741 Lisp_Object tem1, tem2; | |
1742 register int i; | |
1743 Lisp_Object suppress; | |
1744 Lisp_Object kludge; | |
1745 int first = 1; | |
1746 struct gcpro gcpro1, gcpro2, gcpro3; | |
1747 | |
1748 tem1 = Qnil; | |
1749 | |
1750 /* This vector gets used to present single keys to Flookup_key. Since | |
1751 that is done once per vector element, we don't want to cons up a | |
1752 fresh vector every time. */ | |
1753 kludge = Fmake_vector (make_number (1), Qnil); | |
1754 GCPRO3 (elt_prefix, tem1, kludge); | |
1755 | |
1756 if (partial) | |
1757 suppress = intern ("suppress-keymap"); | |
1758 | |
1759 for (i = 0; i < DENSE_TABLE_SIZE; i++) | |
1760 { | |
1761 QUIT; | |
1762 tem1 = get_keyelt (XVECTOR (vector)->contents[i]); | |
1763 | |
485 | 1764 if (NILP (tem1)) continue; |
250 | 1765 |
1766 /* Don't mention suppressed commands. */ | |
1767 if (XTYPE (tem1) == Lisp_Symbol && partial) | |
1768 { | |
1769 this = Fget (tem1, suppress); | |
485 | 1770 if (!NILP (this)) |
250 | 1771 continue; |
1772 } | |
1773 | |
1774 /* If this command in this map is shadowed by some other map, | |
1775 ignore it. */ | |
485 | 1776 if (!NILP (shadow)) |
250 | 1777 { |
1778 Lisp_Object tem; | |
1779 | |
1780 XVECTOR (kludge)->contents[0] = make_number (i); | |
1781 tem = Flookup_key (shadow, kludge); | |
1782 | |
485 | 1783 if (!NILP (tem)) continue; |
250 | 1784 } |
1785 | |
1786 if (first) | |
1787 { | |
1788 insert ("\n", 1); | |
1789 first = 0; | |
1790 } | |
1791 | |
1792 /* Output the prefix that applies to every entry in this map. */ | |
485 | 1793 if (!NILP (elt_prefix)) |
250 | 1794 insert1 (elt_prefix); |
1795 | |
1796 /* Get the string to describe the character I, and print it. */ | |
1797 XFASTINT (dummy) = i; | |
1798 | |
1799 /* THIS gets the string to describe the character DUMMY. */ | |
1800 this = Fsingle_key_description (dummy); | |
1801 insert1 (this); | |
1802 | |
1803 /* Find all consecutive characters that have the same definition. */ | |
1804 while (i + 1 < DENSE_TABLE_SIZE | |
1805 && (tem2 = get_keyelt (XVECTOR (vector)->contents[i+1]), | |
1806 EQ (tem2, tem1))) | |
1807 i++; | |
1808 | |
1809 /* If we have a range of more than one character, | |
1810 print where the range reaches to. */ | |
1811 | |
1812 if (i != XINT (dummy)) | |
1813 { | |
1814 insert (" .. ", 4); | |
485 | 1815 if (!NILP (elt_prefix)) |
250 | 1816 insert1 (elt_prefix); |
1817 | |
1818 XFASTINT (dummy) = i; | |
1819 insert1 (Fsingle_key_description (dummy)); | |
1820 } | |
1821 | |
1822 /* Print a description of the definition of this character. | |
1823 elt_describer will take care of spacing out far enough | |
1824 for alignment purposes. */ | |
1825 (*elt_describer) (tem1); | |
1826 } | |
1827 | |
1828 UNGCPRO; | |
1829 } | |
1830 | |
465 | 1831 /* Apropos - finding all symbols whose names match a regexp. */ |
250 | 1832 Lisp_Object apropos_predicate; |
1833 Lisp_Object apropos_accumulate; | |
1834 | |
1835 static void | |
1836 apropos_accum (symbol, string) | |
1837 Lisp_Object symbol, string; | |
1838 { | |
1839 register Lisp_Object tem; | |
1840 | |
1841 tem = Fstring_match (string, Fsymbol_name (symbol), Qnil); | |
485 | 1842 if (!NILP (tem) && !NILP (apropos_predicate)) |
250 | 1843 tem = call1 (apropos_predicate, symbol); |
485 | 1844 if (!NILP (tem)) |
250 | 1845 apropos_accumulate = Fcons (symbol, apropos_accumulate); |
1846 } | |
1847 | |
1848 DEFUN ("apropos-internal", Fapropos_internal, Sapropos_internal, 1, 2, 0, | |
1849 "Show all symbols whose names contain match for REGEXP.\n\ | |
1850 If optional 2nd arg PRED is non-nil, (funcall PRED SYM) is done\n\ | |
1851 for each symbol and a symbol is mentioned only if that returns non-nil.\n\ | |
1852 Return list of symbols found.") | |
1853 (string, pred) | |
1854 Lisp_Object string, pred; | |
1855 { | |
1856 struct gcpro gcpro1, gcpro2; | |
1857 CHECK_STRING (string, 0); | |
1858 apropos_predicate = pred; | |
1859 GCPRO2 (apropos_predicate, apropos_accumulate); | |
1860 apropos_accumulate = Qnil; | |
1861 map_obarray (Vobarray, apropos_accum, string); | |
1862 apropos_accumulate = Fsort (apropos_accumulate, Qstring_lessp); | |
1863 UNGCPRO; | |
1864 return apropos_accumulate; | |
1865 } | |
1866 | |
1867 syms_of_keymap () | |
1868 { | |
1869 Lisp_Object tem; | |
1870 | |
1871 Qkeymap = intern ("keymap"); | |
1872 staticpro (&Qkeymap); | |
1873 | |
1874 /* Initialize the keymaps standardly used. | |
1875 Each one is the value of a Lisp variable, and is also | |
1876 pointed to by a C variable */ | |
1877 | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
1878 global_map = Fmake_keymap (Qnil); |
250 | 1879 Fset (intern ("global-map"), global_map); |
1880 | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
1881 meta_map = Fmake_keymap (Qnil); |
250 | 1882 Fset (intern ("esc-map"), meta_map); |
1883 Ffset (intern ("ESC-prefix"), meta_map); | |
1884 | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
1885 control_x_map = Fmake_keymap (Qnil); |
250 | 1886 Fset (intern ("ctl-x-map"), control_x_map); |
1887 Ffset (intern ("Control-X-prefix"), control_x_map); | |
1888 | |
1889 DEFVAR_LISP ("minibuffer-local-map", &Vminibuffer_local_map, | |
1890 "Default keymap to use when reading from the minibuffer."); | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
1891 Vminibuffer_local_map = Fmake_sparse_keymap (Qnil); |
250 | 1892 |
1893 DEFVAR_LISP ("minibuffer-local-ns-map", &Vminibuffer_local_ns_map, | |
1894 "Local keymap for the minibuffer when spaces are not allowed."); | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
1895 Vminibuffer_local_ns_map = Fmake_sparse_keymap (Qnil); |
250 | 1896 |
1897 DEFVAR_LISP ("minibuffer-local-completion-map", &Vminibuffer_local_completion_map, | |
1898 "Local keymap for minibuffer input with completion."); | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
1899 Vminibuffer_local_completion_map = Fmake_sparse_keymap (Qnil); |
250 | 1900 |
1901 DEFVAR_LISP ("minibuffer-local-must-match-map", &Vminibuffer_local_must_match_map, | |
1902 "Local keymap for minibuffer input with completion, for exact match."); | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
1903 Vminibuffer_local_must_match_map = Fmake_sparse_keymap (Qnil); |
250 | 1904 |
1905 current_global_map = global_map; | |
1906 | |
465 | 1907 DEFVAR_LISP ("minor-mode-map-alist", &Vminor_mode_map_alist, |
1908 "Alist of keymaps to use for minor modes.\n\ | |
1909 Each element looks like (VARIABLE . KEYMAP); KEYMAP is used to read\n\ | |
1910 key sequences and look up bindings iff VARIABLE's value is non-nil.\n\ | |
1911 If two active keymaps bind the same key, the keymap appearing earlier\n\ | |
1912 in the list takes precedence."); | |
1913 Vminor_mode_map_alist = Qnil; | |
1914 | |
517 | 1915 DEFVAR_LISP ("function-key-map", &Vfunction_key_map, |
1916 "Keymap mapping ASCII function key sequences onto their preferred forms.\n\ | |
1917 This allows Emacs to recognize function keys sent from ASCII\n\ | |
1918 terminals at any point in a key sequence.\n\ | |
1919 \n\ | |
1920 The read-key-sequence function replaces subsequences bound by\n\ | |
1921 function-key-map with their bindings. When the current local and global\n\ | |
1922 keymaps have no binding for the current key sequence but\n\ | |
1923 function-key-map binds a suffix of the sequence to a vector,\n\ | |
1924 read-key-sequence replaces the matching suffix with its binding, and\n\ | |
1925 continues with the new sequence.\n\ | |
1926 \n\ | |
1927 For example, suppose function-key-map binds `ESC O P' to [pf1].\n\ | |
1928 Typing `ESC O P' to read-key-sequence would return [pf1]. Typing\n\ | |
1929 `C-x ESC O P' would return [?\C-x pf1]. If [pf1] were a prefix\n\ | |
1930 key, typing `ESC O P x' would return [pf1 x]."); | |
1095
6578f07e9eb8
(Fmake_sparse_keymap, Fmake_keymap): New optional arg. Callers changed.
Richard M. Stallman <rms@gnu.org>
parents:
647
diff
changeset
|
1931 Vfunction_key_map = Fmake_sparse_keymap (Qnil); |
517 | 1932 |
250 | 1933 Qsingle_key_description = intern ("single-key-description"); |
1934 staticpro (&Qsingle_key_description); | |
1935 | |
1936 Qkey_description = intern ("key-description"); | |
1937 staticpro (&Qkey_description); | |
1938 | |
1939 Qkeymapp = intern ("keymapp"); | |
1940 staticpro (&Qkeymapp); | |
1941 | |
1942 defsubr (&Skeymapp); | |
1943 defsubr (&Smake_keymap); | |
1944 defsubr (&Smake_sparse_keymap); | |
1945 defsubr (&Scopy_keymap); | |
1946 defsubr (&Skey_binding); | |
1947 defsubr (&Slocal_key_binding); | |
1948 defsubr (&Sglobal_key_binding); | |
465 | 1949 defsubr (&Sminor_mode_key_binding); |
250 | 1950 defsubr (&Sglobal_set_key); |
1951 defsubr (&Slocal_set_key); | |
1952 defsubr (&Sdefine_key); | |
1953 defsubr (&Slookup_key); | |
1954 defsubr (&Sglobal_unset_key); | |
1955 defsubr (&Slocal_unset_key); | |
1956 defsubr (&Sdefine_prefix_command); | |
1957 defsubr (&Suse_global_map); | |
1958 defsubr (&Suse_local_map); | |
1959 defsubr (&Scurrent_local_map); | |
1960 defsubr (&Scurrent_global_map); | |
465 | 1961 defsubr (&Scurrent_minor_mode_maps); |
250 | 1962 defsubr (&Saccessible_keymaps); |
1963 defsubr (&Skey_description); | |
1964 defsubr (&Sdescribe_vector); | |
1965 defsubr (&Ssingle_key_description); | |
1966 defsubr (&Stext_char_description); | |
1967 defsubr (&Swhere_is_internal); | |
1968 defsubr (&Swhere_is); | |
1969 defsubr (&Sdescribe_bindings); | |
1970 defsubr (&Sapropos_internal); | |
1971 } | |
1972 | |
1973 keys_of_keymap () | |
1974 { | |
1975 Lisp_Object tem; | |
1976 | |
1977 initial_define_key (global_map, 033, "ESC-prefix"); | |
1978 initial_define_key (global_map, Ctl('X'), "Control-X-prefix"); | |
1979 } |