master 5f80541fbc4 2/2: Document icomplete-in-buffer incompatible changes

[Sean Whitton]

branch: master
commit 5f80541fbc46a7854da00b0f8e67c0daa89d454a
Author: Sean Whitton <spwhitton@spwhitton.name>
Commit: Sean Whitton <spwhitton@spwhitton.name>

    Document icomplete-in-buffer incompatible changes
    
    * etc/NEWS: Document icomplete-in-buffer incompatible
    changes (bug#67661).
---
 etc/NEWS | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/etc/NEWS b/etc/NEWS
index a174cf52d50..ba40efa2e9d 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -80,6 +80,27 @@ removed, as it was considered more dangerous than useful.  
RFC 9110
 To send an email address in the header of individual HTTP requests,
 see the variable 'url-request-extra-headers'.
 
++++
+** 'completion-auto-help' now affects 'icomplete-in-buffer'.
+Previously, completion-auto-help mostly affected only minibuffer
+completion.  Now, if 'completion-auto-help' has the value 'lazy', then
+Icomplete's in-buffer display of possible completions will only appear
+after the 'completion-at-point' command has been invoked twice, and if
+'completion-auto-help' is nil, then Icomplete's in-buffer display is
+completely suppressed.  Thus, if you use 'icomplete-in-buffer', ensure
+'completion-auto-help' is not customized to 'lazy' or nil.
+
++++
+** The *Completions* buffer now always accompanies 'icomplete-in-buffer'.
+Previously, it was not consistent when the *Completions* buffer would
+appear when using 'icomplete-in-buffer'.  Now the *Completions* buffer
+and Icomplete's in-buffer display of possible completions always
+appear together.  If you would prefer to see only Icomplete's
+in-buffer display, and not the *Completions* buffer, you can add this
+to your init:
+
+    (advice-add 'completion-at-point :after #'minibuffer-hide-completions)
+
 
 * Changes in Emacs 30.1