feature/completions-highlight-modifications 0a04c93 2/5: Document the changes in the API for Completions.

[Jimmy Aguilar Mena]

branch: feature/completions-highlight-modifications
commit 0a04c936abf11ab2814e551628cc94028dd9ec93
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   |  4 ++++
 doc/lispref/minibuf.texi | 12 ++++++++++++
 etc/NEWS                 | 11 +++++++++++
 3 files changed, 27 insertions(+)

diff --git a/doc/lispref/hooks.texi b/doc/lispref/hooks.texi
index a8b4d56..6d1376e 100644
--- a/doc/lispref/hooks.texi
+++ b/doc/lispref/hooks.texi
@@ -182,6 +182,10 @@ The command loop runs this soon after 
@code{post-command-hook} (q.v.).
 @itemx minibuffer-exit-hook
 @xref{Minibuffer Misc}.
 
+@item completion-setup-hook
+@itemx minibuffer-hide-completions-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 8b4240c..fa81f5e 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -2593,6 +2593,18 @@ 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-hide-completions-hook
+This is a normal hook that is run whenever the Completions buffer is
+hidden.
+@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 14a75ca..3b1598a 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -888,6 +888,17 @@ based on the current window size.  In previous versions of 
Emacs, this
 was always done (and that could lead to odd displays when resizing the
 window after starting).  This variable defaults to nil.
 
+** 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'.
+
+---
+*** New hook 'minibuffer-hide-completions-hook'
+New hook executed when hiding the *Completions* buffer.
 
 ** Miscellaneous