branch: externals/auctex
commit 463ead7020d2c08ba5d2ec2df64edd37a55a88b5
Author: Ikumi Keita <[email protected]>
Commit: Ikumi Keita <[email protected]>
Document `TeX-view-evince-keep-focus'
* doc/auctex.texi (Starting Viewers):
* doc/changes.texi (News in 11.92):
Document `TeX-view-evince-keep-focus'.
---
doc/auctex.texi | 12 ++++++++++++
doc/changes.texi | 4 ++++
2 files changed, 16 insertions(+)
diff --git a/doc/auctex.texi b/doc/auctex.texi
index c9bc991..7259932 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -3482,6 +3482,18 @@ A built-in viewer spec from
@code{TeX-view-program-list-builtin} can be
overwritten by defining a new viewer spec with the same name.
@end defopt
+After the viewer is called via either the View command or the key stroke
+@kbd{C-c C-v}, the window system focus goes and stays on the viewer. If
+you prefer that the focus is pulled back to Emacs immediately after that
+and you are using evince-compatible viewer, customize the option
+@code{TeX-view-enince-keep-focus}.
+
+@defopt TeX-view-evince-keep-focus
+When this option is non-nil and the viewer is compatible with evince,
+the focus is pulled back to Emacs immediately after the viewer is
+invoked or refreshed from within @AUCTeX{}.
+@end defopt
+
Note that the viewer selection and invocation as described above will
only work if certain default settings in @AUCTeX{} are intact. For one,
the whole viewer selection machinery will only be triggered if there is
diff --git a/doc/changes.texi b/doc/changes.texi
index b43a657..3200c7a 100644
--- a/doc/changes.texi
+++ b/doc/changes.texi
@@ -21,6 +21,10 @@ In fact this variable was introduced long before, but has
not been
documented in info files nor turned into a customize option with
@code{defcustom} until this release.
+@item
+The window system focus is pulled back to Emacs when viewing with
+evince-compatible viewers if a new customize option
+@code{TeX-view-evince-keep-focus} is non-nil.
@end itemize
@heading News in 11.91
