From 759b18a33c0a18550b0c5ec341dc76f1f0bc16c7 Mon Sep 17 00:00:00 2001 From: Juri Linkov Date: Wed, 25 Sep 2024 20:14:12 +0300 Subject: [PATCH] * lisp/imenu.el (imenu-flatten): More limitations in docstring (bug#73117) --- lisp/imenu.el | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/lisp/imenu.el b/lisp/imenu.el index 8f1b1f22a67..2d64970bfcf 100644 --- a/lisp/imenu.el +++ b/lisp/imenu.el @@ -158,10 +158,18 @@ If the value is `annotation', annotate each completion candidate with a suffix that is the section name to which it belongs. If the value is `group', split completion candidates into groups according to the sections. +Any other value is treated as `prefix'. + Since the values `annotation' and `group' rely on text properties, you can use them only by selecting candidates from the completions -buffer, not by typing in the minibuffer. -Any other value is treated as `prefix'. +buffer, not by typing in the minibuffer. This also means that +if you use `minibuffer-next-completion' (`M-') to select +a completion while point stays in the minibuffer, you need +to customize `minibuffer-completion-auto-choose' to nil that +doesn't insert completion candidates to the minibuffer. +Also note that for using the value `group' you need to customize +`completions-group' to the value t, and `completions-format' +to the value `vertical'. The value of `imenu-level-separator', a string, is used to separate names from different flattened levels, such as section names, from the -- 2.30.2