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 a8b4d5619d393acf32c22e144cc6dffa637144cd..22cab79ba1e3b3fa5f95bbe8902c0ee3c6386783 100644 (file)
--- 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 b6a3434d15e3f60554aeea797a7f36979b813b13..0cca30adf0da83dfbf265d7a4cfe2bcc2a110035 100644 (file)
--- 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 efec67432370097120ba41ed513d36ab583694b3..18552db19c8b30eeabca33f5ae892922a8e23b12 100644 (file)
--- 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
 
 ---