From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 16 Apr 2022 15:20:04 +0000 (+0200)
Subject: Document completions-sort
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1^2~5^2~16^2~2370^2~516
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=a1954288de9dc9f88f8b77a4a7c3685b5ebc96b6;p=emacs.git

Document completions-sort

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

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,