From: Jimmy Aguilar Mena <spacibba@aol.com>
Date: Wed, 26 Aug 2020 05:39:03 +0000 (+0200)
Subject: Document the changes in the API for Completions.
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5509afa6e95a30901fc4d7b71576a2daaa46276b;p=emacs.git

Document the changes in the API for Completions.

* doc/lispref/hooks.texi : Document completion-setup-hook and
minibuffer-hide-completions-hook.
* doc/lispref/minibuf.texi : Add entries for the hooks.
* etc/NEWS : Briefly comment the modifications and the API.
---

diff --git a/doc/lispref/hooks.texi b/doc/lispref/hooks.texi
index a8b4d5619d3..22cab79ba1e 100644
--- a/doc/lispref/hooks.texi
+++ b/doc/lispref/hooks.texi
@@ -182,6 +182,9 @@ The command loop runs this soon after @code{post-command-hook} (q.v.).
 @itemx minibuffer-exit-hook
 @xref{Minibuffer Misc}.
 
+@item completion-setup-hook
+@xref{Minibuffer Misc}.
+
 @item mouse-leave-buffer-hook
 @vindex mouse-leave-buffer-hook
 Hook run when about to switch windows with a mouse command.
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index b6a3434d15e..0cca30adf0d 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -2617,6 +2617,12 @@ This is a normal hook that is run whenever the minibuffer is exited.
 @xref{Hooks}.
 @end defvar
 
+@defvar completion-setup-hook
+This is a normal hook that is run every time the Completions buffer is
+shown or created.
+@xref{Hooks}.
+@end defvar
+
 @defvar minibuffer-help-form
 @anchor{Definition of minibuffer-help-form}
 The current value of this variable is used to rebind @code{help-form}
diff --git a/etc/NEWS b/etc/NEWS
index efec6743237..18552db19c8 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1317,6 +1317,14 @@ This face is used for error messages from 'diff'.
 *** New command 'diff-refresh-hunk'.
 This new command (bound to 'C-c C-l') regenerates the current hunk.
 
+** Completions
+
+---
+*** New option 'minibuffer-tab-through-completions-function'
+This contains the function to call when completions are shown and
+the *Completions* is already visible already.  The variable contains
+the default value 'minibuffer-tab-through-completions-default'.
+
 ** Miscellaneous
 
 ---