Commit 1ef5eecc authored by Eric S. Raymond's avatar Eric S. Raymond
Browse files

Document the fact that (current-local-map) and (urrent-global-map)

return references, not copies.
parent d5079317
2008-05-03 Eric S. Raymond <esr@golux>
* keymaps.texi: Clarify that (current-local-map) and
(current-global-map) return references, not copies.
2008-05-02 Juri Linkov <juri@jurta.org> 2008-05-02 Juri Linkov <juri@jurta.org>
* minibuf.texi (Text from Minibuffer): Document a list of * minibuf.texi (Text from Minibuffer): Document a list of
......
...@@ -766,9 +766,11 @@ out with. ...@@ -766,9 +766,11 @@ out with.
@end defvar @end defvar
@defun current-global-map @defun current-global-map
This function returns the current global keymap. This is the This function returns the current global keymap. This is the same as
same as the value of @code{global-map} unless you change one or the the value of @code{global-map} unless you change one or the other.
other. The return value is a reference, not a copy; if you use
@code{define-key} or other functions on it you will alter global
bindings.
@example @example
@group @group
...@@ -802,6 +804,10 @@ keymap. ...@@ -802,6 +804,10 @@ keymap.
@end example @end example
@end defun @end defun
@code{current-local-map} returns a reference to the local keymap, not
a copy of it; if you use @code{define-key} or other functions on it
you will alter local bindings.
@defun current-minor-mode-maps @defun current-minor-mode-maps
This function returns a list of the keymaps of currently enabled minor modes. This function returns a list of the keymaps of currently enabled minor modes.
@end defun @end defun
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment