From 17dcc54db4e2c7382eb35a27f880b3936fbaa192 Mon Sep 17 00:00:00 2001 From: Lars Ingebrigtsen Date: Tue, 15 Jun 2021 15:46:33 +0200 Subject: [PATCH] Document `completions-format' * doc/emacs/mini.texi (Completion Options): Document `completions-format'. * lisp/simple.el (completion-list-mode): Mention in (bug#49003). --- doc/emacs/mini.texi | 8 ++++++++ lisp/simple.el | 3 +++ 2 files changed, 11 insertions(+) diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi index 2fdb1e7072f..6dcee3fa824 100644 --- a/doc/emacs/mini.texi +++ b/doc/emacs/mini.texi @@ -630,6 +630,14 @@ in a cyclic manner. If you give @code{completion-cycle-threshold} a numeric value @var{n}, completion commands switch to this cycling behavior only when there are @var{n} or fewer alternatives. +@vindex completions-format + When displaying completions, Emacs will normally pop up a new buffer +to display the completions. The completions will (by default) be +sorted in columns horizontally in alphabetical order, but this can be +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. + @node Minibuffer History @section Minibuffer History @cindex minibuffer history diff --git a/lisp/simple.el b/lisp/simple.el index 4630a11c753..fdaeb6ac22d 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -9086,6 +9086,9 @@ Type \\\\[choose-completion] in the completion list\ to select the completion near point. Or click to select one with the mouse. +See the `completions-format' user option to control how this +buffer is formatted. + \\{completion-list-mode-map}") (defun completion-list-mode-finish () -- 2.39.5