comparison man/reftex.texi @ 36509:45500c80145f

Fix case convention for mouse click.

36508:753bb928f910

@item @key{RET}
Go to the location and hide the @file{*toc*} buffer.  This will restore
the window configuration before @code{reftex-toc} (@kbd{C-c =}) was
called.@refill

@item mouse-2
@vindex reftex-highlight-selection
Clicking with mouse button 2 on a line has the same effect as @key{RET}.
See also variable @code{reftex-highlight-selection}, @ref{Options
(Fontification)}.@refill

@item @key{RET}
Insert a reference to the label at point into the buffer from which the
selection process was started.  When entries have been marked, @key{RET}
references all marked labels.@refill

@item mouse-2
@vindex reftex-highlight-selection
Clicking with mouse button 2 on a label will accept it like @key{RET}
would. See also variable @code{reftex-highlight-selection}, @ref{Options
(Misc)}.@refill

@cindex Cross-references, displaying
@cindex Reference info
@cindex Displaying cross-references
@cindex Viewing cross-references
@kindex C-c &
@kindex S-mouse-2

When point is idle on the argument of a @code{\ref} macro, the echo area
will display some information about the label referenced there.  Note
that the information is only displayed if the echo area is not occupied
by a different message.  

@tablesubheading{Selecting entries and creating the citation}
@item @key{RET}
Insert a citation referencing the article at point into the buffer from
which the selection process was started.@refill

@item mouse-2
@vindex reftex-highlight-selection
Clicking with mouse button 2 on a citation will accept it like @key{RET}
would.  See also variable @code{reftex-highlight-selection}, @ref{Options
(Misc)}.@refill

@cindex Displaying citations
@cindex Citations, displaying
@cindex Citation info
@cindex Viewing citations
@kindex C-c &
@kindex S-mouse-2
@findex reftex-view-crossref
@findex reftex-mouse-view-crossref

When point is idle on the argument of a @code{\cite} macro, the echo area
will display some information about the article cited there.  Note

@node Viewing Cross-References, RefTeXs Menu, Index Support, Top
@chapter Viewing Cross--References
@findex reftex-view-crossref
@findex reftex-mouse-view-crossref
@kindex C-c &
@kindex S-mouse-2

@b{Ref@TeX{}} can display cross--referencing information.  This means,
if two document locations are linked, @b{Ref@TeX{}} can display the
matching location(s) in another window.  The @code{\label} and @code{\ref}
macros are one way of establishing such a link.  Also, a @code{\cite}

database entry.@refill

The feature is invoked by pressing @kbd{C-c &}
(@code{reftex-view-crossref}) while point is on the @var{key} argument
of a macro involved in cross--referencing.  You can also click with
@kbd{S-mouse-2} on the macro argument.  Here is what will happen for
individual classes of macros:@refill

@table @asis

@item @code{\ref}

@kindex C-c =
@kindex C-c (
@kindex C-c )
@kindex C-c [
@kindex C-c &
@kindex S-mouse-2
@kindex C-c /
@kindex C-c \
@kindex C-c |
@kindex C-c <
@kindex C-c >

@kbd{C-c =}      @code{reftex-toc}
@kbd{C-c (}      @code{reftex-label}
@kbd{C-c )}      @code{reftex-reference}
@kbd{C-c [}      @code{reftex-citation}
@kbd{C-c &}      @code{reftex-view-crossref}
@kbd{S-mouse-2}  @code{reftex-mouse-view-crossref}
@kbd{C-c /}      @code{reftex-index-selection-or-word}
@kbd{C-c \}      @code{reftex-index-phrase-selection-or-word}
@kbd{C-c |}      @code{reftex-index-visit-phrases-buffer}
@kbd{C-c <}      @code{reftex-index}
@kbd{C-c >}      @code{reftex-display-index}
@end example

Note that the @kbd{S-mouse-2} binding is only provided if this key is
not already used by some other package.  @b{Ref@TeX{}} will not override an
existing binding to @kbd{S-mouse-2}.@refill

Personally, I also bind some functions in the users @kbd{C-c} map for
easier access.@refill

@c FIXME: Do we need bindings for the Index macros here as well?

@cindex Emacs packages, @code{bib-cite}

Once you have written a document with labels, references and citations,
it can be nice to read it like a hypertext document.  @b{Ref@TeX{}} has
support for that: @code{reftex-view-crossref} (bound to @kbd{C-c
&}), @code{reftex-mouse-view-crossref} (bound to @kbd{S-mouse-2}), and
@code{reftex-search-document}.  A somewhat fancier interface with mouse
highlighting is provided (among other things) by Peter S. Galbraith's
@file{bib-cite.el}.  There is some overlap in the functionalities of
Bib-cite and @b{Ref@TeX{}}.  Bib-cite.el comes bundled with
AUCTeX.@refill

This removes all restrictions during selection.  E.g. you can now
switch buffers at will, use the mouse etc.@refill
@item
New option @code{reftex-highlight-selection}.
@item
@kbd{mouse-2} can be used to select in selection and @file{*toc*}
buffers.@refill
@item
Fixed some problems regarding the interaction with VIPER mode.
@item
Follow-mode is now only used after point motion.

@itemize @bullet
@item
Fixed bug with empty context strings.
@item
@code{reftex-mouse-view-crossref} is now bound by default at
@kbd{S-mouse-2}.@refill
@end itemize

@noindent @b{Version 3.23}
@itemize @bullet
@item

36509:45500c80145f

@item @key{RET}
Go to the location and hide the @file{*toc*} buffer.  This will restore
the window configuration before @code{reftex-toc} (@kbd{C-c =}) was
called.@refill

@item Mouse-2
@vindex reftex-highlight-selection
Clicking with mouse button 2 on a line has the same effect as @key{RET}.
See also variable @code{reftex-highlight-selection}, @ref{Options
(Fontification)}.@refill

@item @key{RET}
Insert a reference to the label at point into the buffer from which the
selection process was started.  When entries have been marked, @key{RET}
references all marked labels.@refill

@item Mouse-2
@vindex reftex-highlight-selection
Clicking with mouse button 2 on a label will accept it like @key{RET}
would. See also variable @code{reftex-highlight-selection}, @ref{Options
(Misc)}.@refill

@cindex Cross-references, displaying
@cindex Reference info
@cindex Displaying cross-references
@cindex Viewing cross-references
@kindex C-c &
@kindex S-Mouse-2

When point is idle on the argument of a @code{\ref} macro, the echo area
will display some information about the label referenced there.  Note
that the information is only displayed if the echo area is not occupied
by a different message.  

@tablesubheading{Selecting entries and creating the citation}
@item @key{RET}
Insert a citation referencing the article at point into the buffer from
which the selection process was started.@refill

@item Mouse-2
@vindex reftex-highlight-selection
Clicking with mouse button 2 on a citation will accept it like @key{RET}
would.  See also variable @code{reftex-highlight-selection}, @ref{Options
(Misc)}.@refill

@cindex Displaying citations
@cindex Citations, displaying
@cindex Citation info
@cindex Viewing citations
@kindex C-c &
@kindex S-Mouse-2
@findex reftex-view-crossref
@findex reftex-mouse-view-crossref

When point is idle on the argument of a @code{\cite} macro, the echo area
will display some information about the article cited there.  Note

@node Viewing Cross-References, RefTeXs Menu, Index Support, Top
@chapter Viewing Cross--References
@findex reftex-view-crossref
@findex reftex-mouse-view-crossref
@kindex C-c &
@kindex S-Mouse-2

@b{Ref@TeX{}} can display cross--referencing information.  This means,
if two document locations are linked, @b{Ref@TeX{}} can display the
matching location(s) in another window.  The @code{\label} and @code{\ref}
macros are one way of establishing such a link.  Also, a @code{\cite}

database entry.@refill

The feature is invoked by pressing @kbd{C-c &}
(@code{reftex-view-crossref}) while point is on the @var{key} argument
of a macro involved in cross--referencing.  You can also click with
@kbd{S-Mouse-2} on the macro argument.  Here is what will happen for
individual classes of macros:@refill

@table @asis

@item @code{\ref}

@kindex C-c =
@kindex C-c (
@kindex C-c )
@kindex C-c [
@kindex C-c &
@kindex S-Mouse-2
@kindex C-c /
@kindex C-c \
@kindex C-c |
@kindex C-c <
@kindex C-c >

@kbd{C-c =}      @code{reftex-toc}
@kbd{C-c (}      @code{reftex-label}
@kbd{C-c )}      @code{reftex-reference}
@kbd{C-c [}      @code{reftex-citation}
@kbd{C-c &}      @code{reftex-view-crossref}
@kbd{S-Mouse-2}  @code{reftex-mouse-view-crossref}
@kbd{C-c /}      @code{reftex-index-selection-or-word}
@kbd{C-c \}      @code{reftex-index-phrase-selection-or-word}
@kbd{C-c |}      @code{reftex-index-visit-phrases-buffer}
@kbd{C-c <}      @code{reftex-index}
@kbd{C-c >}      @code{reftex-display-index}
@end example

Note that the @kbd{S-Mouse-2} binding is only provided if this key is
not already used by some other package.  @b{Ref@TeX{}} will not override an
existing binding to @kbd{S-Mouse-2}.@refill

Personally, I also bind some functions in the users @kbd{C-c} map for
easier access.@refill

@c FIXME: Do we need bindings for the Index macros here as well?

@cindex Emacs packages, @code{bib-cite}

Once you have written a document with labels, references and citations,
it can be nice to read it like a hypertext document.  @b{Ref@TeX{}} has
support for that: @code{reftex-view-crossref} (bound to @kbd{C-c
&}), @code{reftex-mouse-view-crossref} (bound to @kbd{S-Mouse-2}), and
@code{reftex-search-document}.  A somewhat fancier interface with mouse
highlighting is provided (among other things) by Peter S. Galbraith's
@file{bib-cite.el}.  There is some overlap in the functionalities of
Bib-cite and @b{Ref@TeX{}}.  Bib-cite.el comes bundled with
AUCTeX.@refill

This removes all restrictions during selection.  E.g. you can now
switch buffers at will, use the mouse etc.@refill
@item
New option @code{reftex-highlight-selection}.
@item
@kbd{Mouse-2} can be used to select in selection and @file{*toc*}
buffers.@refill
@item
Fixed some problems regarding the interaction with VIPER mode.
@item
Follow-mode is now only used after point motion.

@itemize @bullet
@item
Fixed bug with empty context strings.
@item
@code{reftex-mouse-view-crossref} is now bound by default at
@kbd{S-Mouse-2}.@refill
@end itemize

@noindent @b{Version 3.23}
@itemize @bullet
@item