* lisp/imenu.el (imenu-flatten): More limitations in docstring (bug#73117)

diff --git a/lisp/imenu.el b/lisp/imenu.el
index 8f1b1f22a67a2f4d87060016430cfd7ab1b0a13e..2d64970bfcfaa1fcea28a0baec318f9c1e325177 100644 (file)
--- 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-<down>') 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