emacs-31 e1f465d9935: * doc/misc/efaq.texi (New in Emacs 31): New node.

branch: emacs-31
commit e1f465d9935c1b4c57a71a7550518fb6aa571f97
Author: Sean Whitton <[email protected]>
Commit: Sean Whitton <[email protected]>

    * doc/misc/efaq.texi (New in Emacs 31): New node.
---
 doc/misc/efaq.texi | 87 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 etc/NEWS           | 12 ++++----
 2 files changed, 94 insertions(+), 5 deletions(-)

diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index c65b5ee5593..a8d27426b25 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -848,6 +848,7 @@ in the Emacs development repository (@pxref{Latest version of Emacs}).
 @menu
 * Origin of the term Emacs::
 * Latest version of Emacs::
+* New in Emacs 31::
 * New in Emacs 30::
 * New in Emacs 29::
 * New in Emacs 28::
@@ -923,6 +924,92 @@ this command a prefix argument to read about which features were new
 in older versions.
 
 
+@node New in Emacs 31
+@section What is different about Emacs 31?
+@cindex Differences between Emacs 30 and Emacs 31
+@cindex Emacs 31, new features in
+
+Here's a selection of changes in Emacs 31 as compared to Emacs 30.  The
+full list is too long to fit here, but can be read in the Emacs
+@file{NEWS} file by typing @kbd{C-h n} inside Emacs.
+
+@itemize
+@item
+Using the mouse to control Emacs is enabled by default in most
+terminals.
+
+@item
+New @file{user-lisp/} subdirectory of your Emacs configuration
+directory.  Lisp files placed here will be automatically compiled and
+loaded without additional configuration.
+
+@item
+Child frames (used e.g. for completion and tooltips) are now supported
+on text frames.
+
+@item
+Various improvements to the way the @file{*Completions*} buffer works.
+In particular, it can be configured to be displayed immediately and to
+be updated dynamically as you type.
+
+@item
+Commands to split windows now make better choices between splitting
+vertically and splitting horizontally.  Whether the frame is landscape
+or portrait now has more of an influence.
+
+@item
+New built-in facility to hide minor mode lighters:
+@code{mode-line-collapse-minor-modes}.
+
+@item
+New commands to interactively store buffers and files in registers:
+@code{buffer-to-register} and @code{file-to-register}.
+
+@item
+You can now bookmark local and remote shell buffers.
+
+@item
+SHR slices large images into rows, so scrolling no longer jumps past the
+entire image.
+
+@item
+Ispell can now save spelling corrections as abbrevs, such that if you
+make the same mistake again it will be immediately corrected.
+
+@item
+Typing @kbd{d} during @code{query-replace} shows a diff buffer with the
+replacements.
+
+@item
+The @file{*grep*} and @file{*xref*} now support editable modes, like
+Occur Edit mode.  The edits will be reflected in buffers visiting the
+originating files.
+
+@item
+New VC commands to handle repositories with multiple working trees.  The
+VC Directory and Log View mode interfaces have seen a number of
+usability improvements.
+
+@item
+New feature to review changes to packages before installing or upgrading
+them, and new minor mode to automatically suggest packages to install
+when visiting files with no specific major mode yet available.
+
+@item
+The Speedbar can be configured to open in a window instead of a frame.
+
+@item
+New theme, the Newcomers Presets theme, designed to make Emacs more
+approachable for new users.  It is basically a set of alternative
+defaults.
+
+@item
+New library to handle iCalendar (RFC 5545) data, with integrations for
+the Calendar and Diary packages.
+
+@end itemize
+
+
 @node New in Emacs 30
 @section What is different about Emacs 30?
 @cindex Differences between Emacs 29 and Emacs 30
diff --git a/etc/NEWS b/etc/NEWS
index 5f3faf2204d..1198fb3ca67 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -548,7 +548,8 @@ visuals for these two faces, customize them to have the colors "grey75"
 and "grey40", respectively, regardless of the background mode.
 
 *** New user option 'mode-line-collapse-minor-modes'.
-If non-nil, minor mode lighters on the mode line are collapsed into a
+This is a new, built-in facility to hide minor mode lighters.  If
+non-nil, minor mode lighters on the mode line are collapsed into a
 single button.  The value can also be a list to specify minor mode
 lighters to hide or show.  The default value is nil, which retains the
 previous behavior of showing all minor mode lighters.
@@ -2351,7 +2352,7 @@ outputting it in the Dired buffer and signalling an error.
 
 *** Grep results can be edited to reflect changes in the originating file.
 Like Occur Edit mode, typing 'e' in the "*grep*" buffer will now make
-the 'grep' results editable.  The edits will be reflected in the buffers
+the 'grep' results editable.  The edits will be reflected in buffers
 visiting the originating files.  Typing 'C-c C-c' will leave the Grep
 Edit mode.
 
@@ -3480,9 +3481,10 @@ file names in those buffers.  The default is nil.
 *** New theme 'newcomers-presets'.
 This new theme configures user options and minor modes that might
 interest new users, but would otherwise be too invasive to enable by
-default.  (An Emacs theme is a generic collection of settings, and need
-not affect Emacs's appearance.)  See the Info node "(emacs) Newcomers
-Theme" for more information.
+default.  It is basically a set of alternative defaults.  (An Emacs
+theme is a generic collection of settings, and need not affect Emacs's
+appearance.)  See the Info node "(emacs) Newcomers Theme" for more
+information.
 
 *** 'report-emacs-bug' now checks whether the bug report is about Org.
 The command 'report-emacs-bug' looks in the report text for symbols that