[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
feature/completions-highlight-modifications ba2650f 2/6: Document the ch
From: |
Jimmy Aguilar Mena |
Subject: |
feature/completions-highlight-modifications ba2650f 2/6: Document the changes in the API for Completions. |
Date: |
Sun, 13 Sep 2020 09:45:43 -0400 (EDT) |
branch: feature/completions-highlight-modifications
commit ba2650fd943e14d5a0d27573d47990f892313e35
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 d30114f..935af9d 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -2598,6 +2598,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 2fe66be..36619b7 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -980,6 +980,18 @@ 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
+++
- branch feature/completions-highlight-modifications created (now d8e6b9b), Jimmy Aguilar Mena, 2020/09/13
- feature/completions-highlight-modifications ba2650f 2/6: Document the changes in the API for Completions.,
Jimmy Aguilar Mena <=
- feature/completions-highlight-modifications 775a655 5/6: Improve keymap handling., Jimmy Aguilar Mena, 2020/09/13
- feature/completions-highlight-modifications 54c5650 1/6: Insert some modifications to implement completions highlighting., Jimmy Aguilar Mena, 2020/09/13
- feature/completions-highlight-modifications 1654b5d 4/6: Fix initial comment in completions-highlight file., Jimmy Aguilar Mena, 2020/09/13
- feature/completions-highlight-modifications df2bd61 3/6: Add completions-highlight-mode initial implementation., Jimmy Aguilar Mena, 2020/09/13
- feature/completions-highlight-modifications d8e6b9b 6/6: Fix recursive set-keymap-parent in completions-highlight., Jimmy Aguilar Mena, 2020/09/13