From: Jimmy Aguilar Mena 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 ---