reftex: Options - Referencing Labels
18.4 Referencing Labels
=======================
-- User Option: reftex-label-menu-flags
List of flags governing the label menu makeup. The flags are:
TABLE-OF-CONTENTS
Show the labels embedded in a table of context.
SECTION-NUMBERS
Include section numbers (like 4.1.3) in table of contents.
COUNTERS
Show counters. This just numbers the labels in the menu.
NO-CONTEXT
Non-‘nil’ means do _not_ show the short context.
FOLLOW
Follow full context in other window.
SHOW-COMMENTED
Show labels from regions which are commented out.
MATCH-EVERYWHERE
Obsolete flag.
SHOW-FILES
Show begin and end of included files.
Each of these flags can be set to ‘t’ or ‘nil’, or to a string of
type letters indicating the label types for which it should be
true. These strings work like character classes in regular
expressions. Thus, setting one of the flags to ‘"sf"’ makes the
flag true for section and figure labels, ‘nil’ for everything else.
Setting it to ‘"^sf"’ makes it the other way round.
The available label types are: ‘s’ (section), ‘f’ (figure), ‘t’
(table), ‘i’ (item), ‘e’ (equation), ‘n’ (footnote), plus any
definitions in ‘reftex-label-alist’.
Most options can also be switched from the label menu itself, so if
you decide here to not have a table of contents in the label menu,
you can still get one interactively during selection from the label
menu.
-- User Option: reftex-multiref-punctuation
Punctuation strings for multiple references. When marking is used
in the selection buffer to select several references, this variable
associates the 3 marking characters ‘,-+’ with prefix strings to be
inserted into the buffer before the corresponding ‘\ref’ macro.
This is used to string together whole reference sets, like ‘eqs.
1,2,3-5,6 and 7’ in a single call to ‘reftex-reference’.
-- User Option: reftex-ref-style-alist
Alist of reference styles. Each element is a list of the style
name, the name of the LaTeX package associated with the style or
‘t’ for any package, and an alist of macros where the first entry
of each item is the reference macro and the second a key for
selecting the macro when the macro type is being prompted for.
(See also ‘reftex-ref-macro-prompt’.) The keys, represented as
characters, have to be unique.
-- User Option: reftex-ref-style-default-list
List of reference styles to be activated by default. The order is
significant and controls the order in which macros can be cycled in
the buffer for selecting a label. The entries in the list have to
match the respective reference style names used in the variable
‘reftex-ref-style-alist’.
-- User Option: reftex-ref-macro-prompt
Controls if ‘reftex-reference’ prompts for the reference macro.
-- Hook: reftex-format-ref-function
If non-‘nil’, should be a function which produces the string to
insert as a reference. Note that the insertion format can also be
changed with ‘reftex-label-alist’. This hook also is used by the
special commands to insert, e.g., ‘\vref’ and ‘\fref’ references,
so even if you set this, your setting will be ignored by the
special commands. The function will be called with three
arguments, the LABEL, the DEFAULT FORMAT which normally is
‘~\ref{%s}’ and the REFERENCE STYLE. The function should return
the string to insert into the buffer.
-- User Option: reftex-level-indent
Number of spaces to be used for indentation per section level.
-- User Option: reftex-guess-label-type
Non-‘nil’ means, ‘reftex-reference’ will try to guess the label
type. To do that, RefTeX will look at the word before the cursor
and compare it with the magic words given in ‘reftex-label-alist’.
When it finds a match, RefTeX will immediately offer the correct
label menu; otherwise it will prompt you for a label type. If you
set this variable to ‘nil’, RefTeX will always prompt for a label
type.
-- Normal Hook: reftex-display-copied-context-hook
Normal Hook which is run before context is displayed anywhere.
Designed for ‘X-Symbol’, but may have other uses as well.
-- Hook: reftex-pre-refontification-functions
‘X-Symbol’ specific hook. Probably not useful for other purposes.
The functions get two arguments, the buffer from where the command
started and a symbol indicating in what context the hook is called.
-- Normal Hook: reftex-select-label-mode-hook
Normal hook which is run when a selection buffer enters
‘reftex-select-label-mode’.
-- Keymap: reftex-select-label-map
The keymap which is active in the labels selection process (
Referencing Labels).