* bug#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual
@ 2015-10-21 18:48 Aaron Ecay
2015-10-21 18:57 ` Eli Zaretskii
0 siblings, 1 reply; 5+ messages in thread
From: Aaron Ecay @ 2015-10-21 18:48 UTC (permalink / raw
To: 21728
[-- Attachment #1: Type: text/plain, Size: 261 bytes --]
The emacs lisp reference doesn’t mention focus-in-hook and its -out-
variant, except in a list of hooks. Yet it contains some discussion of
focus events. To make it clear that the hooks exist, I’ve added a
reference to them in the attached patch.
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-doc-lispref-commands.texi-Focus-Events-Mention-focus.patch --]
[-- Type: text/x-diff, Size: 894 bytes --]
From f89a1bc9d70170f77c85ca447b8a8c3efa6f1ccd Mon Sep 17 00:00:00 2001
From: Aaron Ecay <aaronecay@gmail.com>
Date: Wed, 21 Oct 2015 19:38:23 +0100
Subject: [PATCH] doc/lispref/commands.texi (Focus Events): Mention
`focus-{in,out}-hook'.
* doc/lispref/commands.texi (Focus Events): Mention `focus-{in,out}-hook'.
---
doc/lispref/commands.texi | 3 +++
1 file changed, 3 insertions(+)
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 7ddf5ee..1aee2b5 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -1682,6 +1682,9 @@ Focus Events
so that the focus event comes either before or after the multi-event key
sequence, and not within it.
+Another facility that Emacs provides for running lisp code on focus
+changes is @code{focus-in-hook} and @code{focus-out-hook}.
+
@node Misc Events
@subsection Miscellaneous System Events
--
2.6.1
[-- Attachment #3: Type: text/plain, Size: 67 bytes --]
(I have a copyright assignment on file.)
Thanks,
--
Aaron Ecay
^ permalink raw reply related [flat|nested] 5+ messages in thread
* bug#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual
2015-10-21 18:48 bug#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual Aaron Ecay
@ 2015-10-21 18:57 ` Eli Zaretskii
2016-02-23 5:31 ` Lars Ingebrigtsen
0 siblings, 1 reply; 5+ messages in thread
From: Eli Zaretskii @ 2015-10-21 18:57 UTC (permalink / raw
To: Aaron Ecay; +Cc: 21728
> From: Aaron Ecay <aaronecay@gmail.com>
> Date: Wed, 21 Oct 2015 19:48:06 +0100
>
> The emacs lisp reference doesn’t mention focus-in-hook and its -out-
> variant, except in a list of hooks.
No, they are also mentioned in the node "Input Focus". And the node
"Focus Events", where you suggested the addition, has a
cross-reference to "Input Focus", near its beginning. So perhaps what
we need is a sentence near that cross-reference that somehow mentions
these two hooks, and all the rest is already in place? Would you like
to suggest an alternative patch along these lines?
Thanks.
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual
2015-10-21 18:57 ` Eli Zaretskii
@ 2016-02-23 5:31 ` Lars Ingebrigtsen
2016-02-23 15:59 ` Eli Zaretskii
0 siblings, 1 reply; 5+ messages in thread
From: Lars Ingebrigtsen @ 2016-02-23 5:31 UTC (permalink / raw
To: Eli Zaretskii; +Cc: Aaron Ecay, 21728-done
Eli Zaretskii <eliz@gnu.org> writes:
> No, they are also mentioned in the node "Input Focus". And the node
> "Focus Events", where you suggested the addition, has a
> cross-reference to "Input Focus", near its beginning. So perhaps what
> we need is a sentence near that cross-reference that somehow mentions
> these two hooks, and all the rest is already in place? Would you like
> to suggest an alternative patch along these lines?
Hm... is that really necessary, though? With that xref it seems pretty
clear that the user should go to that node for more info on everything
connected with input focus, I think...
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual
2016-02-23 5:31 ` Lars Ingebrigtsen
@ 2016-02-23 15:59 ` Eli Zaretskii
2016-02-23 17:44 ` Eli Zaretskii
0 siblings, 1 reply; 5+ messages in thread
From: Eli Zaretskii @ 2016-02-23 15:59 UTC (permalink / raw
To: Lars Ingebrigtsen; +Cc: aaronecay, 21728
> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: Aaron Ecay <aaronecay@gmail.com>, 21728-done@debbugs.gnu.org
> Date: Tue, 23 Feb 2016 16:31:47 +1100
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> > No, they are also mentioned in the node "Input Focus". And the node
> > "Focus Events", where you suggested the addition, has a
> > cross-reference to "Input Focus", near its beginning. So perhaps what
> > we need is a sentence near that cross-reference that somehow mentions
> > these two hooks, and all the rest is already in place? Would you like
> > to suggest an alternative patch along these lines?
>
> Hm... is that really necessary, though? With that xref it seems pretty
> clear that the user should go to that node for more info on everything
> connected with input focus, I think...
The xref doesn't mention the hooks. I suggested to add a single
sentence that does, that's all.
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual
2016-02-23 15:59 ` Eli Zaretskii
@ 2016-02-23 17:44 ` Eli Zaretskii
0 siblings, 0 replies; 5+ messages in thread
From: Eli Zaretskii @ 2016-02-23 17:44 UTC (permalink / raw
To: larsi, aaronecay; +Cc: 21728
> Date: Tue, 23 Feb 2016 17:59:21 +0200
> From: Eli Zaretskii <eliz@gnu.org>
> Cc: aaronecay@gmail.com, 21728@debbugs.gnu.org
>
> > From: Lars Ingebrigtsen <larsi@gnus.org>
> > Cc: Aaron Ecay <aaronecay@gmail.com>, 21728-done@debbugs.gnu.org
> > Date: Tue, 23 Feb 2016 16:31:47 +1100
> >
> > Eli Zaretskii <eliz@gnu.org> writes:
> >
> > > No, they are also mentioned in the node "Input Focus". And the node
> > > "Focus Events", where you suggested the addition, has a
> > > cross-reference to "Input Focus", near its beginning. So perhaps what
> > > we need is a sentence near that cross-reference that somehow mentions
> > > these two hooks, and all the rest is already in place? Would you like
> > > to suggest an alternative patch along these lines?
> >
> > Hm... is that really necessary, though? With that xref it seems pretty
> > clear that the user should go to that node for more info on everything
> > connected with input focus, I think...
>
> The xref doesn't mention the hooks. I suggested to add a single
> sentence that does, that's all.
Now done on the emacs-25 branch.
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2016-02-23 17:44 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-10-21 18:48 bug#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual Aaron Ecay
2015-10-21 18:57 ` Eli Zaretskii
2016-02-23 5:31 ` Lars Ingebrigtsen
2016-02-23 15:59 ` Eli Zaretskii
2016-02-23 17:44 ` Eli Zaretskii
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.