From: Juri Linkov Date: Wed, 25 Sep 2024 17:14:12 +0000 (+0300) Subject: * lisp/imenu.el (imenu-flatten): More limitations in docstring (bug#73117) X-Git-Tag: archive/raspbian/1%30.1+1-3+rpi1^2~2^2~20^2~365 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=759b18a33c0a18550b0c5ec341dc76f1f0bc16c7;p=emacs.git * lisp/imenu.el (imenu-flatten): More limitations in docstring (bug#73117) --- 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