Viewing Cross-References
************************

   RefTeX can display cross-referencing information.  This means, if
two document locations are linked, RefTeX can display the matching
location(s) in another window.  The `\label' and `\ref' macros are one
way of estabishing such a link.  Also, a `\cite' macro is linked to the
corresponding `\bibitem' macro or a BibTeX database entry.

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

`\ref'
     Display the corresponding label definition.  All usual variants(1)
     of the `\ref' macro are active for cross-reference display.  This
     works also for labels defined in an external document when the
     current document refers to them through the `xr' interface (*note
     xr (LaTeX package)::.).

`\label'
     Display a document location which references this label.  Pressing
     `C-c &' several times moves through the entire document and finds
     all locations.  Not only the `\label' macro but also other macros
     with label arguments (as configured with `reftex-label-alist') are
     active for cross-reference display.

`\cite'
     Display the corresponding BibTeX database entry or `\bibitem'.
     All usual variants(2) of the `\cite' macro are active for
     cross-reference display.

`\bibitem'
     Display a document location which cites this article. Pressing
     `C-c &' several times moves through the entire document and finds
     all locations.

BibTeX
     `C-c &' is also active in BibTeX buffers.  All locations in a
     document where the database entry at point is cited will be
     displayed.  On first use, RefTeX will prompt for a buffer which
     belongs to the document you want to search.  Subsequent calls will
     use the same document, unless you break this link with a prefix
     argument to `C-c &'.

`\index'
     Display other locations in the document which are marked by the
     same index entry.  The standard `\index' macro as well as many
     variants(3) will be recognized.

   While the display of cross reference information for citations and
labels is hard-coded within RefTeX, the `\index' stuff is configured in
the variable `reftex-view-crossref-macros'.  You can customize this
variable to add other sets of macros for which the display of
cross-referencing information can be useful.

   ---------- Footnotes ----------

   (1) all macros that either start or end with `ref'

   (2) all macros that either start or end with `cite'

   (3) all macros which contain either `index' or `idx' in their name