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

[Miles Bader]

Index: emacs/lispref/os.texi
diff -c emacs/lispref/os.texi:1.48.2.7 emacs/lispref/os.texi:1.48.2.8
*** emacs/lispref/os.texi:1.48.2.7      Thu Jul  8 08:13:17 2004
--- emacs/lispref/os.texi       Sat Sep  4 09:21:45 2004
***************
*** 1686,1697 ****
  @code{function-key-map}.
  
  @item
! @code{key-translation-map} overrides actual key bindings.  For example,
! if @kbd{C-x f} has a binding in @code{key-translation-map}, that
! translation takes effect even though @kbd{C-x f} also has a key binding
! in the global map.
  @end itemize
  
  The intent of @code{key-translation-map} is for users to map one
  character set to another, including ordinary characters normally bound
  to @code{self-insert-command}.
--- 1686,1703 ----
  @code{function-key-map}.
  
  @item
! Non-prefix bindings in @code{key-translation-map} override actual key
! bindings.  For example, if @kbd{C-x f} has a non-prefix binding in
! @code{key-translation-map}, that translation takes effect even though
! @kbd{C-x f} also has a key binding in the global map.
  @end itemize
  
+ Note however that actual key bindings can have an effect on
+ @code{key-translation-map}, even though they are overridden by it.
+ Indeed, actual key bindings override @code{function-key-map} and thus
+ may alter the key sequence that @code{key-translation-map} receives.
+ Clearly, it is better to avoid to avoid this type of situation.
+ 
  The intent of @code{key-translation-map} is for users to map one
  character set to another, including ordinary characters normally bound
  to @code{self-insert-command}.