Mercurial > emacs

--- a/doc/lispref/ChangeLog	Fri Dec 17 22:45:16 2010 +0000
+++ b/doc/lispref/ChangeLog	Sat Dec 18 11:28:15 2010 -0500
@@ -1,3 +1,10 @@
+2010-12-18  Stefan Monnier  <monnier@iro.umontreal.ca>
+
+	* modes.texi (Derived Modes): Mention prog-mode.
+
+	* keymaps.texi (Simple Menu Items, Extended Menu Items): Remove mention
+	of the key-binding-data cache since we don't use it any more.
+
 2010-12-13  Eli Zaretskii  <eliz@gnu.org>

 	* processes.texi (Shell Arguments):
--- a/doc/lispref/keymaps.texi	Fri Dec 17 22:45:16 2010 +0000
+++ b/doc/lispref/keymaps.texi	Sat Dec 18 11:28:15 2010 -0500
@@ -2072,21 +2072,6 @@
 of menus in advance.  To force recalculation of the menu bar, call
 @code{force-mode-line-update} (@pxref{Mode Line Format}).

-  You've probably noticed that menu items show the equivalent keyboard key
-sequence (if any) to invoke the same command.  To save time on
-recalculation, menu display caches this information in a sublist in the
-binding, like this:
-
-@c This line is not too long--rms.
-@example
-(@var{item-string} @r{[}@var{help}@r{]} (@var{key-binding-data}) . @var{real-binding})
-@end example
-
-@noindent
-Don't put these sublists in the menu item yourself; menu display
-calculates them automatically.  Don't mention keyboard equivalents in
-the item strings themselves, since that is redundant.
-
 @node Extended Menu Items
 @subsubsection Extended Menu Items
 @kindex menu-item
@@ -2119,14 +2104,6 @@
 @var{item-property-list}, has the form of a property list which contains
 other information.

-  When an equivalent keyboard key binding is cached, the extended menu
-item binding looks like this:
-
-@example
-(menu-item @var{item-name} @var{real-binding} (@var{key-binding-data})
-    . @var{item-property-list})
-@end example
-
   Here is a table of the properties that are supported:

 @table @code
--- a/doc/lispref/modes.texi	Fri Dec 17 22:45:16 2010 +0000
+++ b/doc/lispref/modes.texi	Sat Dec 18 11:28:15 2010 -0500
@@ -744,7 +744,8 @@
   The recommended way to define a new major mode is to derive it
 from an existing one using @code{define-derived-mode}.  If there is no
 closely related mode, you can inherit from @code{text-mode},
-@code{special-mode}, or in the worst case @code{fundamental-mode}.
+@code{special-mode}, @code{prog-mode}, or in the worst case
+@code{fundamental-mode}.

 @defmac define-derived-mode variant parent name docstring keyword-args@dots{} body@dots{}
 This macro defines @var{variant} as a major mode command, using