From a1954288de9dc9f88f8b77a4a7c3685b5ebc96b6 Mon Sep 17 00:00:00 2001 From: Lars Ingebrigtsen Date: Sat, 16 Apr 2022 17:20:04 +0200 Subject: [PATCH] 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 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, -- 2.30.2