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.