reftex: Displaying and Editing the Index
5.3 Displaying and Editing the Index
====================================
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 ‘?’.
General
.......
‘?’
Display a summary of commands.
‘0-9, -’
Prefix argument.
Moving around
.............
‘! A..Z’
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.
‘n’
Go to next entry.
‘p’
Go to previous entry.
Access to document locations
............................
‘<SPC>’
Show the place in the document where this index entry is defined.
‘<TAB>’
Go to the definition of the current index entry in another window.
‘<RET>’
Go to the definition of the current index entry and hide the
‘*Index*’ buffer window.
‘f’
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
‘reftex-revisit-to-follow’.
Entry editing
.............
‘e’
Edit the current index entry. In the minibuffer, you can edit the
index macro which defines this entry.
‘C-k’
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
macro. With ‘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 part.
‘@’
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’).
Exiting
.......
‘q’
Hide the ‘*Index*’ buffer.
‘k’
Kill the ‘*Index*’ buffer.
‘C-c =’
Switch to the Table of Contents buffer of this document.
Controlling what gets displayed
...............................
‘c’
Toggle the display of short context in the ‘*Index*’ buffer. The
default for this flag can be set with the variable
‘reftex-index-include-context’.
‘}’
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.
Updating the buffer
...................
‘g’
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.
‘r’
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.
‘C-u r’
Reparse the _entire_ LaTeX document and rebuild the ‘*Index*’
buffer.
‘s’
Switch to a different index (for documents with multiple indices).