GNU bug report logs - #21728
25.0.50; [patch] mention focus-{in,out}-hook in manual

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Aaron Ecay <aaronecay <at> gmail.com>
Subject: bug#21728: closed (Re: bug#21728: 25.0.50; [patch] mention
 focus-{in,out}-hook in manual)
Date: Tue, 23 Feb 2016 05:33:02 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 21728 <at> debbugs.gnu.org.

-- 
21728: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=21728
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Aaron Ecay <aaronecay <at> gmail.com>, 21728-done <at> debbugs.gnu.org
Subject: Re: bug#21728: 25.0.50; [patch] mention focus-{in,out}-hook in manual
Date: Tue, 23 Feb 2016 16:31:47 +1100

Eli Zaretskii <eliz <at> 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

[Message part 3 (message/rfc822, inline)]

From: Aaron Ecay <aaronecay <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.0.50; [patch] mention focus-{in,out}-hook in manual
Date: Wed, 21 Oct 2015 19:48:06 +0100

[Message part 4 (text/plain, inline)]

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.

[0001-doc-lispref-commands.texi-Focus-Events-Mention-focus.patch (text/x-diff, inline)]

From f89a1bc9d70170f77c85ca447b8a8c3efa6f1ccd Mon Sep 17 00:00:00 2001
From: Aaron Ecay <aaronecay <at> 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

[Message part 6 (text/plain, inline)]

(I have a copyright assignment on file.)

Thanks,

-- 
Aaron Ecay

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.