emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

feature/completions-highlight-modifications d81c540 2/6: Document the ch


From: Jimmy Aguilar Mena
Subject: feature/completions-highlight-modifications d81c540 2/6: Document the changes in the API for Completions.
Date: Sat, 14 Nov 2020 21:33:02 -0500 (EST)

branch: feature/completions-highlight-modifications
commit d81c5405254fdda1cdaea785bfcd1c955bb59c12
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                 | 12 ++++++++++++
 3 files changed, 28 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 b6a3434..47382da 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -2617,6 +2617,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 f21c4cb..a2fbfb1 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1287,6 +1287,18 @@ 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'.
+
+---
+*** New hook 'minibuffer-hide-completions-hook'
+New hook executed when hiding the *Completions* buffer.
+
 ** Miscellaneous
 
 +++



reply via email to

[Prev in Thread] Current Thread [Next in Thread]