emacs-30 c5eba443ae7: ; * lisp/icomplete.el (icomplete-in-buffer): Doc fix (bug#73820).

[Eli Zaretskii]

branch: emacs-30
commit c5eba443ae72b94024574d56a0dfdf11f339c1aa
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; * lisp/icomplete.el (icomplete-in-buffer): Doc fix (bug#73820).
---
 lisp/icomplete.el | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/lisp/icomplete.el b/lisp/icomplete.el
index 2ea5e36fa88..f3569789e64 100644
--- a/lisp/icomplete.el
+++ b/lisp/icomplete.el
@@ -139,9 +139,17 @@ See `icomplete-delay-completions-threshold'."
   :type 'integer)
 
 (defcustom icomplete-in-buffer nil
-  "If non-nil, also use Icomplete when completing in non-mini buffers.
+  "If non-nil, use Icomplete when completing in buffers other than minibuffer.
 This affects commands like `completion-in-region', but not commands
-that use their own completions setup."
+that use their own completions setup.
+
+If you would prefer to see only Icomplete's in-buffer display, but do
+not want the \"*Completions*\" buffer to pop up in those cases, add
+this advice to your init file:
+
+  (advice-add \\='completion-at-point
+              :after #\\='minibuffer-hide-completions)
+"
   :type 'boolean)
 
 (defcustom icomplete-minibuffer-setup-hook nil