reftex: Options - Viewing Cross-References
18.7 Viewing Cross-References
=============================
-- User Option: reftex-view-crossref-extra
Macros which can be used for the display of cross references. This
is used when ‘reftex-view-crossref’ is called with point in an
argument of a macro. Note that crossref viewing for citations,
references (both ways) and index entries is hard-coded. This
variable is only to configure additional structures for which
crossreference viewing can be useful. Each entry has the structure
(MACRO-RE SEARCH-RE HIGHLIGHT).
MACRO-RE is matched against the macro. SEARCH-RE is the regexp
used to search for cross references. ‘%s’ in this regexp is
replaced with the macro argument at point. HIGHLIGHT is an integer
indicating which subgroup of the match should be highlighted.
-- User Option: reftex-auto-view-crossref
Non-‘nil’ means, initially turn automatic viewing of crossref info
on. Automatic viewing of crossref info normally uses the echo
area. Whenever point is idle for more than ‘reftex-idle-time’
seconds on the argument of a ‘\ref’ or ‘\cite’ macro, and no other
message is being displayed, the echo area will display information
about that cross reference. You can also set the variable to the
symbol ‘window’. In this case a small temporary window is used for
the display. This feature can be turned on and off from the menu
(Ref->Options).
-- User Option: reftex-idle-time
Time (secs) Emacs has to be idle before automatic crossref display
or toc recentering is done.
-- User Option: reftex-cite-view-format
Citation format used to display citation info in the message area.
See the variable ‘reftex-cite-format’ for possible percent escapes.
-- User Option: reftex-revisit-to-echo
Non-‘nil’ means, automatic citation display will revisit files if
necessary. When ‘nil’, citation display in echo area will only be
active for cached echo strings (see ‘reftex-cache-cite-echo’), or
for BibTeX database files which are already visited by a live
associated buffers.
-- User Option: reftex-cache-cite-echo
Non-‘nil’ means, the information displayed in the echo area for
cite macros (see variable ‘reftex-auto-view-crossref’) is cached
and saved along with the parsing information. The cache survives
document scans. In order to clear it, use ‘M-x reftex-reset-mode’.