feature/completions-highlight-modifications f132cc3 02/18: Document the changes in the API for Completions.

[Jimmy Aguilar Mena]

branch: feature/completions-highlight-modifications
commit f132cc33b310e74f4029d19684b4e4efc5c06e9a
Author: Jimmy Aguilar Mena <spacibba@aol.com>
Commit: Jimmy Aguilar Mena <spacibba@aol.com>

    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.
---
 doc/lispref/hooks.texi   | 3 +++
 doc/lispref/minibuf.texi | 6 ++++++
 etc/NEWS                 | 8 ++++++++
 3 files changed, 17 insertions(+)

diff --git a/doc/lispref/hooks.texi b/doc/lispref/hooks.texi
index a8b4d56..22cab79 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 b6a3434..0cca30a 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 9f39851..41e0a65 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1307,6 +1307,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
 
 ---