[Emacs-diffs] Changes to emacs/lispref/keymaps.texi

[Richard M . Stallman]

Index: emacs/lispref/keymaps.texi
diff -c emacs/lispref/keymaps.texi:1.64 emacs/lispref/keymaps.texi:1.65
*** emacs/lispref/keymaps.texi:1.64     Sat Jun 18 13:51:33 2005
--- emacs/lispref/keymaps.texi  Tue Jun 28 18:51:02 2005
***************
*** 257,274 ****
  
    Here we describe the functions for creating keymaps.
  
! @c ??? This should come after make-sparse-keymap
! @defun make-keymap &optional prompt
! This function creates and returns a new full keymap.  That keymap
! contains a char-table (@pxref{Char-Tables}) with slots for all
! characters without modifiers.  The new keymap initially binds all
! these characters to @code{nil}, and does not bind any other kind of
! event.
  
  @example
  @group
! (make-keymap)
!     @result{} (keymap #^[t nil nil nil @dots{} nil nil keymap])
  @end group
  @end example
  
--- 257,272 ----
  
    Here we describe the functions for creating keymaps.
  
! @defun make-sparse-keymap &optional prompt
! This function creates and returns a new sparse keymap with no entries.
! (A sparse keymap is the kind of keymap you usually want.)  The new
! keymap does not contain a char-table, unlike @code{make-keymap}, and
! does not bind any events.
  
  @example
  @group
! (make-sparse-keymap)
!     @result{} (keymap)
  @end group
  @end example
  
***************
*** 277,294 ****
  (@pxref{Defining Menus}).
  @end defun
  
! @defun make-sparse-keymap &optional prompt
! This function creates and returns a new sparse keymap with no entries.
! The new keymap does not contain a char-table, unlike @code{make-keymap},
! and does not bind any events.  The argument @var{prompt} specifies a
! prompt string, as in @code{make-keymap}.
  
  @example
  @group
! (make-sparse-keymap)
!     @result{} (keymap)
  @end group
  @end example
  @end defun
  
  @defun copy-keymap keymap
--- 275,297 ----
  (@pxref{Defining Menus}).
  @end defun
  
! @defun make-keymap &optional prompt
! This function creates and returns a new full keymap.  That keymap
! contains a char-table (@pxref{Char-Tables}) with slots for all
! characters without modifiers.  The new keymap initially binds all
! these characters to @code{nil}, and does not bind any other kind of
! event.  The argument @var{prompt} specifies a
! prompt string, as in @code{make-sparse-keymap}.
  
  @example
  @group
! (make-keymap)
!     @result{} (keymap #^[t nil nil nil @dots{} nil nil keymap])
  @end group
  @end example
+ 
+ A full keymap is more efficient than a sparse keymap when it holds
+ lots of bindings; for just a few, the sparse keymap is better.
  @end defun
  
  @defun copy-keymap keymap