Documentation for focus-in,out hooks (tiny change)

* doc/lispref/frames.texi (Input Focus):
* doc/lispref/hooks.texi (Standard Hooks):
Mention focus-in-hook, focus-out-hook.

* etc/NEWS: Copyedit.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 5251efec3e4ae531e0185721424024e6765e5150..bd84546551f9d1b11c2e7425dfbfe0162603d80f 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2013-11-23  Brian Jenkins  <brian@brianjenkins.org>  (tiny change)
+
+       * frames.texi (Input Focus):
+       * hooks.texi (Standard Hooks): Mention focus-in-hook, focus-out-hook.
+
 2013-11-23  Glenn Morris  <rgm@gnu.org>
 
        * loading.texi (Library Search):

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 4935534d6eb1e73ee5c77598fe9963e9f47e4aa8..01ced2bf6ab9d6ee23c2d2e9e98dd73ed7b6aa7e 100644 (file)
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -1479,6 +1479,14 @@ The redirection lasts until @code{redirect-frame-focus} is called to
 change it.
 @end defun
 
+@defvar focus-in-hook
+This is a normal hook run when an Emacs frame gains input focus.
+@end defvar
+
+@defvar focus-out-hook
+This is a normal hook run when an Emacs frame loses input focus.
+@end defvar
+
 @defopt focus-follows-mouse
 This option is how you inform Emacs whether the window manager transfers
 focus when the user moves the mouse.  Non-@code{nil} says that it does.

diff --git a/doc/lispref/hooks.texi b/doc/lispref/hooks.texi
index 745393f8166343348ed017199db8100303c108dc..74adda1d4956e13e5d05ce598f5c3c90d388c904 100644 (file)
--- a/doc/lispref/hooks.texi
+++ b/doc/lispref/hooks.texi
@@ -115,6 +115,12 @@ Function to call to ``quit'' the current buffer.
 @vindex delayed-warnings-hook
 The command loop runs this soon after @code{post-command-hook} (q.v.).
 
+@item focus-in-hook
+@vindex focus-in-hook
+@itemx focus-out-hook
+@vindex focus-out-hook
+@xref{Input Focus}.
+
 @item delete-frame-functions
 @xref{Deleting Frames}.
 

diff --git a/etc/NEWS b/etc/NEWS
index 4dc1543d845ce8d46f772203a64f3ae3c0f3e7c8..ffbfc64873c1466212b10488d628dddae81ad961 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -176,6 +176,7 @@ Generic commands are interactive functions whose implementation can be
 selected among several alternatives, as a matter of user preference.
 
 ** New hooks `focus-in-hook', `focus-out-hook'.
+These are normal hooks run when an Emacs frame gains or loses input focus.
 
 ** The blink cursor stops blinking after 10 blinks (default) on X and NS.
 You can change the default by customizing the variable blink-cursor-blinks.