master a1954288de: Document completions-sort

[Lars Ingebrigtsen]

branch: master
commit a1954288de9dc9f88f8b77a4a7c3685b5ebc96b6
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Document completions-sort
    
    * doc/emacs/mini.texi (Completion Options): Document completions-sort.
---
 doc/emacs/mini.texi | 6 ++++++
 etc/NEWS            | 1 +
 2 files changed, 7 insertions(+)

diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi
index 52856d7137..6012d2f280 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 45d88a5cb1..4b8b3d4d6f 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,