diff options
Diffstat (limited to 'doc/lispref')
| -rw-r--r-- | doc/lispref/ChangeLog | 10 | ||||
| -rw-r--r-- | doc/lispref/help.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/keymaps.texi | 29 |
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 @@ | |||
| 1 | 2014-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 | |||
| 6 | 2014-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 | |||
| 1 | 2014-06-28 Glenn Morris <rgm@gnu.org> | 11 | 2014-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 |
| 512 | the user as subcommands of the prefix @kbd{C-h}. For more information | 512 | the user as subcommands of the prefix @kbd{C-h}. For more information |
| 513 | about them, see @ref{Help, , Help, emacs, The GNU Emacs Manual}. Here | 513 | about them, see @ref{Help, , Help, emacs, The GNU Emacs Manual}. Here |
| 514 | we describe some program-level interfaces to the same information. | 514 | we 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 | |||
| 1043 | as such (see above). In order to execute properly as a key binding, | 1043 | as such (see above). In order to execute properly as a key binding, |
| 1044 | this function must be a command---it must have an @code{interactive} | 1044 | this function must be a command---it must have an @code{interactive} |
| 1045 | specification. @xref{Defining Commands}. | 1045 | specification. @xref{Defining Commands}. |
| 1046 | |||
| 1047 | @item | ||
| 1048 | If the @sc{car} of @var{list} is a keymap and the @sc{cdr} is an event | ||
| 1049 | type, then this is an @dfn{indirect entry}: | ||
| 1050 | |||
| 1051 | @example | ||
| 1052 | (@var{othermap} . @var{othertype}) | ||
| 1053 | @end example | ||
| 1054 | |||
| 1055 | When key lookup encounters an indirect entry, it looks up instead the | ||
| 1056 | binding of @var{othertype} in @var{othermap} and uses that. | ||
| 1057 | |||
| 1058 | This feature permits you to define one key as an alias for another key. | ||
| 1059 | For example, an entry whose @sc{car} is the keymap called @code{esc-map} | ||
| 1060 | and whose @sc{cdr} is 32 (the code for @key{SPC}) means, ``Use the global | ||
| 1061 | binding 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''. | |||
| 1066 | The function definition of @var{symbol} is used in place of | 1050 | The 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, |
| 1068 | any number of times. Ultimately this should lead to an object that is | 1052 | any number of times. Ultimately this should lead to an object that is |
| 1069 | a keymap, a command, or a keyboard macro. A list is allowed if it is a | 1053 | a keymap, a command, or a keyboard macro. |
| 1070 | keymap or a command, but indirect entries are not understood when found | ||
| 1071 | via symbols. | ||
| 1072 | 1054 | ||
| 1073 | Note that keymaps and keyboard macros (strings and vectors) are not | 1055 | Note that keymaps and keyboard macros (strings and vectors) are not |
| 1074 | valid functions, so a symbol with a keymap, string, or vector as its | 1056 | valid 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 |
| 1100 | macro, a symbol that leads to one of them, or an indirection or | 1082 | macro, 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} | |||
| 1945 | characters) are preferred to all other key sequences and that the | 1926 | characters) are preferred to all other key sequences and that the |
| 1946 | return value can never be a menu binding. | 1927 | return value can never be a menu binding. |
| 1947 | 1928 | ||
| 1948 | If @var{noindirect} is non-@code{nil}, @code{where-is-internal} doesn't | 1929 | If @var{noindirect} is non-@code{nil}, @code{where-is-internal} doesn't look |
| 1949 | follow indirect keymap bindings. This makes it possible to search for | 1930 | inside menu-items to find their commands. This makes it possible to search for |
| 1950 | an indirect definition itself. | 1931 | a menu-item itself. |
| 1951 | 1932 | ||
| 1952 | The fifth argument, @var{no-remap}, determines how this function | 1933 | The fifth argument, @var{no-remap}, determines how this function |
| 1953 | treats command remappings (@pxref{Remapping Commands}). There are two | 1934 | treats command remappings (@pxref{Remapping Commands}). There are two |