; Document 'completions-sort' value 'historical' in the manual

diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi
index 49983a411cfd1226771245a6bca2a545aee92862..f51682e86f60ef9eb8dbff769557dc085ce41c2e 100644 (file)
--- a/doc/emacs/mini.texi
+++ b/doc/emacs/mini.texi
@@ -825,9 +825,12 @@ will use just one column.
   The @code{completions-sort} user option controls the order in which
 the completions are sorted in the @samp{*Completions*} buffer.  The
 default is @code{alphabetical}, which sorts in alphabetical order.
-The value @code{nil} disables sorting.  The value can also be a
-function, which will be called with the list of completions, and
-should return the list in the desired order.
+The value @code{historical} sorts completion candidates according to
+their position in the minibuffer history, so candidates that you used
+recently appear first in the completions list.  The value @code{nil}
+disables sorting altogether.  The value can also be a function, which
+will be called with the list of completions, and should return the
+list in the desired order.
 
 @vindex completions-max-height
   When @code{completions-max-height} is non-@code{nil}, it limits the

diff --git a/etc/NEWS b/etc/NEWS
index afc59520dd4015325ffa351fb89e26437904562f..c67628caa0e8cd2dabf3ecd803d2af0cf6ce23c9 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -711,11 +711,13 @@ the minibuffer contents instead.  This deselection behavior can be
 controlled with the new user option 'completion-auto-deselect', which
 is t by default.
 
++++
 *** New value 'historical' for user option 'completions-sort'.
 When 'completions-sort' is set to 'historical', completion candidates
 will be first sorted alphabetically, and then re-sorted by their order
 in the minibuffer history, with more recent candidates appearing first.
 
++++
 *** New commands for narrowing (restricting) minibuffer completions list.
 You can now use 'C-x n n' ('minibuffer-narrow-completions-to-current')
 in the minibuffer to restrict the list of possible completions to only