In order to compile and display the index, press C-c >. If the document uses multiple indices, RefTeX will ask you to select one. Then, all index entries will be sorted alphabetically and displayed in a special buffer, the *Index* buffer. From that buffer you can check and edit each entry.
The index can be restricted to the current section or the region. Then only entries in that part of the document will go into the compiled index. To restrict to the current section, use a numeric prefix ‘2’, thus press C-u 2 C-c >. To restrict to the current region, make the region active and use a numeric prefix ‘3’ (press C-u 3 C-c >). From within the *Index* buffer the restriction can be moved from one section to the next by pressing the < and > keys.
One caveat: RefTeX finds the definition point of an index entry by searching near the buffer position where it had found to macro during scanning. If you have several identical index entries in the same buffer and significant changes have shifted the entries around, you must rescan the buffer to ensure the correspondence between the *Index* buffer and the definition locations. It is therefore advisable to rescan the document (with r or C-u r) frequently while editing the index from the *Index* buffer.
Here is a list of special commands available in the *Index* buffer. A summary of this information is always available by pressing ?.
Display a summary of commands.
Pressing any capital letter will jump to the corresponding section in the *Index* buffer. The exclamation mark is special and jumps to the first entries alphabetically sorted below ‘A’. These are usually non-alphanumeric characters.
Go to next entry.
Go to previous entry.
Show the place in the document where this index entry is defined.
Go to the definition of the current index entry in another window.
Go to the definition of the current index entry and hide the *Index* buffer window.
Toggle follow mode. When follow mode is active, the other window will
always show the location corresponding to the line in the *Index*
buffer at point. This is similar to pressing SPC after each
cursor motion. The default for this flag can be set with the variable
reftex-index-follow-mode. Note that only context in files
already visited is shown. RefTeX will not visit a file just for
follow mode. See, however, the variable
Edit the current index entry. In the minibuffer, you can edit the index macro which defines this entry.
Kill the index entry. Currently not implemented because I don’t know
how to implement an
undo function for this.
Edit the key part of the entry. This is the initial part of the entry which determines the location of the entry in the index.
Edit the attribute part of the entry. This is the part after the
vertical bar. With
MakeIndex, this part is an encapsulating
xindy, it is called attribute and is a
property of the index entry that can lead to special formatting. When
called with C-u prefix, kill the entire attribute
Edit the visual part of the entry. This is the part after the
‘@’ which is used by
MakeIndex to change the visual
appearance of the entry in the index. When called with C-u
prefix, kill the entire visual part.
Toggle the beginning of page range property ‘|(’ of the entry.
Toggle the end of page range property ‘|)’ of the entry.
Make the current entry a subentry. This command will prompt for the superordinate entry and insert it.
Remove the highest superordinate entry. If the current entry is a subitem (‘aaa!bbb!ccc’), this function moves it up the hierarchy (‘bbb!ccc’).
Hide the *Index* buffer.
Kill the *Index* buffer.
Switch to the Table of Contents buffer of this document.
Toggle the display of short context in the *Index* buffer. The
default for this flag can be set with the variable
Restrict the index to a single document section. The corresponding
section number will be displayed in the
R<> indicator in the
mode line and in the header of the *Index* buffer.
Widen the index to contain all entries of the document.
When the index is currently restricted, move the restriction to the previous section.
When the index is currently restricted, move the restriction to the next section.
Rebuild the *Index* buffer. This does not rescan the document. However, it sorts the entries again, so that edited entries will move to the correct position.
Reparse the LaTeX document and rebuild the *Index* buffer. When
reftex-enable-partial-scans is non-
nil, rescan only the file this
location is defined in, not the entire document.
Reparse the entire LaTeX document and rebuild the *Index* buffer.
Switch to a different index (for documents with multiple indices).