[elpa] elpa 7f91fb9 06/35: More about TeX-raise-frame-function

[Tassilo Horn]

branch: elpa
commit 7f91fb9f98d6498a43409056752d6db429416c51
Author: Tassilo Horn <address@hidden>
Commit: Tassilo Horn <address@hidden>

    More about TeX-raise-frame-function
    
    * doc/auctex.texi (I/O Correlation): Improve TeX-raise-frame-function
    docs.
    * doc/changes.texi: Mention TeX-raise-frame-function.
    * tex.el (TeX-raise-frame-function): Use raise-frame as default value.
---
 doc/auctex.texi  |    5 +++--
 doc/changes.texi |    5 +++++
 tex.el           |   17 +++++++----------
 3 files changed, 15 insertions(+), 12 deletions(-)

diff --git a/doc/auctex.texi b/doc/auctex.texi
index f31d6d1..0860af5 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -3355,8 +3355,9 @@ Atril, you can customize the following option.
 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
+If your Emacs frame is already raised in that situation, just
+leave this variable set to its default value
address@hidden  Otherwise, here are some alternative
 settings that work for some users.
 
 @lisp
diff --git a/doc/changes.texi b/doc/changes.texi
index d819cc0..ed61b5f 100644
--- a/doc/changes.texi
+++ b/doc/changes.texi
@@ -12,6 +12,11 @@
 
 @itemize @bullet
 @item
address@hidden has a new customize option @code{TeX-raise-frame-function}
+that is currently only used by Evince and Atril inverse search to raise
+the Emacs frame.
+
address@hidden
 @AUCTeX{} now has limited support for the TikZ package.  For the moment,
 this includes some basic support for prompting the user of arguments to
 the @samp{\draw} macro.
diff --git a/tex.el b/tex.el
index 6ba3d60..9424d3f 100644
--- a/tex.el
+++ b/tex.el
@@ -1846,16 +1846,16 @@ file and LINE to (+ LINE offset-of-region).  Else, 
return nil."
            (list (expand-file-name (buffer-file-name TeX-region-orig-buffer))
                  (+ line offset) col)))))))
 
-(defcustom TeX-raise-frame-function nil
+(defcustom TeX-raise-frame-function #'raise-frame
   "A function which will be called to raise the Emacs frame.
 The function is called after `TeX-source-correlate-sync-source'
 has processed an inverse search DBUS request from Evince or
 Atril in order to raise the Emacs frame.
 
-`TeX-source-correlate-sync-source' already calls `raise-frame',
-however, depending on window manager and focus stealing policies,
-it might very well be that Emacs doesn't pop into the foreground.
-So you can do whatever it takes here.
+The default value is `raise-frame', however, depending on window
+manager and focus stealing policies, it might very well be that
+Emacs doesn't pop into the foreground.  So you can do whatever it
+takes here.
 
 For some users, `x-focus-frame' does the trick.  For some
 users (on GNOME 3.20),
@@ -1880,10 +1880,8 @@ emitted from the Evince document viewer.  IGNORED 
absorbs an
 unused id field accompanying the DBUS signal sent by Evince-3.0.0
 or newer.
 
-Note that this function tries to raise the Emacs frame using
-`raise-frame'.  However, that doesn't work reliably across window
-managers/operating systems.  If the Emacs frame isn't raised,
-customize `TeX-raise-frame-function'."
+If the Emacs frame isn't raised, customize
+`TeX-raise-frame-function'."
   ;; FILE may be given as relative path to the TeX-master root document or as
   ;; absolute file:// URL.  In the former case, the tex file has to be already
   ;; opened.
@@ -1918,7 +1916,6 @@ customize `TeX-raise-frame-function'."
                  (> pos (point-max)))
          (widen))
        (goto-char pos))
-      (raise-frame)
       (when TeX-raise-frame-function
        (funcall TeX-raise-frame-function)))))