231 |
@defun make-keymap &optional prompt |
@defun make-keymap &optional prompt |
232 |
This function creates and returns a new full keymap. That keymap |
This function creates and returns a new full keymap. That keymap |
233 |
contains a char-table (@pxref{Char-Tables}) with 384 slots: the first |
contains a char-table (@pxref{Char-Tables}) with 384 slots: the first |
234 |
128 slots are for defining all the @sc{ascii} characters, the next 128 |
128 slots are for defining all the @acronym{ASCII} characters, the next 128 |
235 |
slots are for 8-bit European characters, and each one of the final 128 |
slots are for 8-bit European characters, and each one of the final 128 |
236 |
slots is for one character set of non-@sc{ascii} characters supported by |
slots is for one character set of non-@acronym{ASCII} characters supported by |
237 |
Emacs. The new keymap initially binds all these characters to |
Emacs. The new keymap initially binds all these characters to |
238 |
@code{nil}, and does not bind any other kind of event. |
@code{nil}, and does not bind any other kind of event. |
239 |
|
|
593 |
This function returns the current buffer's local keymap, or @code{nil} |
This function returns the current buffer's local keymap, or @code{nil} |
594 |
if it has none. In the following example, the keymap for the |
if it has none. In the following example, the keymap for the |
595 |
@samp{*scratch*} buffer (using Lisp Interaction mode) is a sparse keymap |
@samp{*scratch*} buffer (using Lisp Interaction mode) is a sparse keymap |
596 |
in which the entry for @key{ESC}, @sc{ascii} code 27, is another sparse |
in which the entry for @key{ESC}, @acronym{ASCII} code 27, is another sparse |
597 |
keymap. |
keymap. |
598 |
|
|
599 |
@example |
@example |
999 |
translating a meta character to a two-character sequence so it can be |
translating a meta character to a two-character sequence so it can be |
1000 |
looked up in a keymap. For useful results, the value should be a prefix |
looked up in a keymap. For useful results, the value should be a prefix |
1001 |
event (@pxref{Prefix Keys}). The default value is 27, which is the |
event (@pxref{Prefix Keys}). The default value is 27, which is the |
1002 |
@sc{ascii} code for @key{ESC}. |
@acronym{ASCII} code for @key{ESC}. |
1003 |
|
|
1004 |
As long as the value of @code{meta-prefix-char} remains 27, key lookup |
As long as the value of @code{meta-prefix-char} remains 27, key lookup |
1005 |
translates @kbd{M-b} into @kbd{@key{ESC} b}, which is normally defined |
translates @kbd{M-b} into @kbd{@key{ESC} b}, which is normally defined |
1361 |
redefines the first (leftmost) mouse button, typed with the Meta key, to |
redefines the first (leftmost) mouse button, typed with the Meta key, to |
1362 |
set point where you click. |
set point where you click. |
1363 |
|
|
1364 |
@cindex non-@sc{ascii} text in keybindings |
@cindex non-@acronym{ASCII} text in keybindings |
1365 |
Be careful when using non-@sc{ascii} text characters in Lisp |
Be careful when using non-@acronym{ASCII} text characters in Lisp |
1366 |
specifications of keys to bind. If these are read as multibyte text, as |
specifications of keys to bind. If these are read as multibyte text, as |
1367 |
they usually will be in a Lisp file (@pxref{Loading Non-ASCII}), you |
they usually will be in a Lisp file (@pxref{Loading Non-ASCII}), you |
1368 |
must type the keys as multibyte too. For instance, if you use this: |
must type the keys as multibyte too. For instance, if you use this: |
1576 |
string representing the first key sequence found, rather than a list of |
string representing the first key sequence found, rather than a list of |
1577 |
all possible key sequences. If @var{firstonly} is @code{t}, then the |
all possible key sequences. If @var{firstonly} is @code{t}, then the |
1578 |
value is the first key sequence, except that key sequences consisting |
value is the first key sequence, except that key sequences consisting |
1579 |
entirely of @sc{ascii} characters (or meta variants of @sc{ascii} |
entirely of @acronym{ASCII} characters (or meta variants of @acronym{ASCII} |
1580 |
characters) are preferred to all other key sequences. |
characters) are preferred to all other key sequences. |
1581 |
|
|
1582 |
If @var{noindirect} is non-@code{nil}, @code{where-is-internal} doesn't |
If @var{noindirect} is non-@code{nil}, @code{where-is-internal} doesn't |
1609 |
The listing describes meta characters as @key{ESC} followed by the |
The listing describes meta characters as @key{ESC} followed by the |
1610 |
corresponding non-meta character. |
corresponding non-meta character. |
1611 |
|
|
1612 |
When several characters with consecutive @sc{ascii} codes have the |
When several characters with consecutive @acronym{ASCII} codes have the |
1613 |
same definition, they are shown together, as |
same definition, they are shown together, as |
1614 |
@samp{@var{firstchar}..@var{lastchar}}. In this instance, you need to |
@samp{@var{firstchar}..@var{lastchar}}. In this instance, you need to |
1615 |
know the @sc{ascii} codes to understand which characters this means. |
know the @acronym{ASCII} codes to understand which characters this means. |
1616 |
For example, in the default global map, the characters @samp{@key{SPC} |
For example, in the default global map, the characters @samp{@key{SPC} |
1617 |
..@: ~} are described by a single line. @key{SPC} is @sc{ascii} 32, |
..@: ~} are described by a single line. @key{SPC} is @acronym{ASCII} 32, |
1618 |
@kbd{~} is @sc{ascii} 126, and the characters between them include all |
@kbd{~} is @acronym{ASCII} 126, and the characters between them include all |
1619 |
the normal printing characters, (e.g., letters, digits, punctuation, |
the normal printing characters, (e.g., letters, digits, punctuation, |
1620 |
etc.@:); all these characters are bound to @code{self-insert-command}. |
etc.@:); all these characters are bound to @code{self-insert-command}. |
1621 |
@end deffn |
@end deffn |
1695 |
The @sc{car}, @var{item-string}, is the string to be displayed in the |
The @sc{car}, @var{item-string}, is the string to be displayed in the |
1696 |
menu. It should be short---preferably one to three words. It should |
menu. It should be short---preferably one to three words. It should |
1697 |
describe the action of the command it corresponds to. Note that it is |
describe the action of the command it corresponds to. Note that it is |
1698 |
not generally possible to display non-ASCII text in menus. It will |
not generally possible to display non-@acronym{ASCII} text in menus. It will |
1699 |
work for keyboard menus and will work to a large extent when Emacs is |
work for keyboard menus and will work to a large extent when Emacs is |
1700 |
built with Gtk+ support.@footnote{In this case, the text is first |
built with Gtk+ support.@footnote{In this case, the text is first |
1701 |
encoded using the @code{utf-8} coding system and then rendered by the |
encoded using the @code{utf-8} coding system and then rendered by the |