Document completions-sort

* doc/emacs/mini.texi (Completion Options): Document completions-sort.

2 files changed, 7 insertions, 0 deletions

diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi
index 52856d71379..6012d2f280a 100644
--- a/doc/emacs/mini.texi
+++ b/doc/emacs/mini.texi
@@ -690,6 +690,12 @@ changed by changing the @code{completions-format} user option.  If
 @code{vertical}, sort the completions vertically in columns instead,
 and if @code{one-column}, just use a single column.
 
+@vindex completions-sort
+  This user option controls how completions are sorted in the
+@samp{*Completions*} buffer.  The default is @code{alphabetical}, but
+it 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
 size of the completions window.  It is specified in lines and include
diff --git a/etc/NEWS b/etc/NEWS
index 45d88a5cb1e..4b8b3d4d6ff 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -659,6 +659,7 @@ When non-nil, the commands 'next-completion' and 'previous-completion'
 automatically wrap around on reaching the beginning or the end of
 the "*Completions*" buffer.
 
++++
 *** New user option 'completions-sort'.
 This option controls the sorting of the completion candidates in
 the "*Completions*" buffer.  Available styles are no sorting,