branch: elpa
commit 7f91fb9f98d6498a43409056752d6db429416c51
Author: Tassilo Horn <t...@gnu.org>
Commit: Tassilo Horn <t...@gnu.org>
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
+@code{raise-frame}. 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
+@AUCTeX{} 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.
+
+@item
@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)))))
