Non-nil
means, index entries are parsed as well. Index support
is resource intensive and the internal structure holding the parsed
information can become quite big. Therefore it can be turned off. When
this is nil
and you execute a command which requires index
support, you will be asked for confirmation to turn it on and rescan the
document.
List of special characters in index entries, given as strings. These
correspond to the MakeIndex
keywords
(level encap actual quote escape)
.
List of macros which define index entries. The structure of each entry is
(macro index-tag key prefix exclude repeat)
macro is the macro. Arguments should be denoted by empty braces, as for example in ‘\index[]{*}’. Use square brackets to denote optional arguments. The star marks where the index key is.
index-tag is a short name of the index. ‘idx’ and ‘glo’ are reserved for the default index and the glossary. Other indices can be defined as well. If this is an integer, the Nth argument of the macro holds the index tag.
key is a character which is used to identify the macro for input
with reftex-index
. ‘?i’, ‘?I’, and ‘?g’ are
reserved for default index and glossary.
prefix can be a prefix which is added to the key part of the
index entry. If you have a macro
\newcommand{\molec}[1]{#1\index{Molecules!#1}
, this prefix
should be ‘Molecules!’.
exclude can be a function. If this function exists and returns a
non-nil
value, the index entry at point is ignored. This was
implemented to support the (deprecated) ‘^’ and ‘_’ shortcuts
in the LaTeX2e index
package.
repeat, if non-nil
, means the index macro does not typeset
the entry in the text, so that the text has to be repeated outside the
index macro. Needed for reftex-index-selection-or-word
and for
indexing from the phrase buffer.
The final entry may also be a symbol. It must have an association in
the variable reftex-index-macros-builtin
to specify the main
indexing package you are using. Valid values are currently
default The LaTeX default; unnecessary to specify this one multind The multind.sty package index The index.sty package index-shortcut The index.sty packages with the ^ and _ shortcuts. Should not be used; only for old documents
Note that AUCTeX sets these things internally for RefTeX as well, so with a sufficiently new version of AUCTeX, you should not set the package here.
The default index macro for reftex-index-selection-or-word
.
This is a list with (macro-key default-tag)
.
macro-key is a character identifying an index macro; see
reftex-index-macros
.
default-tag is the tag to be used if the macro requires a
tag argument. When this is nil
and a tag is needed,
RefTeX will ask for it. When this is the empty string and the
TAG argument of the index macro is optional, the TAG argument will be
omitted.
Default index tag. When working with multiple indexes, RefTeX queries for an index tag when creating index entries or displaying a specific index. This variable controls the default offered for these queries. The default can be selected with RET during selection or completion. Valid values of this variable are:
nil Do not provide a default index "tag" The default index tag given as a string, e.g., "idx" last The last used index tag will be offered as default
Format of index entries when copied from inside math mode. When
reftex-index-selection-or-word
is executed inside TeX math mode,
the index key copied from the buffer is processed with this format
string through the format
function. This can be used to add the
math delimiters (e.g., ‘$’) to the string. Requires the
texmathp.el library which is part of AUCTeX.
File extension for the index phrase file. This extension will be added to the base name of the master file.
Regexp matching the ‘and’ operator for index arguments in phrases
file. When several index arguments in a phrase line are separated by
this operator, each part will generate an index macro. So each match of
the search phrase will produce several different index entries.
Make sure this does no match things which are not separators. This
logical ‘and’ has higher priority than the logical ‘or’
specified in reftex-index-phrases-logical-or-regexp
.
Regexp matching the ‘or’ operator for index arguments in phrases
file. When several index arguments in a phrase line are separated by
this operator, the user will be asked to select one of them at each
match of the search phrase. The first index arg will be the default. A
number key 1–9 must be pressed to switch to another. Make
sure this does no match things which are not separators. The logical
‘and’ specified in reftex-index-phrases-logical-or-regexp
has higher priority than this logical ‘or’.
Non-nil
means phrases search will look for whole words, not subwords.
This works by requiring word boundaries at the beginning and end of
the search string. When the search phrase already has a non-word-char
at one of these points, no word boundary is required there.
Non-nil
means, searching for index phrases will ignore
case.
A function which is called at each match during global indexing.
If the function returns nil
, the current match is skipped.
Non-nil
means, skip matches which appear to be indexed already.
When doing global indexing from the phrases buffer, searches for some
phrases may match at places where that phrase was already indexed. In
particular when indexing an already processed document again, this
will even be the norm. When this variable is non-nil
,
RefTeX checks if the match is an index macro argument, or if an
index macro is directly before or after the phrase. If that is the
case, that match will be ignored.
Non-nil
means, when indexing from the phrases buffer, wrap lines.
Inserting indexing commands in a line makes the line longer, often
so long that it does not fit onto the screen. When this variable is
non-nil
, newlines will be added as necessary before and/or after the
indexing command to keep lines short. However, the matched text
phrase and its index command will always end up on a single line.
Non-nil
means when sorting phrase lines, the explicit index entry
is used. Phrase lines in the phrases buffer contain a search phrase, and
sorting is normally based on these. Some phrase lines also have
an explicit index argument specified. When this variable is
non-nil
, the index argument will be used for sorting.
Non-nil
means, empty and comment lines separate phrase buffer
into blocks. Sorting will then preserve blocks, so that lines are
re-arranged only within blocks.
Keymap for the Index Phrases buffer.
Normal hook which is run when a buffer is put into
reftex-index-phrases-mode
.
The letters which denote sections in the index. Usually these are all capital letters. Don’t use any downcase letters. Order is not significant, the index will be sorted by whatever the sort function thinks is correct. In addition to these letters, RefTeX will create a group ‘!’ which contains all entries sorted below the lowest specified letter. In the *Index* buffer, pressing any of these capital letters or ! will jump to that section.
Non-nil
means, display the index definition context in the
*Index* buffer. This flag may also be toggled from the
*Index* buffer with the c key.
Non-nil
means, point in *Index* buffer will cause other
window to follow. The other window will show the corresponding part of
the document. This flag can be toggled from within the *Index*
buffer with the f key.
The keymap which is active in the *Index* buffer (see Index Support).