/[emacs]/emacs/lispref/keymaps.texi
ViewVC logotype

Diff of /emacs/lispref/keymaps.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.47 by fx, Mon Oct 6 16:41:55 2003 UTC revision 1.48 by eliz, Sun Nov 2 06:29:57 2003 UTC
# Line 231  satisfies @code{keymapp}. Line 231  satisfies @code{keymapp}.
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    
# Line 593  other. Line 593  other.
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
# Line 999  This variable is the meta-prefix charact Line 999  This variable is the meta-prefix charact
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
# Line 1361  redefines @kbd{C-x C-\} to move down a l Line 1361  redefines @kbd{C-x C-\} to move down a l
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:
# Line 1576  If @var{firstonly} is @code{non-ascii}, Line 1576  If @var{firstonly} is @code{non-ascii},
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
# Line 1609  listing includes only keys that start wi Line 1609  listing includes only keys that start wi
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
# Line 1695  looks like this: Line 1695  looks like this:
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

Legend:
Removed from v.1.47  
changed lines
  Added in v.1.48

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26