aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref
diff options
context:
space:
mode:
Diffstat (limited to 'doc/lispref')
-rw-r--r--doc/lispref/ChangeLog10
-rw-r--r--doc/lispref/help.texi2
-rw-r--r--doc/lispref/keymaps.texi29
3 files changed, 16 insertions, 25 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 4302b53a63a..cc372b006ed 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,13 @@
12014-07-03 Glenn Morris <rgm@gnu.org>
2
3 * help.texi (Help Functions): "Online" help doesn't mean what it
4 used to any more.
5
62014-07-02 Stefan Monnier <monnier@iro.umontreal.ca>
7
8 * keymaps.texi (Key Lookup): Remove mention of indirect entries.
9 (Scanning Keymaps): Reword the `noindirect' argument.
10
12014-06-28 Glenn Morris <rgm@gnu.org> 112014-06-28 Glenn Morris <rgm@gnu.org>
2 12
3 * minibuf.texi (Intro to Minibuffers): Batch mode is basic. 13 * minibuf.texi (Intro to Minibuffers): Batch mode is basic.
diff --git a/doc/lispref/help.texi b/doc/lispref/help.texi
index 9a763b60938..20fb0e651f9 100644
--- a/doc/lispref/help.texi
+++ b/doc/lispref/help.texi
@@ -508,7 +508,7 @@ non-@code{nil}, the return value is always a vector.
508@node Help Functions 508@node Help Functions
509@section Help Functions 509@section Help Functions
510 510
511 Emacs provides a variety of on-line help functions, all accessible to 511 Emacs provides a variety of built-in help functions, all accessible to
512the user as subcommands of the prefix @kbd{C-h}. For more information 512the user as subcommands of the prefix @kbd{C-h}. For more information
513about them, see @ref{Help, , Help, emacs, The GNU Emacs Manual}. Here 513about them, see @ref{Help, , Help, emacs, The GNU Emacs Manual}. Here
514we describe some program-level interfaces to the same information. 514we describe some program-level interfaces to the same information.
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 7cc2b393456..e652da03385 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -1043,22 +1043,6 @@ lambda expression. This is presumed to be a function, and is treated
1043as such (see above). In order to execute properly as a key binding, 1043as such (see above). In order to execute properly as a key binding,
1044this function must be a command---it must have an @code{interactive} 1044this function must be a command---it must have an @code{interactive}
1045specification. @xref{Defining Commands}. 1045specification. @xref{Defining Commands}.
1046
1047@item
1048If the @sc{car} of @var{list} is a keymap and the @sc{cdr} is an event
1049type, then this is an @dfn{indirect entry}:
1050
1051@example
1052(@var{othermap} . @var{othertype})
1053@end example
1054
1055When key lookup encounters an indirect entry, it looks up instead the
1056binding of @var{othertype} in @var{othermap} and uses that.
1057
1058This feature permits you to define one key as an alias for another key.
1059For example, an entry whose @sc{car} is the keymap called @code{esc-map}
1060and whose @sc{cdr} is 32 (the code for @key{SPC}) means, ``Use the global
1061binding of @kbd{Meta-@key{SPC}}, whatever that may be''.
1062@end itemize 1046@end itemize
1063 1047
1064@item @var{symbol} 1048@item @var{symbol}
@@ -1066,9 +1050,7 @@ binding of @kbd{Meta-@key{SPC}}, whatever that may be''.
1066The function definition of @var{symbol} is used in place of 1050The function definition of @var{symbol} is used in place of
1067@var{symbol}. If that too is a symbol, then this process is repeated, 1051@var{symbol}. If that too is a symbol, then this process is repeated,
1068any number of times. Ultimately this should lead to an object that is 1052any number of times. Ultimately this should lead to an object that is
1069a keymap, a command, or a keyboard macro. A list is allowed if it is a 1053a keymap, a command, or a keyboard macro.
1070keymap or a command, but indirect entries are not understood when found
1071via symbols.
1072 1054
1073Note that keymaps and keyboard macros (strings and vectors) are not 1055Note that keymaps and keyboard macros (strings and vectors) are not
1074valid functions, so a symbol with a keymap, string, or vector as its 1056valid functions, so a symbol with a keymap, string, or vector as its
@@ -1097,8 +1079,7 @@ binding is not executable as a command.
1097@end table 1079@end table
1098 1080
1099 In short, a keymap entry may be a keymap, a command, a keyboard 1081 In short, a keymap entry may be a keymap, a command, a keyboard
1100macro, a symbol that leads to one of them, or an indirection or 1082macro, a symbol that leads to one of them, or @code{nil}.
1101@code{nil}.
1102 1083
1103@node Functions for Key Lookup 1084@node Functions for Key Lookup
1104@section Functions for Key Lookup 1085@section Functions for Key Lookup
@@ -1945,9 +1926,9 @@ entirely of @acronym{ASCII} characters (or meta variants of @acronym{ASCII}
1945characters) are preferred to all other key sequences and that the 1926characters) are preferred to all other key sequences and that the
1946return value can never be a menu binding. 1927return value can never be a menu binding.
1947 1928
1948If @var{noindirect} is non-@code{nil}, @code{where-is-internal} doesn't 1929If @var{noindirect} is non-@code{nil}, @code{where-is-internal} doesn't look
1949follow indirect keymap bindings. This makes it possible to search for 1930inside menu-items to find their commands. This makes it possible to search for
1950an indirect definition itself. 1931a menu-item itself.
1951 1932
1952The fifth argument, @var{no-remap}, determines how this function 1933The fifth argument, @var{no-remap}, determines how this function
1953treats command remappings (@pxref{Remapping Commands}). There are two 1934treats command remappings (@pxref{Remapping Commands}). There are two