[AUCTeX-diffs] GNU AUCTeX branch, master, updated. 29d4cb4e364e214c831d6845ebfc7619bc815227

[Tassilo Horn]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU AUCTeX".

The branch, master has been updated
       via  29d4cb4e364e214c831d6845ebfc7619bc815227 (commit)
      from  ba10cf083753bceb27923b6b80f5d2f7f78cd093 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 29d4cb4e364e214c831d6845ebfc7619bc815227
Author: Tassilo Horn <address@hidden>
Date:   Sat Jun 11 09:33:22 2016 +0200

    Document TeX-raise-frame-function
    
    * doc/auctex.texi (I/O Correlation): Document TeX-raise-frame-function.

diff --git a/doc/auctex.texi b/doc/auctex.texi
index 80014d9..f31d6d1 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -3342,6 +3342,48 @@ from the viewer, typically by a mouse click.  Refer to 
the documentation
 of your viewer to find out how it has to be configured and what you have
 to do exactly.  In xdvi you normally have to use @kbd{C-down-mouse-1}.
 
address@hidden TeX-source-correlate-start-server
+Note that inverse search with the Evince PDF viewer or its MATE fork
+Atril might fail in raising the Emacs frame after updating point in your
+document's buffer.  There is simply no way to raise the Emacs frame
+reliably accross different operating systems and different window
+managers with their different focus stealing policies.  If the Emacs
+frame is not raised after performing an inverse search from Evince or
+Atril, you can customize the following option.
+
address@hidden TeX-raise-frame-function
+A function that will be called after performing an inverse search from
+Evince or Atril in order to raise the current Emacs frame.
+
+If your Emacs frame is already raised in that situation, just leave this
+variable set to @code{nil}.  Otherwise, here are some alternative
+settings that work for some users.
+
address@hidden
+;; Alternative 1: For some users, `x-focus-frame' works.  Note
+;; that this function requires Emacs 24+.
+(setq TeX-raise-frame-function #'x-focus-frame)
+
+;; Alternative 2: Under GNOME 3.20 (and probably others), it
+;; seems some focus stealing prevention policy prohibits that
+;; some window gets the focus immediately after the user has
+;; clicked in some other window.  Here waiting a bit before
+;; issuing the request seems to work.
+(setq TeX-raise-frame-function
+      (lambda ()
+       (run-at-time 0.5 nil #'x-focus-frame)))
+
+;; Alternative 3: Use the external wmctrl tool in order to
+;; force Emacs into the focus.
+(setq TeX-raise-frame-function
+      (lambda ()
+       (call-process
+        "wmctrl" nil nil nil "-i" "-R"
+        (frame-parameter (selected-frame) ’outer-window-id))))
address@hidden lisp
address@hidden defopt
+
+
 @node Debugging
 @section Catching the errors
 @cindex Debugging

-----------------------------------------------------------------------

Summary of changes:
 doc/auctex.texi |   42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)


hooks/post-receive
-- 
GNU AUCTeX