aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChong Yidong2013-12-25 18:24:52 +0800
committerChong Yidong2013-12-25 18:24:52 +0800
commitc93525876d67837669c5e8f89b6606b4cfb55ec4 (patch)
tree9518ab8234c570b12cdf9f6964c895e47c9a49e8
parentff1c842a9477dee39fa20f885d64288b4947a040 (diff)
downloademacs-c93525876d67837669c5e8f89b6606b4cfb55ec4.tar.gz
emacs-c93525876d67837669c5e8f89b6606b4cfb55ec4.zip
Doc updates for several Emacs 24.4 changes.
* doc/lispref/commands.texi (Event Input Misc): Document new arg to input-pending-p. * doc/lispref/display.texi (Font Selection): Tweak example. * doc/lispref/keymaps.texi (Active Keymaps): Re-organize the text. (Searching Keymaps): Rewrite the pseudo-code for 24.4 changes. (Controlling Active Maps): Note that set-transient-map uses overriding-terminal-local-map. * doc/lispref/nonascii.texi (Specifying Coding Systems): Don't refer to emacs-mule-dos. (Lisp and Coding Systems): Describe emacs-mule return value in modern terms. * doc/lispref/tips.texi (Coding Conventions): Tweak the coding system tip; Emacs now uses utf-8 by default for Emacs Lisp source files. * doc/emacs/glossary.texi (Glossary): Define MULE in modern terms. * src/keyboard.c (Voverriding_terminal_local_map): (Voverriding_local_map): Doc fix. * src/keymap.c (Vemulation_mode_map_alists): Doc fix.
-rw-r--r--doc/emacs/ChangeLog4
-rw-r--r--doc/emacs/glossary.texi12
-rw-r--r--doc/emacs/mule.texi1
-rw-r--r--doc/lispref/ChangeLog20
-rw-r--r--doc/lispref/commands.texi6
-rw-r--r--doc/lispref/display.texi4
-rw-r--r--doc/lispref/keymaps.texi196
-rw-r--r--doc/lispref/nonascii.texi16
-rw-r--r--doc/lispref/tips.texi13
-rw-r--r--etc/NEWS13
-rw-r--r--src/ChangeLog7
-rw-r--r--src/keyboard.c13
-rw-r--r--src/keymap.c2
13 files changed, 171 insertions, 136 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 9b6868857e8..96008f63e93 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
12013-12-25 Chong Yidong <cyd@gnu.org>
2
3 * glossary.texi (Glossary): Define MULE in modern terms.
4
12013-12-25 Xue Fuqiao <xfq.free@gmail.com> 52013-12-25 Xue Fuqiao <xfq.free@gmail.com>
2 6
3 * files.texi (Diff Mode): Add an index. 7 * files.texi (Diff Mode): Add an index.
diff --git a/doc/emacs/glossary.texi b/doc/emacs/glossary.texi
index c8b4b40416f..d6c8477b1c6 100644
--- a/doc/emacs/glossary.texi
+++ b/doc/emacs/glossary.texi
@@ -953,9 +953,15 @@ another. The usual way to move text is by killing (q.v.@:) it and then
953yanking (q.v.@:) it. @xref{Killing}. 953yanking (q.v.@:) it. @xref{Killing}.
954 954
955@item MULE 955@item MULE
956MULE refers to the Emacs features for editing multilingual 956@cindex MULE
957non-@acronym{ASCII} text using multibyte characters (q.v.). 957Prior to Emacs 23, @acronym{MULE} was the name of a software package
958@xref{International}. 958which provided a @dfn{MULtilingual Enhancement} to Emacs, by adding
959support for multiple character sets (q.v.). @acronym{MULE} was later
960integrated into Emacs, and much of it was replaced when Emacs gained
961internal Unicode support in version 23.
962
963Some parts of Emacs that deal with character set support still use the
964@acronym{MULE} name. @xref{International}.
959 965
960@item Multibyte Character 966@item Multibyte Character
961A multibyte character is a character that takes up several bytes in a 967A multibyte character is a character that takes up several bytes in a
diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi
index 6efbc2b7190..e0653c96f8b 100644
--- a/doc/emacs/mule.texi
+++ b/doc/emacs/mule.texi
@@ -5,7 +5,6 @@
5@chapter International Character Set Support 5@chapter International Character Set Support
6@c This node is referenced in the tutorial. When renaming or deleting 6@c This node is referenced in the tutorial. When renaming or deleting
7@c it, the tutorial needs to be adjusted. (TUTORIAL.de) 7@c it, the tutorial needs to be adjusted. (TUTORIAL.de)
8@cindex MULE
9@cindex international scripts 8@cindex international scripts
10@cindex multibyte characters 9@cindex multibyte characters
11@cindex encoding of characters 10@cindex encoding of characters
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 738dd417fd2..354efd5f40c 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,23 @@
12013-12-25 Chong Yidong <cyd@gnu.org>
2
3 * keymaps.texi (Active Keymaps): Re-organize the text.
4 (Searching Keymaps): Rewrite the pseudo-code for 24.4 changes.
5 (Controlling Active Maps): Note that set-transient-map uses
6 overriding-terminal-local-map.
7
8 * tips.texi (Coding Conventions): Tweak the coding system tip;
9 Emacs now uses utf-8 by default for Emacs Lisp source files.
10
11 * display.texi (Font Selection): Tweak example.
12
13 * commands.texi (Event Input Misc): Document new arg to
14 input-pending-p.
15
16 * nonascii.texi (Specifying Coding Systems): Don't refer to
17 emacs-mule-dos.
18 (Lisp and Coding Systems): Describe emacs-mule return value in
19 modern terms.
20
12013-12-25 Tassilo Horn <tsdh@gnu.org> 212013-12-25 Tassilo Horn <tsdh@gnu.org>
2 22
3 * control.texi (Pattern matching case statement): Rephrase lexical 23 * control.texi (Pattern matching case statement): Rephrase lexical
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 846d6f3a4a9..a9322640880 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -2739,12 +2739,16 @@ This function converts the string or vector @var{key} to a list of
2739individual events, which you can put in @code{unread-command-events}. 2739individual events, which you can put in @code{unread-command-events}.
2740@end defun 2740@end defun
2741 2741
2742@defun input-pending-p 2742@defun input-pending-p &optional check-timers
2743@cindex waiting for command key input 2743@cindex waiting for command key input
2744This function determines whether any command input is currently 2744This function determines whether any command input is currently
2745available to be read. It returns immediately, with value @code{t} if 2745available to be read. It returns immediately, with value @code{t} if
2746there is available input, @code{nil} otherwise. On rare occasions it 2746there is available input, @code{nil} otherwise. On rare occasions it
2747may return @code{t} when no input is available. 2747may return @code{t} when no input is available.
2748
2749If the optional argument @var{check-timers} is non-@code{nil}, then if
2750no input is available, Emacs runs any timers which are ready.
2751@xref{Timers}.
2748@end defun 2752@end defun
2749 2753
2750@defvar last-input-event 2754@defvar last-input-event
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index ead436ab809..6bb8f64d9eb 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2962,11 +2962,11 @@ scalable font is enabled for use if its name matches any regular
2962expression in the list. For example, 2962expression in the list. For example,
2963 2963
2964@example 2964@example
2965(setq scalable-fonts-allowed '("muleindian-2$")) 2965(setq scalable-fonts-allowed '("iso10646-1$"))
2966@end example 2966@end example
2967 2967
2968@noindent 2968@noindent
2969allows the use of scalable fonts with registry @code{muleindian-2}. 2969allows the use of scalable fonts with registry @code{iso10646-1}.
2970@end defopt 2970@end defopt
2971 2971
2972@defvar face-font-rescale-alist 2972@defvar face-font-rescale-alist
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 86e205cf14d..c5ffbc964cc 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -622,75 +622,67 @@ string for the keymap. The prompt string should be given for menu keymaps
622@node Active Keymaps 622@node Active Keymaps
623@section Active Keymaps 623@section Active Keymaps
624@cindex active keymap 624@cindex active keymap
625@cindex global keymap
626@cindex local keymap
627 625
628 Emacs normally contains many keymaps; at any given time, just a few 626 Emacs contains many keymaps, but at any time only a few keymaps are
629of them are @dfn{active}, meaning that they participate in the 627@dfn{active}. When Emacs receives user input, it translates the input
630interpretation of user input. All the active keymaps are used 628event (@pxref{Translation Keymaps}), and looks for a key binding in
631together to determine what command to execute when a key is entered. 629the active keymaps.
632 630
633 Normally the active keymaps are the @code{keymap} property keymap, 631 Usually, the active keymaps are: (i) the keymap specified by the
634the keymaps of any enabled minor modes, the current buffer's local 632@code{keymap} property, (ii) the keymaps of enabled minor modes, (iii)
635keymap, and the global keymap, in that order. Emacs searches for each 633the current buffer's local keymap, and (iv) the global keymap, in that
636input key sequence in all these keymaps. @xref{Searching Keymaps}, 634order. Emacs searches for each input key sequence in all these
637for more details of this procedure. 635keymaps.
638 636
639 When the key sequence starts with a mouse event, 637 Of these ``usual'' keymaps, the highest-precedence one is specified
640the active keymaps are determined based on the 638by the @code{keymap} text or overlay property at point, if any. (For
641position in that event. If the event happened on a string embedded 639a mouse input event, Emacs uses the event position instead of point;
642with a @code{display}, @code{before-string}, or @code{after-string} 640@iftex
643property (@pxref{Special Properties}), the non-@code{nil} map 641see the next section for details.)
644properties of the string override those of the buffer (if the 642@end iftex
645underlying buffer text contains map properties in its text properties 643@ifnottex
646or overlays, they are ignored). 644@pxref{Searching Keymaps}.)
647 645@end ifnottex
648 The @dfn{global keymap} holds the bindings of keys that are defined 646
649regardless of the current buffer, such as @kbd{C-f}. The variable 647 Next in precedence are keymaps specified by enabled minor modes.
650@code{global-map} holds this keymap, which is always active. 648These keymaps, if any, are specified by the variables
651 649@code{emulation-mode-map-alists},
652 Each buffer may have another keymap, its @dfn{local keymap}, which 650@code{minor-mode-overriding-map-alist}, and
653may contain new or overriding definitions for keys. The current 651@code{minor-mode-map-alist}. @xref{Controlling Active Maps}.
654buffer's local keymap is always active except when
655@code{overriding-local-map} overrides it. The @code{local-map} text
656or overlay property can specify an alternative local keymap for certain
657parts of the buffer; see @ref{Special Properties}.
658
659 Each minor mode can have a keymap; if it does, the keymap is active
660when the minor mode is enabled. Modes for emulation can specify
661additional active keymaps through the variable
662@code{emulation-mode-map-alists}.
663
664 The highest precedence normal keymap comes from the @code{keymap}
665text or overlay property. If that is non-@code{nil}, it is the first
666keymap to be processed, in normal circumstances.
667
668 However, there are also special ways for programs to substitute
669other keymaps for some of those. The variable
670@code{overriding-local-map}, if non-@code{nil}, specifies a keymap
671that replaces all the usual active keymaps except the global keymap.
672
673The very highest precedence keymap comes from
674@code{overriding-terminal-local-map}; it operates on a per-terminal basis and
675is normally used for modal/transient keybindings.
676 652
677@cindex major mode keymap 653@cindex local keymap
678 Since every buffer that uses the same major mode normally uses the 654 Next in precedence is the buffer's @dfn{local keymap}, containing
679same local keymap, you can think of the keymap as local to the mode. A 655key bindings specific to the buffer. The minibuffer also has a local
680change to the local keymap of a buffer (using @code{local-set-key}, for 656keymap (@pxref{Intro to Minibuffers}). If there is a @code{local-map}
681example) is seen also in the other buffers that share that keymap. 657text or overlay property at point, that specifies the local keymap to
682 658use, in place of the buffer's default local keymap.
683 The local keymaps that are used for Lisp mode and some other major
684modes exist even if they have not yet been used. These local keymaps are
685the values of variables such as @code{lisp-mode-map}. For most major
686modes, which are less frequently used, the local keymap is constructed
687only when the mode is used for the first time in a session.
688 659
689 The minibuffer has local keymaps, too; they contain various completion 660@cindex major mode keymap
690and exit commands. @xref{Intro to Minibuffers}. 661 The local keymap is normally set by the buffer's major mode, and
662every buffer with the same major mode shares the same local keymap.
663Hence, if you call @code{local-set-key} (@pxref{Key Binding Commands})
664to change the local keymap in one buffer, that also affects the local
665keymaps in other buffers with the same major mode.
691 666
692 Emacs has other keymaps that are used in a different way---translating 667@cindex global keymap
693events within @code{read-key-sequence}. @xref{Translation Keymaps}. 668 Finally, the @dfn{global keymap} contains key bindings that are
669defined regardless of the current buffer, such as @kbd{C-f}. It is
670always active, and is bound to the variable @code{global-map}.
671
672 Apart from the above ``usual'' keymaps, Emacs provides special ways
673for programs to make other keymaps active. Firstly, the variable
674@code{overriding-local-map} specifies a keymap that replaces the usual
675active keymaps, except for the global keymap. Secondly, the
676terminal-local variable @code{overriding-terminal-local-map} specifies
677a keymap that takes precedence over @emph{all} other keymaps
678(including @code{overriding-local-map}); this is normally used for
679modal/transient keybindings (the function @code{set-transient-map}
680provides a convenient interface for this). @xref{Controlling Active
681Maps}, for details.
682
683 Making keymaps active is not the only way to use them. Keymaps are
684also used in other ways, such as for translating events within
685@code{read-key-sequence}. @xref{Translation Keymaps}.
694 686
695 @xref{Standard Keymaps}, for a list of some standard keymaps. 687 @xref{Standard Keymaps}, for a list of some standard keymaps.
696 688
@@ -727,7 +719,7 @@ If @var{position} is non-@code{nil}, it should be either a buffer
727position or an event position like the value of @code{event-start}. 719position or an event position like the value of @code{event-start}.
728Then the maps consulted are determined based on @var{position}. 720Then the maps consulted are determined based on @var{position}.
729 721
730An error is signaled if @var{key} is not a string or a vector. 722Emacs signals an error if @var{key} is not a string or a vector.
731 723
732@example 724@example
733@group 725@group
@@ -741,49 +733,52 @@ An error is signaled if @var{key} is not a string or a vector.
741@section Searching the Active Keymaps 733@section Searching the Active Keymaps
742@cindex searching active keymaps for keys 734@cindex searching active keymaps for keys
743 735
744 After translation of event subsequences (@pxref{Translation 736Here is a pseudo-Lisp summary of how Emacs searches the active
745Keymaps}) Emacs looks for them in the active keymaps. Here is a 737keymaps:
746pseudo-Lisp description of the order and conditions for searching
747them:
748 738
749@lisp 739@lisp
750(or (@var{find-in} @var{transient-map}) 740(or (if overriding-terminal-local-map
751 (cond 741 (@var{find-in} overriding-terminal-local-map))
752 (overriding-terminal-local-map 742 (if overriding-local-map
753 (@var{find-in} overriding-terminal-local-map)) 743 (@var{find-in} overriding-local-map)
754 (overriding-local-map 744 (or (@var{find-in} (get-char-property (point) 'keymap))
755 (@var{find-in} overriding-local-map))
756 ((or (@var{find-in} (get-char-property (point) 'keymap))
757 (@var{find-in-any} emulation-mode-map-alists) 745 (@var{find-in-any} emulation-mode-map-alists)
758 (@var{find-in-any} minor-mode-overriding-map-alist) 746 (@var{find-in-any} minor-mode-overriding-map-alist)
759 (@var{find-in-any} minor-mode-map-alist) 747 (@var{find-in-any} minor-mode-map-alist)
760 (if (get-text-property (point) 'local-map) 748 (if (get-text-property (point) 'local-map)
761 (@var{find-in} (get-char-property (point) 'local-map)) 749 (@var{find-in} (get-char-property (point) 'local-map))
762 (@var{find-in} (current-local-map)))))) 750 (@var{find-in} (current-local-map)))))
763 (@var{find-in} (current-global-map))) 751 (@var{find-in} (current-global-map)))
764@end lisp 752@end lisp
765 753
766@noindent 754@noindent
767Here, @var{find-in} and @var{find-in-any} are pseudo functions that 755Here, @var{find-in} and @var{find-in-any} are pseudo functions that
768search in one keymap and in an alist of keymaps, respectively. 756search in one keymap and in an alist of keymaps, respectively. Note
769(Searching a single keymap for a binding is called @dfn{key lookup}; 757that the @code{set-transient-map} function works by setting
770see @ref{Key Lookup}.) @var{transient-map} is a pseudo variable that 758@code{overriding-terminal-local-map} (@pxref{Controlling Active
771represents the effect of a @code{set-transient-map} call 759Maps}).
772(@pxref{Controlling Active Maps}).
773 760
774 In the above pseudo-code, if a key sequence starts with a mouse 761 In the above pseudo-code, if a key sequence starts with a mouse
775event, that event's position is used instead of point and the current 762event (@pxref{Mouse Events}), that event's position is used instead of
776buffer. Mouse events on an embedded string use non-@code{nil} text 763point, and the event's buffer is used instead of the current buffer.
777properties from that string instead of the buffer. 764In particular, this affects how the @code{keymap} and @code{local-map}
778 765properties are looked up. If a mouse event occurs on a string
779 When a match is found (@pxref{Key Lookup}), if the binding in the 766embedded with a @code{display}, @code{before-string}, or
780keymap is a function, the search is over. However if the keymap entry 767@code{after-string} property (@pxref{Special Properties}), and the
781is a symbol with a value or a string, Emacs replaces the input key 768string has a non-@code{nil} @code{keymap} or @code{local-map}
782sequences with the variable's value or the string, and restarts the 769property, that overrides the corresponding property in the underlying
783search of the active keymaps. 770buffer text (i.e., the property specified by the underlying text is
784 771ignored).
785 The function finally found might also be remapped. @xref{Remapping 772
786Commands}. 773 When a key binding is found in one of the active keymaps, and that
774binding is a command, the search is over---the command is executed.
775However, if the binding is a symbol with a value or a string, Emacs
776replaces the input key sequences with the variable's value or the
777string, and restarts the search of the active keymaps. @xref{Key
778Lookup}.
779
780 The command which is finally found might also be remapped.
781@xref{Remapping Commands}.
787 782
788@node Controlling Active Maps 783@node Controlling Active Maps
789@section Controlling the Active Keymaps 784@section Controlling the Active Keymaps
@@ -860,7 +855,6 @@ keymap. @code{use-local-map} returns @code{nil}. Most major mode
860commands use this function. 855commands use this function.
861@end defun 856@end defun
862 857
863@c Emacs 19 feature
864@defvar minor-mode-map-alist 858@defvar minor-mode-map-alist
865@anchor{Definition of minor-mode-map-alist} 859@anchor{Definition of minor-mode-map-alist}
866This variable is an alist describing keymaps that may or may not be 860This variable is an alist describing keymaps that may or may not be
@@ -945,7 +939,7 @@ event is run directly by @code{read-event}. @xref{Special Events}.
945@end defvar 939@end defvar
946 940
947@defvar emulation-mode-map-alists 941@defvar emulation-mode-map-alists
948This variable holds a list of keymap alists to use for emulations 942This variable holds a list of keymap alists to use for emulation
949modes. It is intended for modes or packages using multiple minor-mode 943modes. It is intended for modes or packages using multiple minor-mode
950keymaps. Each element is a keymap alist which has the same format and 944keymaps. Each element is a keymap alist which has the same format and
951meaning as @code{minor-mode-map-alist}, or a symbol with a variable 945meaning as @code{minor-mode-map-alist}, or a symbol with a variable
@@ -970,11 +964,9 @@ function is called with no arguments, prior to running each command,
970while @var{keymap} is active; it should return non-@code{nil} if 964while @var{keymap} is active; it should return non-@code{nil} if
971@var{keymap} should stay active. 965@var{keymap} should stay active.
972 966
973The transient keymap takes precedence over the ``overriding'' maps 967This function works by adding and removing @code{keymap} from the
974(see above); and unlike them, if no match for a key is found in 968variable @code{overriding-terminal-local-map}, which takes precedence
975@var{keymap}, the key lookup process continues. For a pseudo-Lisp 969over all other active keymaps (@pxref{Searching Keymaps}).
976description of exactly how and when this keymap applies,
977@xref{Searching Keymaps}.
978@end defun 970@end defun
979 971
980@node Key Lookup 972@node Key Lookup
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index ddbb5aeaa6b..7b499159d93 100644
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -1289,17 +1289,18 @@ Sets}) supported by @var{coding-system}. Some coding systems that
1289support too many character sets to list them all yield special values: 1289support too many character sets to list them all yield special values:
1290@itemize @bullet 1290@itemize @bullet
1291@item 1291@item
1292If @var{coding-system} supports all the ISO-2022 charsets, the value
1293is @code{iso-2022}.
1294@item
1295If @var{coding-system} supports all Emacs characters, the value is 1292If @var{coding-system} supports all Emacs characters, the value is
1296@code{(emacs)}. 1293@code{(emacs)}.
1297@item 1294@item
1298If @var{coding-system} supports all emacs-mule characters, the value
1299is @code{emacs-mule}.
1300@item
1301If @var{coding-system} supports all Unicode characters, the value is 1295If @var{coding-system} supports all Unicode characters, the value is
1302@code{(unicode)}. 1296@code{(unicode)}.
1297@item
1298If @var{coding-system} supports all ISO-2022 charsets, the value is
1299@code{iso-2022}.
1300@item
1301If @var{coding-system} supports all the characters in the internal
1302coding system used by Emacs version 21 (prior to the implementation of
1303internal Unicode support), the value is @code{emacs-mule}.
1303@end itemize 1304@end itemize
1304@end defun 1305@end defun
1305 1306
@@ -1617,8 +1618,7 @@ of the right way to use the variable:
1617 1618
1618@example 1619@example
1619;; @r{Read the file with no character code conversion.} 1620;; @r{Read the file with no character code conversion.}
1620;; @r{Assume @acronym{crlf} represents end-of-line.} 1621(let ((coding-system-for-read 'no-conversion))
1621(let ((coding-system-for-read 'emacs-mule-dos))
1622 (insert-file-contents filename)) 1622 (insert-file-contents filename))
1623@end example 1623@end example
1624 1624
diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi
index 26d81f738fc..159938eedf3 100644
--- a/doc/lispref/tips.texi
+++ b/doc/lispref/tips.texi
@@ -223,18 +223,13 @@ only for special-purpose buffers.) People will find Emacs more
223coherent if all libraries use the same conventions. 223coherent if all libraries use the same conventions.
224 224
225@item 225@item
226If your program contains non-ASCII characters in string or character 226The default file coding system for Emacs Lisp source files is UTF-8
227constants, you should make sure Emacs always decodes these characters 227(@pxref{Text Representations}). In the rare event that your program
228the same way, regardless of the user's settings. The easiest way to 228contains characters which are @emph{not} in UTF-8, you should specify
229do this is to use the coding system @code{utf-8-emacs} (@pxref{Coding 229an appropriate coding system in the source file's @samp{-*-} line or
230System Basics}), and specify that coding in the @samp{-*-} line or the
231local variables list. @xref{File Variables, , Local Variables in 230local variables list. @xref{File Variables, , Local Variables in
232Files, emacs, The GNU Emacs Manual}. 231Files, emacs, The GNU Emacs Manual}.
233 232
234@example
235;; XXX.el -*- coding: utf-8-emacs; -*-
236@end example
237
238@item 233@item
239Indent the file using the default indentation parameters. 234Indent the file using the default indentation parameters.
240 235
diff --git a/etc/NEWS b/etc/NEWS
index 00a72f03e0d..de461aa2bf7 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -545,7 +545,7 @@ using the next face automatically.
545*** New option `imenu-generic-skip-comments-and-strings'. 545*** New option `imenu-generic-skip-comments-and-strings'.
546 546
547** Info 547** Info
548 548---
549*** New face `info-index-match' is used to highlight matches in index 549*** New face `info-index-match' is used to highlight matches in index
550entries displayed by `Info-index-next', `Info-virtual-index' and 550entries displayed by `Info-index-next', `Info-virtual-index' and
551`info-apropos'. 551`info-apropos'.
@@ -849,19 +849,23 @@ low-level libraries gfilenotify.c, inotify.c or w32notify.c.
849 849
850* Incompatible Lisp Changes in Emacs 24.4 850* Incompatible Lisp Changes in Emacs 24.4
851 851
852---
852** `kill-region' lost its `yank-handler' optional argument. 853** `kill-region' lost its `yank-handler' optional argument.
853 854
855+++
854** `(input-pending-p)' no longer runs other timers which are ready to 856** `(input-pending-p)' no longer runs other timers which are ready to
855run. The new optional CHECK-TIMERS param allows for the prior behavior. 857run. The new optional CHECK-TIMERS param allows for the prior behavior.
856 858
857** `defvar' and `defcustom' in a let-binding affect the "external" default. 859** `defvar' and `defcustom' in a let-binding affect the "external" default.
858 860
861---
859** The syntax of ?» and ?« is now punctuation instead of matched parens. 862** The syntax of ?» and ?« is now punctuation instead of matched parens.
860Some languages match those as »...« and others as «...» so better stay neutral. 863Some languages match those as »...« and others as «...» so better stay neutral.
861 864
862--- 865---
863** In compiled Lisp files, the header no longer includes a timestamp. 866** In compiled Lisp files, the header no longer includes a timestamp.
864 867
868+++
865** The default file coding for Emacs Lisp files is now utf-8. 869** The default file coding for Emacs Lisp files is now utf-8.
866(See `file-coding-system-alist'.) In most cases, this change is 870(See `file-coding-system-alist'.) In most cases, this change is
867transparent, but files that contain unusual characters without 871transparent, but files that contain unusual characters without
@@ -869,6 +873,7 @@ specifying an explicit coding system may fail to load with obscure
869errors. You should either convert them to utf-8 or add an explicit 873errors. You should either convert them to utf-8 or add an explicit
870`coding:' cookie. 874`coding:' cookie.
871 875
876+++
872** `overriding-terminal-local-map' no longer replaces the local keymaps. 877** `overriding-terminal-local-map' no longer replaces the local keymaps.
873It used to disable the minor mode, major mode, and text-property keymaps, 878It used to disable the minor mode, major mode, and text-property keymaps,
874whereas now it simply has higher precedence. 879whereas now it simply has higher precedence.
@@ -881,9 +886,11 @@ Just as was the case in Emacs-22 and before, decoding of tty input according to
881keyboard-coding-system is not performed in read-event any more. But contrary 886keyboard-coding-system is not performed in read-event any more. But contrary
882to that past, it is still done before input-decode-map/function-key-map/... 887to that past, it is still done before input-decode-map/function-key-map/...
883 888
884** Removed inhibit-local-menu-bar-menus. 889---
890** Removed `inhibit-local-menu-bar-menus'.
885 891
886** frame-local variables that affect redisplay do not work any more. 892---
893** Frame-local variables that affect redisplay do not work any more.
887More specifically, the redisplay does not bother to check for a frame-local 894More specifically, the redisplay does not bother to check for a frame-local
888value when looking up variables. 895value when looking up variables.
889 896
diff --git a/src/ChangeLog b/src/ChangeLog
index 1de6122edd0..a883182754d 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,10 @@
12013-12-25 Chong Yidong <cyd@gnu.org>
2
3 * keyboard.c (Voverriding_terminal_local_map):
4 (Voverriding_local_map): Doc fix.
5
6 * keymap.c (Vemulation_mode_map_alists): Doc fix.
7
12013-12-24 Eli Zaretskii <eliz@gnu.org> 82013-12-24 Eli Zaretskii <eliz@gnu.org>
2 9
3 * w32fns.c (Fw32_shell_execute): Ensure DOCUMENT is an absolute 10 * w32fns.c (Fw32_shell_execute): Ensure DOCUMENT is an absolute
diff --git a/src/keyboard.c b/src/keyboard.c
index 915ce9dcf23..8ccbf77871c 100644
--- a/src/keyboard.c
+++ b/src/keyboard.c
@@ -11415,18 +11415,19 @@ tool-bar separators natively. Otherwise it is unused (e.g. on GTK). */);
11415 DEFVAR_KBOARD ("overriding-terminal-local-map", 11415 DEFVAR_KBOARD ("overriding-terminal-local-map",
11416 Voverriding_terminal_local_map, 11416 Voverriding_terminal_local_map,
11417 doc: /* Per-terminal keymap that takes precedence over all other keymaps. 11417 doc: /* Per-terminal keymap that takes precedence over all other keymaps.
11418
11419This variable is intended to let commands such as `universal-argument' 11418This variable is intended to let commands such as `universal-argument'
11420set up a different keymap for reading the next command. 11419set up a different keymap for reading the next command.
11421 11420
11422`overriding-terminal-local-map' has a separate binding for each 11421`overriding-terminal-local-map' has a separate binding for each
11423terminal device. 11422terminal device. See Info node `(elisp)Multiple Terminals'. */);
11424See Info node `(elisp)Multiple Terminals'. */);
11425 11423
11426 DEFVAR_LISP ("overriding-local-map", Voverriding_local_map, 11424 DEFVAR_LISP ("overriding-local-map", Voverriding_local_map,
11427 doc: /* Keymap that overrides almost all other local keymaps. 11425 doc: /* Keymap that replaces (overrides) local keymaps.
11428If this variable is non-nil, it is used as a keymap--replacing the 11426If this variable is non-nil, Emacs looks up key bindings in this
11429buffer's local map, the minor mode keymaps, and char property keymaps. */); 11427keymap INSTEAD OF the keymap char property, minor mode maps, and the
11428buffer's local map. Hence, the only active keymaps would be
11429`overriding-terminal-local-map', this keymap, and `global-keymap', in
11430order of precedence. */);
11430 Voverriding_local_map = Qnil; 11431 Voverriding_local_map = Qnil;
11431 11432
11432 DEFVAR_LISP ("overriding-local-map-menu-flag", Voverriding_local_map_menu_flag, 11433 DEFVAR_LISP ("overriding-local-map-menu-flag", Voverriding_local_map_menu_flag,
diff --git a/src/keymap.c b/src/keymap.c
index 562787ee8a5..9ef5a0b294f 100644
--- a/src/keymap.c
+++ b/src/keymap.c
@@ -3753,7 +3753,7 @@ it is provided for major modes to bind locally. */);
3753 Vminor_mode_overriding_map_alist = Qnil; 3753 Vminor_mode_overriding_map_alist = Qnil;
3754 3754
3755 DEFVAR_LISP ("emulation-mode-map-alists", Vemulation_mode_map_alists, 3755 DEFVAR_LISP ("emulation-mode-map-alists", Vemulation_mode_map_alists,
3756 doc: /* List of keymap alists to use for emulations modes. 3756 doc: /* List of keymap alists to use for emulation modes.
3757It is intended for modes or packages using multiple minor-mode keymaps. 3757It is intended for modes or packages using multiple minor-mode keymaps.
3758Each element is a keymap alist just like `minor-mode-map-alist', or a 3758Each element is a keymap alist just like `minor-mode-map-alist', or a
3759symbol with a variable binding which is a keymap alist, and it is used 3759symbol with a variable binding which is a keymap alist, and it is used