[elpa] externals/auctex 9284ac6 22/71: Explain how to do forward search by mouse

[Tassilo Horn]

branch: externals/auctex
commit 9284ac63a7635e2f0d965eb519f20f6e3b6dfaab
Author: Ikumi Keita <ikumi@ikumi.que.jp>
Commit: Ikumi Keita <ikumi@ikumi.que.jp>

    Explain how to do forward search by mouse
    
    * doc/auctex.texi (I/O Correlation): Add a sample usage of
    `TeX-source-correlate-map' and `TeX-view-mouse'.
---
 doc/auctex.texi | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/auctex.texi b/doc/auctex.texi
index 3a9ae01..ab9997f 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -3637,6 +3637,21 @@ bring it to front and display the output page 
corresponding to the
 position of point in the source file.  @AUCTeX{} will automatically pass
 the necessary command line options to the viewer for this to happen.
 
+@vindex TeX-source-correlate-map
+@findex TeX-view-mouse
+You can also make special mouse event do forward search at the clicked
+position.  Use @code{TeX-source-correlate-map}@footnote{The keymap name is
+@code{TeX-source-correlate-map}, not @code{TeX-source-correlate-mode-map}.
+Actually, this keymap isn't implemented as minor mode map of
+@code{TeX-source-correlate-mode}, in order that its bindings don't affect
+buffers outside of @AUCTeX{}.} and @code{TeX-view-mouse} like this:
+@lisp
+(eval-after-load "tex"
+  '(define-key TeX-source-correlate-map [C-down-mouse-1] #'TeX-view-mouse))
+@end lisp
+This example binds @kbd{C-down-mouse-1}, which usually opens a concise
+menu to select buffer, to the command to do forward search.
+
 @vindex TeX-source-correlate-start-server
 Upon opening the viewer you will be asked if you want to start a server
 process (Gnuserv or Emacs server) which is necessary for inverse search.